This wiki was updated to MediaWiki 1.37. If you notice any issues, please report them to admin[at]


Jump to: navigation, search
  • Sway Tree.png Sway
  • Tiling Wayland compositor
  • Developer:
    Drew DeVault (SirCmpwn)
  • License:
    MIT License

Sway is a tiling Wayland compositor and a drop-in replacement for the i3 window manager for X11.

  • Tiling Wayland compositor
  • Drop-in replacement for the i3 window manager for X11
  • It works with your existing i3 configuration and supports most of i3's features, plus a few extras
  • and more...

Development project at OBS


There is pattern that installs Sway and needed dependencies:

sudo zypper in patterns-sway-sway

If you need only Sway:

sudo zypper in sway

By default sway package comes with default upstream branding, there is also openSUSE branding for it. Sway is the dependency for openSUSE branding, so it could be installed all together by executing:

sudo zypper in sway-branding-openSUSE

Install from the browser:

Tumbleweed Leap 15.2
patterns-sway-sway.ymp unsupported
sway.ymp sway.ymp
sway-branding-openSUSE.ymp unsupported


Sway wiki describes configuration in details.

To start from community defaults (if there is a need to change defaults):

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

If config already exists copy it to the ~/.config/sway/. Good practice is to use dotfiles, more details could be found here: Manage your dotfiles with Git.

Now it could be used it by running:


Some info how to use it with login manager is bellow and in Sway wiki.

Login managers

Login managers might work but they aren't officially supported PR#3634.

Sway package installs /usr/share/wayland-sessions/sway.desktop and if installed login manager supports Wayland sessions, it should be possible to login into Sway.

Login managers that support Wayland sessions:

  • GDM
  • SDDM currently could run only under X11, but supports Wayland sessions. Support to add Wayland natively is tracked in PR #440.
  • LightDM has Wayland support as well.
  • greetd has wlgreet greeter for Wayland.

Application launcher

To launch application $menu variable could be set in Sway config file to run a launcher that would provide menu to the user and launch the application. For example in ~/.config/sway/config setup wofi as a launcher set $menu wofi.

Install needed application first, please refer to the instructions bellow.


zypper in dmenu

Edit sway config file, for example vi ~/.config/sway/config:

# Your preferred application launcher
# Note: pass the final command to swaymsg so that the resulting window can be opened
# on the original workspace that the command was run on.
set $menu dmenu_path | dmenu -nb '#173f4f' -sb '#35b9ab' -nf '#73ba25' -sf '#173f4f' -fn 'Source Sans Pro-14' | xargs swaymsg exec --


zypper in fzf alacritty

Edit sway config file, for example vi ~/.config/sway/config:

set $menu alacritty --class 'launcher' --command bash -c 'compgen -c | sort -u | fzf --no-info --color="bg:#173f4f,fg:#35b9ab,bg+:#68cbc0,fg+:#516f7b,pointer:#173f4f,hl+:#173f4f,hl:#73ba25" | xargs -r swaymsg -t command exec'
for_window [app_id="^launcher$"] floating enable, border none, resize set width 400 px height 100 px, move position center


zypper in wofi

If wofi package is not available in Factory or your repos, try to find right one in development project: X11:Wayland wofi

Edit sway config file, for example vi ~/.config/sway/config:

set $menu wofi

More info about configuration and style could be found here:


The following issues have solutions.

Problem 1

Explain solutions or give SDB article links.

Known issues

The following issues don't have solutions yet.

Problem 1

Describe the issue and give Bugzilla ticket URL if possible.

External links