swaywm/sway

Analysis updated 2026-06-24

★ 16,903CAudience · ops devopsComplexity · 4/5Setup · hard

Mindmap

mindmap
    root((sway))
      Inputs
        i3 config file
        Keyboard shortcuts
        Wayland session
      Outputs
        Tiled window layout
        Wayland compositor
        Status bar via swaybar
      Use Cases
        Replace i3 on Wayland
        Keyboard-driven Linux desktop
        Lightweight tiling setup
      Tech Stack
        C
        Wayland
        wlroots

mindmap root((sway)) Inputs i3 config file Keyboard shortcuts Wayland session Outputs Tiled window layout Wayland compositor Status bar via swaybar Use Cases Replace i3 on Wayland Keyboard-driven Linux desktop Lightweight tiling setup Tech Stack C Wayland wlroots

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Run a keyboard-driven tiling desktop on Linux Wayland

USE CASE 2

Migrate an existing i3 setup to Wayland with the same config

USE CASE 3

Build a minimal dev workstation with sway plus a status bar and launcher

What is it built with?

CWaylandwlrootsMeson

How does it compare?

	swaywm/sway	woltapp/blurhash	nvidia/open-gpu-kernel-modules
Stars	16,903	16,980	16,991
Language	C	C	C
Setup difficulty	hard	easy	hard
Complexity	4/5	2/5	5/5
Audience	ops devops	developer	ops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Needs Wayland-ready GPU drivers and an understanding of session managers, since most distros do not preconfigure sway.

In plain English

Sway is a window manager, the software that controls how application windows are arranged on your screen, designed for the Linux desktop. It is compatible with i3, a popular keyboard-driven window manager, meaning users who already have an i3 setup can switch to sway with little or no reconfiguration. The key distinction is that sway runs on Wayland rather than X11. Wayland is a newer display system for Linux that is gradually replacing the older X11 protocol, it is generally considered more secure and efficient. Because sway mirrors i3's configuration and shortcuts, it lets existing i3 users move to Wayland without relearning their tools. Sway is written in C and is a compositor, meaning it handles both window arrangement and rendering (drawing windows on screen) in one program. It supports optional features like wallpapers and system tray icons through companion tools. You would use sway if you are a Linux user who wants a fast, keyboard-centric tiling window manager on a Wayland session, especially if you are already comfortable with i3 and want to take advantage of Wayland's benefits without changing your workflow. It is a developer-and-power-user tool, it is not a point-and-click desktop environment.

Copy-paste prompts

Prompt 1

Give me a minimal Arch Linux install plan that boots straight into sway with a working status bar

Prompt 2

Convert my i3 config to a sway config and flag any keybindings that need changing

Prompt 3

Show me how to set up screen sharing in sway for Zoom and Google Meet

Prompt 4

Write a sway config that uses a dual monitor setup with one vertical and one horizontal display

Frequently asked questions

What is sway?

An i3-compatible tiling window manager and Wayland compositor for Linux. Existing i3 configs work with little or no change on a Wayland session.

What language is sway written in?

Mainly C. The stack also includes C, Wayland, wlroots.

How hard is sway to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is sway for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub swaywm on gitmyhub

Verify against the repo before relying on details.