Miracle-wm, a window manager based on Wayland and Mir


miracle-wm capture

Some days ago, Matthew Kosarek, a software engineer at Canonical which works on Mir display server, made it known via the Ubuntu forums, the first version of a new composite manager called miracle-wm, which is based on the Wayland protocol and components to build composite Mir managers.

Miracle-wm offers support for window tiling, similar to i3 window manager, the Hyprland composite manager and the Sway user environment and it is mentioned that the intention is to create a composer that is flashier and more feature-rich than any of those composers, such as swayfx.

Among the highlighted functions The first version of miracle-wm includes:

  • Tile window management with the ability to adjust gaps between windows.
  • Use of virtual desktops.
  • Support for reserving screen areas for panel placement.
  • Ability to expand windows to full screen.
  • Support for multiple outputs.
  • Navigation and control using the keyboard.
  • The route bar can be used as a panel.
  • Change the selected window with the keyboard
  • Mobile window with keyboard shortcuts
  • Configuration is done through a configuration file.
  • Configuration
    • space size
    • Action key
    • Startup apps
    • Startup apps
    • Override default keybinds
    • Custom keybinds

In addition, miracle-wm also offers support for gaps between windows, exclusion zones for panels like Waybar, full-screen windows, multiple output, and workspace support.

The ultimate goal of the project is to develop a composite server that uses tiled windows, but surpasses projects like Swayfx in functionality and elegance.

miracle-wm is expected to be useful for users who prefer more sophisticated visual effects and graphics, with transitions and soft colors. The first version is presented as a preview version and it is mentioned that the next two versions will also maintain this status, after which the first stable version will be released.

The next version is planned to add support for floating overlay windows, the ability to change settings without rebooting, options to customize the display, the ability to pin windows to a specific location on the desktop, support for IPC I3, and highlighting windows. active.

Subsequently, preparations will begin for the first version that will implement support for animation effects, stacked window layout, overview mode for navigating windows and desktops, as well as a graphical interface for configuration.

For interested in the project, You should know that the project code is written in C++ and is distributed under the GPLv3 license. If you want to know more about it, you can consult the details In the following link.

How to install Miracle-wm?

For those who are interested in trying this window manager, You should know that its installation is quite simple, so you only have to execute one of the following commands as appropriate.

Before proceeding with the installation, I must remember that this window manager is still in the development stage, so it still lacks many functionalities and as already mentioned, some of the most common ones are planned to be integrated for future versions. . You can consult the list of functions already supported and to be integrated In the following link.

Well, the above has already been mentioned and if you are still interested in being able to install this manager, you must have Snap support, open a terminal and in it you are going to type the following:

sudo snap install miracle-wm --classic

If you don't like using Snap packages, you can compile the manager with the following commands:

git clone https://github.com/mattkae/miracle-wm.git
cd miracle-wm

cmake -Bbuild
cmake --build build
WAYLAND_DISPLAY=wayland-98 ./build/bin/miracle-wm

Once the manager is installed, just close your user session and choose the "Miracle" option from your screen manager before logging in.

Last, but not least, I invite you to consult the manager's user guide so that you can learn a little more about how to work with it, since it works with many keyboard shortcuts. 

Leave a Comment

Your email address will not be published. Required fields are marked with *



  1. Responsible for the data: Miguel Ángel Gatón
  2. Purpose of the data: Control SPAM, comment management.
  3. Legitimation: Your consent
  4. Communication of the data: The data will not be communicated to third parties except by legal obligation.
  5. Data storage: Database hosted by Occentus Networks (EU)
  6. Rights: At any time you can limit, recover and delete your information.