Skip to content


miracle-wm is a Wayland compositor based on Mir. It features a tiling window manager at its core, very much in the style of i3 and sway. The intention is to build a compositor that is flashier and more feature-rich than either of those compositors, like swayfx.

See the installation guide for installation instructions on your platform.


If none of this makes any sense to you or you're new to Wayland or Linux, check out the What is a Wayland compositor? document for a structured walk through the entire ecosystem.


  • A tiling window manager, similar to i3 and sway
    • Built-in support for inner/outer gaps
  • An optional floating window manager for individual windows
  • A YAML configuration file
  • Support for the following wayland protocols:
    • ext_session_lock_manager_v1
    • mir_shell_v1
    • wl_shell
    • xdg_wm_base
    • zwlr_foreign_toplevel_manager_v1
    • zwlr_layer_shell_v1
    • zwlr_screencopy_manager_v1
    • zwlr_virtual_pointer_manager_v1
    • zwp_input_method_manager_v2
    • zwp_text_input_manager_v1
    • zwp_text_input_manager_v2
    • zwp_text_input_manager_v3
    • zwp_virtual_keyboard_manager_v1
    • zxdg_output_manager_v1
    • zxdg_shell_v6
    • zwp_idle_inhibit_manager_v1
    • zwp_input_method_v1
    • zwp_input_panel_v1
    • zwp_pointer_constraints_v1
    • zwp_primary_selection_device_manager_v1
    • zwp_relative_pointer_manager_v1
  • Support for a wide array of graphics cards, including hybrid systems and outputs driven by Nvidia's proprietary drivers
  • Workspace support
  • Growing support for i3/sway IPC
    • A minimal implementation for waybar at the moment