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.
- 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 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.
Installation instructions, build instructions, and a full roadmap live at:
Plugin API documentation is at:
Questions, ideas, and contributions are welcome. Find us on Matrix: