|/
|\ISS               Tidbits  Posts  Answers  Install  Wiki  Contact  Donate  GitHub


sway                                                               version 1.6.1
________________________________________________________________________________

Sway is a tiling window manager and Wayland compositor, inspired by i3, and
written in C. Sway is designed as a drop-in replacement for i3 using the more
modern Wayland display server protocol and wlroots compositor library. Sway
works with existing i3 configuration files and supports most of i3's features
while providing several new features of its own. [0]

Upstream: https://swaywm.org/


[000] Index
________________________________________________________________________________

* Installation ........................................................... [001]
* Setup .................................................................. [002]
  * Add User To Input Video And TTY Groups ............................... [003]
  * Setup Seat Management ................................................ [004]
  * Set XDG_RUNTIME_DIR .................................................. [005]
* Usage .................................................................. [006]
* Troubleshooting ........................................................ [007]
* History ................................................................ [008]
* References ............................................................. [009]


[001] Installation
________________________________________________________________________________

There are three flavors of Sway in the repositories.

1. 'sway': Sway as upstream intended. Comes with all the bells and whistles
   and requires use of the seatd daemon.

2. 'sway-no-seat': Sway without the seatd daemon requirement. Instead, the
   libseat library embeds the daemon.

3. 'sway-tiny': All changes from 'sway-no-seat' plus no dependency on pcre,
   json-c, pango and cairo.

+------------------------------------------------------------------------------+
|                                                                              |
|  $ kiss b [sway|sway-no-seat|sway-tiny]                                      |
|                                                                              |
+------------------------------------------------------------------------------+

If the system has no fonts, installation of a font is also required.

+------------------------------------------------------------------------------+
|                                                                              |
|  $ kiss b ttf-croscore                                                       |
|                                                                              |
+------------------------------------------------------------------------------+


[002] Setup
________________________________________________________________________________


--[003] Add User To Input Video And TTY Groups ---------------------------------

  +----------------------------------------------------------------------------+
  |                                                                            |
  |  $ addgroup USER input                                                     |
  |  $ addgroup USER video                                                     |
  |  $ addgroup USER tty                                                       |
  |                                                                            |
  +----------------------------------------------------------------------------+


--[004] Setup Seat Management --------------------------------------------------

  If using the 'sway package, the seatd daemon must be setup. Refer to the
  documentation found here @/libseat

  If using the 'sway-no-seat' or 'sway-tiny' packages, there is no seatd daemon
  requirement. Instead you must be the first to call DRMSetMaster. [1]


--[005] Set XDG_RUNTIME_DIR ----------------------------------------------------

  This environment variable must be set to a directory that is writable by your
  user. This can be anywhere in theory though /run/user/$(id -u) is recommended.


[006] Usage
________________________________________________________________________________

No documentation is currently provided with the package, refer to online
documentation for the time being.


[007] Troubleshooting
________________________________________________________________________________

If you are using the 'sway-tiny' package and encounter any issues, send bug
reports to $/kisslinux/repo rather than upstream.


[008] History
________________________________________________________________________________

2021-07-18 efbe6b89 sway: potential fix for media keys
2021-07-15 4f967a25 sway: update for new env
2021-07-15 7e0b76af sway: use VERSION
2021-07-13 b072beae sway: Add missing mesa dependency
2021-07-12 28846304 sway: keep manual pages. See #273
2021-07-10 721c26f3 sway: fix trailing whitespace
2021-07-09 55b63237 sway: make default background color modifiable at compile-time
2021-07-09 d59b529e sway: remove libevdev dependency
2021-07-08 79586007 sway: add note to post-install
2021-07-08 2679e218 sway: fix depends
2021-07-08 1f942f7c sway: fix depends
2021-07-08 afff9c0e sway: update post-install
2021-07-08 afed184e sway: fix depends
2021-07-08 fc9dad39 sway: 1.6.1


[009] References
________________________________________________________________________________

[0] https://en.wikipedia.org/wiki/Sway_(window_manager)
[1] $/torvalds/linux/commit/45bc3d26c95a8fc63a7d8668ca9e57ef0883351c


________________________________________________________________________________

Dylan Araps (C) 2019-2021

The registered trademark Linux(R) is used pursuant to a sublicense from the
Linux Foundation, the exclusive licensee of Linus Torvalds, owner of the mark
on a world­wide basis.