i3-compatible Wayland compositor
Find a file
Nihal Jere 119f31edb4 config.in: use swaynag -B instead of -b
'-b' spawns a terminal, which is unnecessary for this use case
2021-10-17 21:30:33 +02:00
.builds ci: make Meson warnings fatal 2021-06-30 13:37:00 +02:00
.github/ISSUE_TEMPLATE github: don't truncate debug logs 2021-10-17 21:28:51 +02:00
assets License wallpapers as CC-0 2019-12-16 14:35:58 -05:00
client cairo: Replace <cairo/cairo.h> by <cairo.h> 2021-05-10 10:28:32 +02:00
common Avoid unecessary font metric calculations 2021-09-20 09:25:47 +02:00
completions i3-compat: add GET_BINDING_STATE IPC command 2020-06-14 00:55:14 -04:00
contrib grimshot: Exit 1 on cancellation 2021-07-10 13:03:42 +02:00
include commands: Remove unused code after 1d3681f521 2021-10-01 15:45:09 +02:00
protocols build: subproject support for wayland-protocols 2021-09-08 08:19:40 +02:00
sway Fix a couple of typos 2021-10-16 02:16:12 -04:00
swaybar swaybar: fix cairo_font_options leak 2021-10-08 09:33:03 +02:00
swaymsg cross-reference further documentation 2021-10-15 15:20:40 +02:00
swaynag swaynag: fix pointer button events on scaled outputs 2021-09-13 14:46:01 +02:00
.clang-format Update clang format to better match existing code 2021-06-22 20:21:45 +02:00
.editorconfig Create .editorconfig 2016-07-04 14:12:32 +02:00
.gitignore Allocate minimum size necessary in pango text functions. (#3473) 2019-01-20 15:03:30 +01:00
config.in config.in: use swaynag -B instead of -b 2021-10-17 21:30:33 +02:00
CONTRIBUTING.md Fix IRC links in READMEs and templates 2021-05-26 08:25:13 +02:00
LICENSE MIT license 2017-01-06 13:45:48 -05:00
meson.build build: remove scdoc stdin/stdout hack 2021-09-15 08:21:20 +02:00
meson_options.txt Add meson options to enable/disable swaybar and swaynag 2021-07-21 18:24:09 +02:00
README.de.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.dk.md readme: Align Danish translation with main README 2021-09-13 17:05:28 +02:00
README.es.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.fr.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.gr.md README: Added Greek translation 2021-09-19 14:14:42 +02:00
README.hu.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.ir.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.ja.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.ko.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.md readme: drop recommendation about packaging 2021-10-07 19:08:58 +03:00
README.nl.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.pl.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.pt.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.ro.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.ru.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.tr.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.uk.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.zh-CN.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
README.zh-TW.md readme: link to gamja for IRC 2021-09-13 10:58:45 +02:00
sway.desktop Update language in sway.desktop & sway(1) 2019-03-10 15:09:52 -04:00

sway

English - 日本語 - Français - Українська - Español - Polski - 中文-简体 - Deutsch - Nederlands - Русский - 中文-繁體 - Português - Dansk - 한국어 - Română - Magyar - 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 *
  • pcre
  • 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).