i3-compatible Wayland compositor
C SuperCollider Meson C++
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
assets Recompressed PNG files Jan 6, 2017
client Set pool_buffers busy when handing them out Jun 17, 2018
common Use list_find in more places and refactor/fix workspace prev_next fun… Aug 15, 2018
completions ipc: add tick event Aug 1, 2018
contrib Move awesome config to contrib/ Jan 14, 2017
include Merge pull request #2466 from RyanDwyer/geometry Aug 18, 2018
protocols Swaylock: Allow per-output images May 20, 2018
security.d delete references to swaygrab Jul 30, 2018
sway Merge pull request #2466 from RyanDwyer/geometry Aug 18, 2018
swaybar swaybar: Fix scroll handling on workspace buttons Jul 19, 2018
swaybg Allow a fallback color to be specified for swaybg Aug 8, 2018
swayidle delete references to swaygrab Jul 30, 2018
swaylock Fix swaylock arguments Jul 18, 2018
swaymsg ipc: add tick event Aug 1, 2018
swaynag swaynag: destroy old cursor theme when updated Aug 10, 2018
.build.yml Add scdoc to .build.yml May 12, 2018
.clang-format Update .clang-format - not entirely usable yet Jan 11, 2017
.editorconfig Create .editorconfig Jul 4, 2016
.gitignore Add subprojects to gitignore Mar 28, 2018
CONTRIBUTING.md Update for swaywm/wlroots#1126 Jul 9, 2018
HACKING.md Update for swaywm/wlroots#1126 Jul 9, 2018
LICENSE MIT license Jan 6, 2017
README.de.md Remove setcap instructions Aug 8, 2018
README.el.md Remove setcap instructions Aug 8, 2018
README.fr.md Remove setcap instructions Aug 8, 2018
README.it.md Remove setcap instructions Aug 8, 2018
README.ja.md 私の日本語が上手じゃないですね Aug 8, 2018
README.md Remove setcap instructions Aug 8, 2018
README.pt.md delete references to swaygrab Jul 30, 2018
README.ru.md delete references to swaygrab Jul 30, 2018
README.uk.md delete references to swaygrab Jul 30, 2018
config.in config.in: nag user on exit Aug 2, 2018
meson.build Merge branch 'master' into nagbar Aug 2, 2018
meson_options.txt meson: install bash completion Jul 30, 2018
sway.desktop Add Wayland and Xorg session files Aug 20, 2015

README.md

sway

English - 日本語 - Deutsch - Ελληνικά - Français - Українська - Italiano - Português - Русский

"SirCmpwn's Wayland compositor" is a work in progress i3-compatible Wayland compositor. Read the FAQ. Join the IRC channel (#sway on irc.freenode.net).

Notice: You are viewing the unstable and unsupported master branch of sway, where work is ongoing to port it to wlroots. The supported branch is the 0.15 branch, and end users are encouraged to use the stable releases cut from it.

If you'd like to support sway development, please contribute to SirCmpwn's Patreon page.

Release Signatures

Releases are signed with B22DA89A and published on GitHub.

Status

Installation

From Packages

Sway is available in many distributions. Try installing the "sway" package for yours. If it's not available, check out this wiki page for information on installation for your distributions.

If you're interested in packaging sway for your distribution, stop by the IRC channel or shoot an email to sir@cmpwn.com for advice.

Compiling from Source

Install dependencies:

  • meson
  • wlroots
  • wayland
  • xwayland
  • libinput >= 1.6.0
  • libcap
  • pcre
  • json-c >= 0.13
  • pango
  • cairo
  • gdk-pixbuf2 *
  • pam **
  • dbus >= 1.10 ***
  • scdoc (required for man pages)

*Only required for swaybar, swaybg, and swaylock

**Only required for swaylock

***Only required for tray support

Run these commands:

meson build
ninja -C build
sudo ninja -C build install

On systems without logind, you need to suid the sway binary:

sudo chmod a+s /usr/local/bin/sway

Sway will drop root permissions shortly after startup.

Configuration

If you already use i3, then copy your i3 config to ~/.config/sway/config and it'll work out of the box. Otherwise, copy the sample configuration file to ~/.config/sway/config. It is usually located at /etc/sway/config. Run man 5 sway for information on the configuration.

Running

Run sway from a TTY. Some display managers may work but are not supported by sway (gdm is known to work fairly well).