sway - SirCmpwn's Wayland window manager
Show help message and quit.
Specifies a config file.
Check the validity of the config file, then
Enables full logging, including debug
Show the version number and quit.
Enables more verbose logging.
Gets the IPC socket path and prints it, then
sway was created to fill the need of an i3-like window manager for Wayland. The
upstream i3 developers have no intention of porting i3 to Wayland, and
projects proposed by others ended up as vaporware. Many thanks to the i3 folks
for providing such a great piece of software, so good that your users would
rather write an entirely new window manager from scratch that behaved
like i3 rather than switch to something else.
Launch sway directly from a tty or via your favorite Wayland-compatible login
If sway is currently running, you may run sway [command]
to the running instance of sway. The same commands you would
use in the config file are valid here (see sway(5)
). For compatibility
reasons, you may also issue commands with swaymsg(1)
(or even with i3(1)
The path to a config file can be given via the -c
parameter, else sway
searches for it in the following locations: - ~/.sway/config -
$XDG_CONFIG_HOME/sway/config (suggested location) - ~/.i3/config -
$XDG_CONFIG_HOME/i3/config (XDG_HOME ) - /etc/sway/config - /etc/i3/config
In /etc/sway/config the standard config file is installed. An error is raised
when no config file is found.
To write your own configuration, it’s suggested that you copy the default
config file to the location of your choosing and start there.
For information on the config file format, see sway(5)
The following environment variables have an effect on sway:
Specifies the name of the cursor theme to
Specifies the size of the cursor to use.
Specifies the path to the sway IPC
Specifies the device to use in DRM mode.
Set 1 to force EGL clients to use shared
Number of fake outputs to use when running in
Set to 0 to disable Xwayland support.
Set to 1 to force libinput (even in X11
Configures the keyboard repeat delay.
Configures the keyboard repeat rate.
Configures the xkb keyboard settings. See
Maintained by Drew DeVault <email@example.com>, who is assisted by other open
source contributors. For more information about sway development, see
sway(5) swaymsg(1) swaygrab(1) sway-input(5)