miracle-wm

miracle-wm is a hackable, stylish, and modern Wayland compositor built on Mir. It brings the keyboard-driven efficiency of i3/Sway to a richer, more extensible experience with smooth animations, a powerful WebAssembly plugin system, and a clean YAML configuration.

miracle in action

Features

Manual tiling — organize windows into horizontal, vertical, tabbed, or stacked layouts with full keyboard control
Floating windows — seamlessly mix floating and tiled windows in the same workspace
Smooth animations — window open/close, moves, resizes, and workspace transitions all animate out of the box
WebAssembly plugin system — extend and override core behavior without touching a line of C++
i3/Sway-compatible IPC — works with swaymsg, Waybar, and the rest of the ecosystem you already know
Hot-reload config — apply changes instantly with Meta+Shift+R, no restart required
Multi-monitor support — independent workspaces across outputs, fully configurable
Accessibility built in — magnifier, slow keys, sticky keys, and cursor configuration included

Plugins

Plugins run as sandboxed WebAssembly modules, so you get first-class extensibility with zero risk to compositor stability.

Write plugins in Rust (via the miracle-plugin crate) and hook into:

Window placement logic — put windows exactly where you want them
Input events — intercept keystrokes and pointer events before the compositor handles them
Animations — trigger custom animations with arbitrary timing at any lifecycle event
Workspace and output events — react to workspace creation, deletion, and switching
Configuration — read and extend the compositor's config at runtime

Plugins hot-reload when the configuration reloads, so your iteration loop is fast.