mirror of
https://github.com/NickHu/sway
synced 2024-12-28 22:23:30 +01:00
130 lines
3.6 KiB
Text
130 lines
3.6 KiB
Text
/////
|
|
vim:set ts=4 sw=4 tw=82 noet:
|
|
/////
|
|
:quotes.~:
|
|
|
|
sway (1)
|
|
========
|
|
|
|
Name
|
|
----
|
|
sway - SirCmpwn's Wayland window manager
|
|
|
|
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 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 2016-06-10. Use nouveau.
|
|
|
|
Commands
|
|
--------
|
|
|
|
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 compatibility reasons, you may also issue
|
|
commands with **swaymsg**(1) or **i3-msg**(1) (or even with **i3**(1), probably).
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
If _-c_ is not specified, sway will look in several locations for your config
|
|
file. 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. Sway looks for a config file in
|
|
a fallback directory as a last resort, which is /etc/sway/ by default. A standard
|
|
configuration file is installed at this location. If still nothing is found,
|
|
you will receive an error.
|
|
|
|
To write your own config, 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).
|
|
|
|
Environment
|
|
-----------
|
|
|
|
The following environment variables have an effect on sway:
|
|
|
|
*SWAY_CURSOR_THEME*::
|
|
Specifies the name of the cursor theme to use.
|
|
|
|
*SWAY_CURSOR_SIZE*::
|
|
Specifies the size of the cursor to use.
|
|
|
|
*SWAYSOCK*::
|
|
Specifies the path to the sway IPC socket.
|
|
|
|
*WLC_DRM_DEVICE*::
|
|
Specifies the device to use in DRM mode.
|
|
|
|
*WLC_SHM*::
|
|
Set 1 to force EGL clients to use shared memory.
|
|
|
|
*WLC_OUTPUTS*::
|
|
Number of fake outputs to use when running in X11 mode.
|
|
|
|
*WLC_XWAYLAND*::
|
|
Set to 0 to disable Xwayland support.
|
|
|
|
*WLC_LIBINPUT*::
|
|
Set to 1 to force libinput (even in X11 mode).
|
|
|
|
*WLC_REPEAT_DELAY*::
|
|
Configures the keyboard repeat delay.
|
|
|
|
*WLC_REPEAT_RATE*::
|
|
Configures the keyboard repeat rate.
|
|
|
|
*XKB_DEFAULT_RULES*, *XKB_DEFAULT_MODEL*, *XKB_DEFAULT_LAYOUT*, *XKB_DEFAULT_VARIANT*, *XKB_DEFAULT_OPTIONS*::
|
|
Configures the xkb keyboard settings. See xkeyboard-config(7).
|
|
|
|
Authors
|
|
-------
|
|
|
|
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>.
|
|
|
|
See Also
|
|
--------
|
|
|
|
**sway**(5) **swaymsg**(1) **swaygrab**(1) **sway-input**(5) **sway-bar**(5)
|