Deterministic Shoji & Dwindle Layouts
Pure window-tree state transitions across Shoji, Dwindle, Scrolling, and Monocle modes with multi-monitor DRM/KMS isolation and zero implicit side effects.
Precision Wayland Tiling Compositor
Built for pure keyboard workflows and concurrent GUI orchestration. Separates deterministic window state, Dual-Kawase rendering, virtual-seat dispatch, and a sandboxed Lua 5.4 policy layer.
Architecture Highlights
Hooke Spring Physics, Bezier & Shaders
Semi-implicit Euler damped Hooke springs (mx'' + cx' + kx = 0), custom Cubic Bezier curves, Dual-Kawase blur, gradient borders, and virtual-seat input isolation.
Phodopus Lua 5.4 & Dual IPC
Sandboxed configuration backed by versioned LuaLS definitions (koma-types), dual control/data UNIX sockets, Epoch lease fencing, and native MCP integration.
Workspace Architecture & Visuals
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 from R2 CDN
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/komabrew tap komawm/tap https://github.com/komawm/packaging
brew install komawm/tap/komapkg 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-compositor komactl koma-mcp --locked