sway - Man Page

An i3-compatible Wayland compositor

Synopsis

sway [options...] [command]

Options

-h,  --help

Show help message and quit.

-c,  --config <config>

Specifies a config file.

-C,  --validate

Check the validity of the config file, then exit.

-d,  --debug

Enables full logging, including debug information.

-v,  --version

Show the version number and quit.

-V,  --verbose

Enables more verbose logging.

--get-socketpath

Gets the IPC socket path and prints it, then exits.

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:

  1. ~/.sway/config
  2. $XDG_CONFIG_HOME/sway/config (suggested location)
  3. ~/.i3/config
  4. $XDG_CONFIG_HOME/i3/config
  5. /etc/sway/config
  6. /etc/i3/config

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

Specifies the path to the sway IPC socket.

XKB_DEFAULT_RULES,  XKB_DEFAULT_MODEL,  XKB_DEFAULT_LAYOUT,  XKB_DEFAULT_VARIANT,  XKB_DEFAULT_OPTIONS

Configures the xkb keyboard settings. See xkeyboard-config(7). The preferred way to configure the keyboard is via the configuration file, see sway-input(5).

The following environment variables are set by sway:

DISPLAY

If compiled with Xwayland support and Xwayland is not disabled by the config, this will be set to the name of the X display used for Xwayland.

I3SOCK

For compatibility with i3, specifies the path to the sway IPC socket.

SWAYSOCK

Specifies the path to the sway IPC socket.

WAYLAND_DISPLAY

Specifies the name of the Wayland display that sway is running on.

XCURSOR_SIZE

Specifies the configured cursor size.

XCURSOR_THEME

Specifies the configured cursor 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)

Referenced By

gtkgreet(1), kanshi(5), sway(5), sway-ipc(7).

2024-02-24