Sway (Wayland compositor)

Sway (Wayland compositor)
Name	Sway
Operating system	Linux
Platform	Wayland
Genre	Tiling window manager
License	MIT License

Sway (Wayland compositor) is a tiling Wayland compositor and drop-in replacement for the i3 X11 window manager, designed to provide a compatible experience on Wayland-based systems. It aims to reproduce the behavior and configuration of i3 while integrating with modern Linux graphics stacks such as Mesa, Wayland compositors, and libinput. The project is developed by an open-source community and distributed under the MIT License.

Overview

Sway implements a tiling paradigm similar to i3 and targets users of Linux distributions including Debian, Ubuntu, Fedora, Arch Linux, and Gentoo. It operates on Wayland and uses libraries such as wlroots to interface with drivers provided by Mesa and Linux kernel subsystems like Direct Rendering Manager. The compositor emphasizes keyboard-driven workflows familiar to users of i3 and integrates with utilities like PulseAudio, PipeWire, and systemd user sessions.

Features

Sway provides features expected by power users of i3 and makers of tiling environments such as Xmonad, Awesome, and bspwm. It supports tiling, stacking, and tabbed layouts alongside floating windows and scratchpad functionality used in i3. Sway offers multi-monitor support through Kernel Mode Setting, per-output configuration comparable to Xrandr workflows, and input handling via libinput. For graphics and rendering, Sway leverages wlroots and interacts with Mesa drivers and NVIDIA proprietary or Nouveau drivers where applicable. The compositor supports input method frameworks such as IBus and Fcitx and multimedia integration with MPV and Firefox on Wayland. Configuration features mirror i3 syntax and include workspaces, keybindings, command mode, and IPC interfaces that integrate with tools like jq and swaymsg.

Architecture

Sway is built on the wlroots modular compositor library and implemented in C, benefiting from the MIT License permissive model and contributions from projects within the Free and open-source software ecosystem. Its architecture separates responsibilities among the compositor core, backends for DRM and Xwayland, input handling via libinput, and protocol handling for Wayland extensions. Sway can run X11 applications through Xwayland compatibility and communicates with session managers such as systemd and desktop-related services like D-Bus. The project also integrates with font and icon resources from Fontconfig and Freetype, and supports application theming tools used by GTK and Qt toolkits.

Configuration and Usage

Sway uses a plain-text configuration format largely compatible with i3's config file, allowing users accustomed to i3 to migrate with minimal changes. Configuration includes bindings for XDG paths, workspace naming conventions inspired by Unix utilities, and runtime control via the swaymsg IPC or i3-msg-like interfaces. Common workflows integrate terminal emulators such as Alacritty, Xterm, and Kitty, and compositing behaviors used by Waybar, Mako, and dmenu. Display configuration often references output names given by kernel DRM devices, while input options tune libinput behaviors for keyboards and pointing devices from manufacturers like Logitech and Wacom.

Development and Community

Sway is developed by contributors who collaborate through platforms including GitHub, mailing lists, and chat services used by many open-source projects. The project draws contributors from communities around i3, wlroots, and related Linux desktop initiatives. Development follows common open-source practices with issue trackers, pull requests, and continuous integration used by projects such as Wayland compositors and Mesa. Documentation and extensions are produced by community members and integrated with distribution packaging in Debian, Arch Linux, and Fedora repositories, while third-party tooling and scripts appear in user projects hosted on platforms like GitLab and GitHub.

Reception and Adoption

Sway has been adopted by users and distributions emphasizing Wayland-native stacks and minimalistic, keyboard-driven environments, drawing comparisons to i3, Xmonad, and Awesome in reviews and community discussions. Coverage in blogs, forums, and technical articles often contrasts Sway's Wayland architecture against X11-based alternatives such as i3 and compositors like Weston and GNOME Shell. Organizations and projects experimenting with Wayland, including desktops built on GNOME and KDE Plasma, have cited the ecosystem improvements around compositors, toolkits, and protocols that benefit software like Sway. Overall, Sway is recognized for enabling a familiar tiling workflow on modern Wayland platforms and for encouraging developments in wlroots and the broader Linux graphics stack.

Category:Wayland compositors Category:Free software programmed in C