v0.2.1

It is me again 👋

As promised, I am following up with a release of the Ubuntu deb and Fedora packages. 📦 At the time of posting this, the Fedora package is not quite yet published, but it will follow shortly. The deb package is available on mantic and noble at the moment at version 0.2.0.

On top of this, I'll also took this opportunity to update how we present our documentation. Head on over to https://mattkae.github.io/miracle-wm-wiki/ for a much better documentation experience. Please feel free to open up pull requests to fix any errors that you see in the documentation 🎉

What's Changed

• fedora: release 0.2.0 by @mattkae in #101
• packaging: Only install unsnap wrapper when building as a snap by @mattkae in #105
• debian: released 0.2.0 for noble and mantic by @mattkae in #106
• feature: docs now exist on github pages by @mattkae in #108
• fedora: bump to version 0.2.1 for fedora release by @mattkae in #107

Full Changelog: v0.2.0...v0.2.1

v0.2.0

Happy April everyone 🐦 🌷 (or alternatively "🥀 🍂" for my southern hemisphere friends). I am excited to announce release v0.2.0 of miracle-wm. As I mentioned in the previous release, all releases leading up to v1.0.0 are considered pre-releases, meaning that there may be some unexpected bugs or hitches on your particular platform that need fixing. Still, if you'd like to give the compositor a try - even if it's just to test if it runs on your machine and whatnot - I would very much appreciate it!

To install:

sudo snap install miracle-wm --classic

Features ⭐

• (#35) sway/i3 IPC support has been implemented to minimally support waybar
• (#45) Added "floating window manager" support whereby individual windows can be made to float above the tiling grid and behave just as they would in a "traditional" floating window manager
• (#38) The user configuration now automatically reloads when a change is made to it
• (#37) A terminal option can now be specified in the configuration to decide which terminal is opened up by the keybind. We also do a much better job of deciding on a sane default terminal
• Environment variables can now be specified in the configuration (e.g. I needed to set mesa_glthread=false to prevent a bunch of screen tearing on my new AMD card)
• Upgrade to Mir v2.16.4 which brought in a few important bugfixes for miracle-wm, namely:
  • Screenshots now respect clipping areas and rotated outputs (Fixes: canonical/mir#3236)
    (Fixes: canonical/mir#3259)
  • Add hardware cursor support (Fixes: canonical/mir#3198)

Packaging 📦

I will personally be maintaining packages for the Fedora RPM and the Ubuntu deb. These packages will be updated within a few days of this release, so stay tuned. At that time, I will also update the README with installation instructions. If you don't want a snap, this is for you!

Bugs Fixed 🔧

• (#48) Fullscreened windows are now guaranteed to be on top
• (#34) Fixed a bug where panels could not be interacted with
• (#50) Keyboard events are now properly consumed when a workspace switch happens
• (#61) Outer gaps no longer include inner gaps
• (#66) Disabled moving fullscreen windows between workspaces
• (#67) Fixed a bug where resizing a window over and over again would make it progressively tinier due to rounding errors
• Refactored the tiling window system in a big way for readability. This solved a number of tricky bugs in the process so I am very happy about it
• (#81) Gaps algorithm no longer leaves some nodes smaller than others
• The project finally has meaningful tests with many more to come 🧪

What's up next?

It is animation season! I am currently working in Mir on this task which will enable us to right our own renderer for miracle-wm. I also want to implement the remaining of the sway/i3 IPC tasks, but that work will be secondary to the animation work.

Check out the roadmap for more info.

v0.1.0

I am happy to announce the first-ever release of miracle-wm, a Wayland compositor based on Mir. I have successfully used the compositor as my daily-driver for two whole days at this point, and I am feeling quite confident in its current state. That being said, please be aware that all releases leading up to v1.0.0 are considered pre-releases, meaning that there may be some unexpected bugs or hitches on your particular platform that need fixing. If you'd rather wait for a feature-complete and stable release, feel free to "star" the repo so that you get a notification when that's ready. In the meantime, if you find any bugs, please report them on the issues page and I will be sure to get to them as soon as I can. Also if you fix any bugs, you will be my new friend 🤝.

To install the release yourself, simply do:

sudo snap install miracle-wm --classic

You can check out our Snap Store page here.

You can check out the user guide here.

Features

• Tiling window management (open windows, delete windows, resize windows)
• Gaps between windows
• Support for exclusion zones for panels (e.g. waybar)
• Support for fullscreen windows
• Multi-output support
• Workspace support
• A nifty configuration file

What's up next?

Check out the roadmap for more info.