1
1
mirror of https://github.com/swaywm/sway synced 2024-12-04 19:08:18 +01:00
i3-compatible Wayland compositor https://swaywm.org
Go to file
Daniel Kahn Gillmor dcb142bf5e sway-ipc(7): Escape backslashes correctly in GET_CONFIG output
Without this change, i see the following in the sway-ipc manpage:

```

   9. GET_CONFIG
       MESSAGE
       Retrieve the contents of the config that was last loaded

       REPLY
       An object with a single string property containing the contents of  the
       config

       Example Reply:
           {
                "config": "set $mod Mod4nbindsym $mod+q exitn"
           }
```
2024-03-30 01:16:22 +01:00
.builds
.github/ISSUE_TEMPLATE
assets License wallpapers as CC-0 2019-12-16 14:35:58 -05:00
client
common
completions
include
protocols
sway
swaybar
swaymsg
swaynag
.editorconfig
.gitignore
.mailmap
config.in
CONTRIBUTING.md
LICENSE
meson_options.txt
meson.build
README.ar.md
README.cs.md
README.de.md
README.dk.md
README.es.md
README.fr.md
README.ge.md
README.gr.md
README.hi.md
README.hu.md
README.ir.md
README.it.md
README.ja.md
README.ko.md
README.md
README.nl.md
README.no.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
release.sh
sway.desktop

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