swaywm /sway

i3-compatible Wayland compositor

★ 17,522⑂ 1,326👁 208⑃ 4,065● 5,200▤ 84
CMITCreated 2015-08-05swaywm.org
Download: 1.121.12 ↓1.122026-05-25
+2
Daily
17,522
stars
1,326
forks
208
watchers
4,065
prs
5,200
issues
84
releases

README

sway

[English][en] - [عربي][ar] - [Azərbaycanca][az] - [Česky][cs] - [Deutsch][de] - [Dansk][dk] - [Español][es] - [Français][fr] - [ქართული][ge] - [Ελληνικά][gr] - [हिन्दी][hi] - [Magyar][hu] - [فارسی][ir] - [Italiano][it] - [日本語][ja] - [한국어][ko] - [Nederlands][nl] - [Norsk][no] - [Polski][pl] - [Português][pt] - [Română][ro] - [Русский][ru] - [Српски][sr] - [Svenska][sv] - [Türkçe][tr] - [Українська][uk] - [中文-简体][zh-CN] - [中文-繁體][zh-TW]

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][GitHub releases].

 Installation

 From Packages

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

 Compiling from Source

Check out [this wiki page][Development setup] 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 setup 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 or from a display manager.

[en]: https://github.com/swaywm/swayreadme
[ar]: README.ar.md
[az]: README.az.md
[cs]: README.cs.md
[de]: README.de.md
[dk]: README.dk.md
[es]: README.es.md
[fr]: README.fr.md
[ge]: README.ge.md
[gr]: README.gr.md
[hi]: README.hi.md
[hu]: README.hu.md
[ir]: README.ir.md
[it]: README.it.md
[ja]: README.ja.md
[ko]: README.ko.md
[nl]: README.nl.md
[no]: README.no.md
[pl]: README.pl.md
[pt]: README.pt.md
[ro]: README.ro.md
[ru]: README.ru.md
[sr]: README.sr.md
[sv]: README.sv.md
[tr]: README.tr.md
[uk]: README.uk.md
[zh-CN]: README.zh-CN.md
[zh-TW]: README.zh-TW.md
[i3]: https://i3wm.org/
[Wayland]: http://wayland.freedesktop.org/
[FAQ]: https://github.com/swaywm/sway/wiki
[IRC channel]: https://web.libera.chat/gamja/?channels=sway
[E88F5E48]: https://keys.openpgp.org/search?q=34FF9526CFEF0E97A340E2E40FDE7BE0E88F5E48
[GitHub releases]: https://github.com/swaywm/sway/releases
[Development setup]: https://github.com/swaywm/sway/wiki/Development-Setup
[wlroots]: https://gitlab.freedesktop.org/wlroots/wlroots
[swaybg]: https://github.com/swaywm/swaybg/
[scdoc]: https://git.sr.ht/~sircmpwn/scdoc

Top issues

Latest release

1.12 1.12 2026-05-25
Sway 1.12 contains 138 changes from 50 contributors.

This release depends on wlroots 0.20.0. See the wlroots release notes.

 New features

- Add support for capturing individual windows.
- Add support for HDR10 when running with the Vulkan renderer.
- Add support for new protocols: color-management-v1, color-representation-v1, xdg-toplevel-tag-v1, ext-workspace-v1, wl_fixes.
- Add a new --device-primaries to output color_profile to use color primaries advertised in EDID.
- Add support for keypad slide switches.

 Changes

- The default configuration file now ships key bindings 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON