Layouts for Every Screen
Switch between Shoji master-stack, dwindle, scrolling column strips, and monocle per workspace across single or multi-monitor setups.
Wayland Tiling Compositor
A keyboard-first Wayland compositor with dwindle, master-stack, scrolling, and monocle layouts. Configured in Lua 5.4 and scriptable over a UNIX socket.
Key Features
Smooth Motion & Clean Rendering
Spring and cubic-Bezier window transitions, blur, active borders, layer-shell bars like Waybar or Ironbar, and Waydroid/Xwayland support.
Lua Config & Socket Control
Configure keybindings, monitor placement, and window rules in ~/.config/koma/init.lua with full editor completion via koma-types.
Captures from Live Sessions
Prebuilt via AUR
paru -S koma-binBuild from source PKGBUILD
paru -S komaOne-line keyring & komawm.sources setup
curl -fsSL https://cdn.komawm.org/apt/setup.sh | sudo bash
sudo apt install -y komaManual deb822 source
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://cdn.komawm.org/apt/komawm-archive-keyring.gpg -o /etc/apt/keyrings/komawm-archive-keyring.gpg
sudo curl -fsSL https://cdn.komawm.org/apt/komawm.sources -o /etc/apt/sources.list.d/komawm.sources
sudo apt update && sudo apt install -y komaFedora / Copr
sudo dnf copr enable -y komawm/koma
sudo dnf install -y komaDirect RPM Package
TAG=$(curl -fsSL https://cdn.komawm.org/install/koma/latest.txt)
sudo dnf install -y "https://cdn.komawm.org/releases/koma/$TAG/koma-${TAG#v}-1.x86_64.rpm"TAG=$(curl -fsSL https://cdn.komawm.org/install/koma/latest.txt)
curl -fsSLO "https://cdn.komawm.org/releases/koma/$TAG/koma_${TAG#v}_linux_amd64.apk"
sudo apk add --allow-untrusted "./koma_${TAG#v}_linux_amd64.apk"Run or install via Flake
nix run github:komawm/koma
nix profile install github:komawm/komacurl -fsSLO https://cdn.komawm.org/install/koma/koma.rb
brew install --formula ./koma.rbpkg install -y rust git pkgconf wayland libxkbcommon libinput mesa-libs seatd
git clone https://github.com/komawm/koma.git && cd koma
cargo build --release --workspacepkg_add rust git
git clone https://github.com/komawm/koma.git && cd koma
cargo check -p koma-ipc -p komactl -p koma-mcpcargo +1.100.0 install --git https://github.com/komawm/koma.git koma komactl koma-mcp koma-overview --locked