From Fedora Project Wiki

Fedora Miracle


Create an official Fedora Spin shipping the up-and-coming Miracle Window Manager


  • Email:,,

Current status

Detailed Description

The Miracle Window Manager is a tiling window manager based on the Mir compositor library. While it is a newer project, it contains many useful features such as a manual tiling algorithm, floating window manager support, support for many Wayland protocols, proprietary Nvidia driver support, and much more. Users are increasingly interested in using miracle in various systems.

The goal of the miracle spin is to build a complete and elegant tiling window experience within the Fedora ecosystem.


Benefit to Fedora

Miracle will provide Fedora with a high-quality Wayland experience built with support for all kinds of platforms, including low-end ARM and x86 devices. On top of this, Fedora will be the first distribution to provide a Miracle based spin, ensuring that it will become the de facto distribution for running Miracle.


  • Proposal owners:
    • SIG request: #11856
    • comps: TODO
    • fedora-release-miracle: TODO
    • kickstart: TODO
    • livesys-scripts: TODO

  • Other developers: N/A
  • Policies and guidelines: N/A (not needed for this Change)
  • Trademark approval: #491
  • Alignment with Community Initiatives: N/A

Upgrade/compatibility impact

This is a new spin, so there is nothing.

How To Test

Package-x-generic-16.pngmiracle-wm is available in Fedora Linux 40, so it can be installed on top of something like the existing Sway spin and configured to reuse much of the tools used there.

For Fedora Linux 41, once the spin is produced, people can download and try the experience intended to be released.

User Experience

The experience will be similar to the Sway spin, though with more features there may be some different choices on defaults.



Contingency Plan

  • Contingency mechanism: Push off to the next Fedora release.
  • Contingency deadline: Beta freeze
  • Blocks release? No


N/A (not a System Wide Change)

Release Notes

This release introduces the Fedora Miracle Spin. The Fedora Miracle Spin aims to provide the premiere Miracle window manager experience on top of Fedora Linux, the leading edge platform for developers and users alike.