sway(1) - f29

1SWAY(1)                                                                SWAY(1)
2
3
4

NAME

6       sway - SirCmpwn's Wayland window manager
7

SYNOPSIS

9       sway [options] [command]
10

OPTIONS

12       -h, --help
13           Show help message and quit.
14
15       -c, --config <config>
16           Specifies a config file.
17
18       -C, --validate
19           Check the validity of the config file, then exit.
20
21       -d, --debug
22           Enables full logging, including debug information.
23
24       -v, --version
25           Show the version number and quit.
26
27       -V, --verbose
28           Enables more verbose logging.
29
30       --get-socketpath
31           Gets the IPC socket path and prints it, then exits.
32

DESCRIPTION

34       sway was created to fill the need of an i3-like window manager for
35       Wayland. The upstream i3 developers have no intention of porting i3 to
36       Wayland, and projects proposed by others ended up as vaporware. Many
37       thanks to the i3 folks for providing such a great piece of software, so
38       good that your users would rather write an entirely new window manager
39       from scratch that behaved exactly like i3 rather than switch to
40       something else.
41
42       Launch sway directly from a tty or via your favorite Wayland-compatible
43       login manager.
44

COMMANDS

46       If sway is currently running, you may run sway [command] to send
47       command to the running instance of sway. The same commands you would
48       use in the config file are valid here (see sway(5)). For compatibility
49       reasons, you may also issue commands with swaymsg(1) or i3-msg(1) (or
50       even with i3(1), probably).
51

CONFIGURATION

53       The path to a config file can be given via the -c parameter, else sway
54       searches for it in the following locations: - ~/.sway/config -
55       $XDG_CONFIG_HOME/sway/config (suggested location) - ~/.i3/config -
56       $XDG_CONFIG_HOME/i3/config (XDG_HOME ) - /etc/sway/config -
57       /etc/i3/config
58
59       In /etc/sway/config the standard config file is installed. An error is
60       raised when no config file is found.
61
62       To write your own configuration, it’s suggested that you copy the
63       default config file to the location of your choosing and start there.
64
65       For information on the config file format, see sway(5).
66

ENVIRONMENT

68       The following environment variables have an effect on sway:
69
70       SWAY_CURSOR_THEME
71           Specifies the name of the cursor theme to use.
72
73       SWAY_CURSOR_SIZE
74           Specifies the size of the cursor to use.
75
76       SWAYSOCK
77           Specifies the path to the sway IPC socket.
78
79       WLC_DRM_DEVICE
80           Specifies the device to use in DRM mode.
81
82       WLC_SHM
83           Set 1 to force EGL clients to use shared memory.
84
85       WLC_OUTPUTS
86           Number of fake outputs to use when running in X11 mode.
87
88       WLC_XWAYLAND
89           Set to 0 to disable Xwayland support.
90
91       WLC_LIBINPUT
92           Set to 1 to force libinput (even in X11 mode).
93
94       WLC_REPEAT_DELAY
95           Configures the keyboard repeat delay.
96
97       WLC_REPEAT_RATE
98           Configures the keyboard repeat rate.
99
100       XKB_DEFAULT_RULES, XKB_DEFAULT_MODEL, XKB_DEFAULT_LAYOUT,
101       XKB_DEFAULT_VARIANT, XKB_DEFAULT_OPTIONS
102           Configures the xkb keyboard settings. See xkeyboard-config(7).
103

AUTHORS

105       Maintained by Drew DeVault <sir@cmpwn.com>, who is assisted by other
106       open source contributors. For more information about sway development,
107       see https://github.com/swaywm/sway.
108