sway − -SirCmpwn's Wayland window manager
- -sway -[options] [command]
- -−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.
- -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 may run -sway from an ongoing x11 session to run it within x. -Otherwise, you can run sway on a tty and it will use your -outputs directly.
- -Important -note for nvidia users: The proprietary nvidia driver -does not have support for Wayland as of -2015−08−17. Use nouveau.
- -If sway is -currently running, you may run sway [command] to send -command to the running instance of sway. The same -commands you would use in the config file are valid here -(see sway(5)). For compatability reasons, you may -also issue commands with sway−msg(1) or -i3−msg(1) (or even with i3(1), -probably).
- -If -−c is not specified, sway will look in several -locations for your config file. The default one is provided -at /etc/sway/config. The suggested location for your config -file is ~/.config/sway/config. ~/.sway/config will also -work, and the rest of the usual XDG config locations are -supported. If no sway config is found, sway will attempt to -load an i3 config from all the config locations i3 supports. -If still nothing is found, you will receive an error.
- -For information -on the config file format, see sway(5).
- -Maintained by -Drew DeVault <sir@cmpwn.com>, who is assisted by other -open source contributors. For more information about sway -development, see https://github.com/SirCmpwn/sway.
- -sway(5)
-sway − -configuration file and commands
- -A sway -configuration file is a list of sway commands that are -exected by sway on startup. These commands usually consist -of setting your preferences and setting key bindings. An -example config is likely present in /etc/sway/config for you -to check out.
- -All of these -commands may be issued at runtime through -sway−msg(1).
- -bindsym -<key combo> <command>
- -Binds key combo to -execute command when pressed. You may use XKB key -names here (xev(1) is a good tool for discovering -them). An example bindsym command would be bindsym -Mod1+Shift+f exec firefox, which would execute Firefox -if the alt, shift, and F keys are pressed together. Any -valid sway command is eligible to be bound to a key -combo.
- -exec -<shell command>
- -Executes shell command -with sh.
- - -exec_always -<shell command>
- -Like exec, but the shell -command will be executed again after reload or -restart is executed.
- - -exit
- -Exit sway and end your Wayland -session.
- - -floating -toggle
- -Toggles the -"floating" status of the focused view.
- - -floating_modifier -<modifier>
- -When the modifier key is -held down, you may use left click to drag floating windows, -and right click to resize them. Unlike i3, this modifier may -also be used to resize and move windows that are tiled.
- -focus -<direction>
- -Direction may be one of -up, down, left, right, or -parent. The directional focus commands will move the -focus in that direction. The parent focus command will -change the focus to the parent of the currently focused -container, which is useful, for example, to open a sibling -of the parent container, or to move the entire container -around.
- -focus -mode_toggle
- -Toggles focus between floating -view and tiled view.
- - -focus_follows_mouse -<yes|no>
- -If set to yes, the -currently focused view will change as you move your mouse -around the screen to the view that ends up underneath your -mouse.
- - -fullscreen
- -Toggles fullscreen status for -the focused view.
- -gaps -<amount>
- -Adds amount pixels -between each view, and around each output.
- -gaps -<inner|outer> <amount>
- -Adds amount pixels as an -inner or outer gap, where the former affects -spacing between views and the latter affects the space -around each output.
- - -kill
- -Closes the currently focused -view.
- -layout -<mode>
- -Sets the layout mode of the -focused container. mode can be one of splith, -splitv, or toggle split.
- -move -<left|right|up|down>
- -Moves the focused container -left, right, up, or down.
- -output -<name> <resolution|res WIDTHxHEIGHT> -<position|pos X,Y>
- -Configures the specified -output. It will use the given resolution and be arranged at -the given position in the layout tree. You may omit either -of these parameters if you only want to set one of them.
- - -reload
- -Reloads the sway config file -without restarting sway.
- -resize -<shrink|grow> <width|height> <amount>
- -Resizes the currently focused -container or view by amount. amount can be -specified as "n px" or "n ppt" or -"n px or n ppt".
- -set -<name> <value>
- -Creates a substitution for -value that can be used with $name in other -commands.
- -split -<vertical|v|horizontal|h>
- -Splits the current container, -vertically or horiziontally.
- - -splith
- -Equivalent to split -horizontal.
- - -splitv
- -Equivalent to split -vertical.
- - -workspace -<name>
- -Switches to the specified -workspace.
- - -workspace -<prev_on_output|next_on_output>
- -Switches to the next workspace -on the current output.
- - -workspace -<name> output <output>
- -Specifies that the workspace -named name should appear on the specified -output.
-