i3-compatible Wayland compositor
Find a file
2022-11-26 10:29:59 +01:00
.builds ci: checkout wlroots 0.16.0 2022-11-11 22:30:10 +01:00
.github/ISSUE_TEMPLATE
assets
client Use shm_open instead of mkstemp 2022-11-26 10:29:58 +01:00
common
completions
contrib grimshot: fix tilde expansion within quotes 2022-07-30 09:25:24 +02:00
include launcher: export xdga tokens and use them for workspace matching 2022-11-26 10:29:59 +01:00
protocols build: drop intermediate libraries for protocols 2022-11-26 10:29:58 +01:00
sway launcher: export xdga tokens and use them for workspace matching 2022-11-26 10:29:59 +01:00
swaybar build: drop intermediate libraries for protocols 2022-11-26 10:29:58 +01:00
swaymsg swaymsg: show mode picture aspect ratio 2022-10-03 13:35:52 +02:00
swaynag build: drop intermediate libraries for protocols 2022-11-26 10:29:58 +01:00
.editorconfig
.gitignore
config.in
CONTRIBUTING.md
LICENSE
meson.build Use wl_signal_emit_mutable() 2022-11-10 22:27:38 +03:00
meson_options.txt
README.de.md
README.dk.md
README.es.md
README.fr.md
README.gr.md
README.hi.md
README.hu.md
README.ir.md
README.it.md
README.ja.md Improve Japanese translation 2022-10-08 10:12:00 +02:00
README.ko.md
README.md
README.nl.md
README.pl.md
README.pt.md
README.ro.md
README.ru.md
README.sv.md
README.tr.md
README.uk.md
README.zh-CN.md
README.zh-TW.md
sway.desktop

sway

English - Deutsch - Dansk - Español - Français - Svenska - Ελληνικά - हिन्दी - Magyar - فارسی - Italiano - 日本語 - 한국어 - Nederlands - Polski - Português - Română - Русский - Türkçe - Українська - 中文-简体 - 中文-繁體

sway is an i3-compatible Wayland compositor. Read the FAQ. Join the IRC channel (#sway on irc.libera.chat).

Release Signatures

Releases are signed with E88F5E48 and published on GitHub.

Installation

From Packages

Sway is available in many distributions. Try installing the "sway" package for yours.

Compiling from Source

Check out this wiki page if you want to build the HEAD of sway and wlroots for testing or development.

Install dependencies:

  • meson *
  • wlroots
  • wayland
  • wayland-protocols *
  • pcre2
  • json-c
  • pango
  • cairo
  • gdk-pixbuf2 (optional: system tray)
  • scdoc (optional: man pages) *
  • git (optional: version info) *

* Compile-time dep

Run these commands:

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

On systems without logind nor seatd, 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).