You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Martin Michlmayr a085e6495c swaymsg.1: fix typos 4 days ago
.builds Remove rootston from build manifests 1 month ago
.github Create FUNDING.yml 3 months ago
assets Recompressed PNG files 2 years ago
client swaybg: split into standalone project 4 months ago
common ipc-client: remove useless free for failed malloc 1 month ago
completions Add missing swaymsg completions 6 months ago
contrib chmod +x contrib/_incr_version 2 weeks ago
include remove unused layer shell surface variable 1 week ago
protocols Remove xdg-shell v6 support 3 weeks ago
security.d delete references to swaygrab 1 year ago
sway sway-output.5: fix variable name 4 days ago
swaybar swaybar: complete barconfig_update event handling 1 week ago
swaymsg swaymsg.1: fix typos 3 days ago
swaynag Fix markup syntax in man pages 2 weeks ago
.clang-format Update .clang-format - not entirely usable yet 2 years ago
.editorconfig Create .editorconfig 3 years ago
.gitignore Allocate minimum size necessary in pango text functions. (#3473) 7 months ago
CONTRIBUTING.md CONTRIBUTING.md: mention tab width for line length 8 months ago
ISSUE_TEMPLATE.md Add Firefox note to ISSUE_TEMPALTE.md 4 months ago
LICENSE MIT license 2 years ago
README.de.md Add link to i3 in first mention of README 4 months ago
README.es.md Add link to i3 in first mention of README 4 months ago
README.fr.md Add link to i3 in first mention of README 4 months ago
README.ja.md Add link to i3 in first mention of README 4 months ago
README.md Add Russian translation of the README 6 days ago
README.nl.md Added Dutch translation of README 2 months ago
README.pl.md Add link to i3 in first mention of README 4 months ago
README.ru.md Add Russian translation of the README 6 days ago
README.uk.md Add link to i3 in first mention of README 4 months ago
README.zh-CN.md Add link to i3 in first mention of README 4 months ago
config.in Make comment casing consistient 3 months ago
meson.build Remove all wayland-server.h includes 1 month ago
meson_options.txt Set version in project file 7 months ago
sway.desktop Update language in sway.desktop & sway(1) 6 months ago

README.md

sway

English - 日本語 - Français - Українська - Español - Polski - 中文-简体 - Deutsch - Nederlands - Русский

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

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.

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
  • wayland-protocols *
  • pcre
  • json-c
  • pango
  • cairo
  • gdk-pixbuf2 (optional: system tray)
  • scdoc (optional: man pages) *
  • git *

*Compile-time dep

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