table of contents
- bookworm 1.7-6
- testing 1.9-2
- unstable 1.9-2
- experimental 1.10~rc2-1
sway(1) | General Commands Manual | sway(1) |
NAME¶
sway - An i3-compatible Wayland compositor
SYNOPSIS¶
sway [options...] [command]
OPTIONS¶
-h, --help
-c, --config <config>
-C, --validate
-d, --debug
-v, --version
-V, --verbose
--get-socketpath
DESCRIPTION¶
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 exactly like i3 rather than switch to something else.
You can run sway directly from a tty, or via a Wayland-compatible login manager.
CONFIGURATION¶
sway searches for a config file in the following locations, in this order:
If unset, $XDG_CONFIG_HOME defaults to ~/.config.
An error is raised when no config file is found. The recommended default configuration is usually installed to /etc/sway/config; you are encouraged to copy this to ~/.config/sway/config and edit it from there.
For information on the config file format, see sway(5).
IPC COMMANDS¶
Though swaymsg(1) is generally preferred, you may run sway command to send command to the running instance of sway. You can also issue commands with i3-msg(1) or even with i3(1).
ENVIRONMENT¶
The following environment variables have an effect on sway:
SWAYSOCK
XKB_DEFAULT_RULES, XKB_DEFAULT_MODEL, XKB_DEFAULT_LAYOUT, XKB_DEFAULT_VARIANT, XKB_DEFAULT_OPTIONS
The following environment variables are set by sway:
DISPLAY
I3SOCK
SWAYSOCK
WAYLAND_DISPLAY
XCURSOR_SIZE
XCURSOR_THEME
AUTHORS¶
Maintained by Simon Ser <contact@emersion.fr>, who is assisted by other open source contributors. For more information about sway development, see <https://github.com/swaywm/sway>.
SEE ALSO¶
sway(5) swaymsg(1) sway-input(5) sway-output(5) sway-bar(5) sway-ipc(7)
2022-07-25 |