miracle-wm is a hackable Wayland compositor built on Mir.
It brings keyboard-driven tiling window management to Wayland, combining the efficiency of i3 and Sway with animations, extensibility, and a modern configuration system.
The compositor supports manual tiling, floating windows, multi-monitor setups, hot-reloadable configuration, and an i3/Sway-compatible IPC layer. Its WebAssembly plugin system lets users extend or override behaviour without modifying the compositor’s C++ code.
This is free and open source software.
Key Features
- Wayland compositor built on Mir
- Manual tiling with horizontal, vertical, tabbed, and stacked layouts
- Floating and tiled windows in the same workspace
- Smooth window, resize, move, and workspace animations
- WebAssembly plugin system for extending compositor behaviour
- i3/Sway-compatible IPC with support for tools such as swaymsg and Waybar
- Hot-reloadable YAML configuration
- Multi-monitor support with configurable workspaces
- Built-in accessibility features including magnifier, slow keys, sticky keys, and cursor configuration
Website: github.com/miracle-wm-org/miracle-wm
Support:
Developer: miracle-wm-org
License: GNU General Public License v3.0

miracle-wm is written in C++. Learn C++ with our recommended free books and free tutorials.
Related Software
| Tiling Wayland Compositors | |
|---|---|
| Sway | i3-compatible tiling Wayland compositor and a replacement for i3 |
| niri | Scrollable-tiling Wayland compositor |
| Hyprland | Dynamic tiling Wayland compositor based on wlroots |
| Qtile | Full-featured, hackable tiling window manager |
| Swayfx | Sway with eye candy |
| river | Compositor with flexible runtime configuration. |
| MangoWC | Lightweight yet a good set of features |
| dwl | dwm for Wayland |
| fht-compositor | Dynamic tiling Wayland compositor |
| newm-atha | Wayland compositor written with laptops and touchpads in mind |
| Cagebreak | Seeks inspiration from Ratpoison |
| Mahogany | Modeled after StumpWM |
| Jay | Wayland compositor written in Rust |
| Vivarium | Dynamic tiling Wayland compositor using wlroots |
| polonium | Tiling window manager for KWin |
| Volare | Tabbed, tiling Wayland compositor |
| japokwm | wlroots and dwl based tiling wayland compositor |
| velox | Simple window manager based on swc |
| stagen | wlroots-based Wayland compositor |
| newm | Written with laptops and touchpads in mind |
Read our verdict in the software roundup.
Explore our comprehensive directory of recommended free and open source software. Our carefully curated collection spans every major software category.This directory is part of our ongoing series of informative articles for Linux enthusiasts. It features hundreds of detailed reviews, along with open source alternatives to proprietary solutions from major corporations such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. You’ll also find interesting projects to try, hardware coverage, free programming books and tutorials, and much more. Discovered a useful open source Linux program that we haven’t covered yet? Let us know by completing this form. |

