From Gentoo Wiki
Jump to: navigation, search
This article is a stub. You can help by expanding it.

Sway (contracted from SirCmpwn's Wayland compositor) is an open-source Wayland compositor that is designed to be compatible with the i3 window manager.


USE flags

USE flags for dev-libs/sway i3-compatible Wayland window manager

gdk-pixbuf Enable additional image format support via the x11-libs/gdk-pixbuf library. local
swaybar Build 'swaybar': sway's status bar component. local
swaybg Build 'swaybg': allows to set a desktop background image. local
swaygrab Build 'swaygrab': allows taking screenshots or screencasts. local
swaylock Build 'swaylock': sway's screen locker. local
swaymsg Build 'swaymsg': tool for communicating with a running sway instance. local
tray Enable support for StatusNotifierItem tray specification. local
wallpapers Install sway's default wallpaper image. local
zsh-completion Enable zsh completion support global


Install dev-libs/sway with:

root #emerge --ask dev-libs/sway


To view all available configuration options:

user $man 5 sway


Each user running sway can edit the default configuration file in order to run a customized sway session. Gentoo stores this file at its default /etc/sway/config location:

user $mkdir -p ~/.config/sway/
user $cp /etc/sway/config ~/.config/sway/


To adjust sway's rendering for HiDPI displays (4K and above), the name of the display to be adjusted must be obtained. After a sway session is running, issue the following:

user $swaymsg -t get_outputs
The swaymsg USE flag must be enabled for the swaymsg command to be available on the system.

The output statement in the sway configuration file will accept a scale parameter to adjust the scaling of the high resolution display.

See also