i3-compatible Wayland compositor
Go to file
Simon Ser 88b2abf5f2 config: use format_str() instead of hand-rolled snprintf() 2024-02-08 16:11:24 -05:00
.builds ci: add libdisplay-info dependency 2023-02-28 23:19:33 +01: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 Use shm_open instead of mkstemp 2022-11-25 00:05:12 +01:00
common common: move load_image to swaybar 2023-11-23 20:42:04 +01:00
completions build: move completions to separate file 2022-11-28 18:51:45 -05:00
include Add debug flag to re-enable wl_drm 2024-01-20 14:42:58 -05:00
protocols Chase wlroots!4440 2023-11-22 00:42:55 +03:00
sway config: use format_str() instead of hand-rolled snprintf() 2024-02-08 16:11:24 -05:00
swaybar common: move load_image to swaybar 2023-11-23 20:42:04 +01:00
swaymsg fix typo 2023-02-25 10:50:43 +01:00
swaynag swaynag/config.c: fix build against gcc-14 (-Walloc-size) 2023-11-03 13:25:27 +01:00
.editorconfig Create .editorconfig 2016-07-04 14:12:32 +02:00
.gitignore gitignore: Ignore clangd-generated directory .cache/ 2023-10-23 11:05:08 +02:00
.mailmap Add a .mailmap file 2023-03-26 23:22:30 +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
README.ar.md Translate README to Arabic 2023-09-14 13:37:50 +02:00
README.cs.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.de.md Update README.de.md to match the EN one 2023-11-24 12:10:47 +01:00
README.dk.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.es.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.fr.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.ge.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.gr.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.hi.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.hu.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.ir.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.it.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.ja.md Improve Japanese translation 2022-10-08 10:12:00 +02:00
README.ko.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.md Clarify gdk-pixbuf dependency purpose 2024-01-19 12:22:55 +01:00
README.nl.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.no.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.pl.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.pt.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.ro.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.ru.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.sv.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.tr.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.uk.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.zh-CN.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
README.zh-TW.md readme: Stop recommending setuid bit for non-logind systems 2023-09-13 10:21:59 +02:00
config.in Use locale time format for default bar command 2023-11-21 17:42:09 +01:00
meson.build build: bump version to 1.10-dev 2024-01-26 15:25:14 +01:00
meson_options.txt Clarify gdk-pixbuf dependency purpose 2024-01-19 12:22:55 +01:00
sway.desktop Update language in sway.desktop & sway(1) 2019-03-10 15:09:52 -04:00

README.md

sway

English - عربي - Česky - Deutsch - Dansk - Español - Français - ქართული - Ελληνικά - हिन्दी - Magyar - فارسی - Italiano - 日本語 - 한국어 - Nederlands - Norsk - Polski - Português - Română - Русский - Svenska - 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: additional image formats for system tray)
  • swaybg (optional: wallpaper)
  • scdoc (optional: man pages) *
  • git (optional: version info) *

* Compile-time dep

Run these commands:

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

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).