# Miracle

> tiling Wayland window manager built on top of Mir

**Wikidata**: [Q131321719](https://www.wikidata.org/wiki/Q131321719)  
**Source**: https://4ort.xyz/entity/miracle

## Summary
Miracle is a tiling Wayland window manager built on top of the Mir display server. It is free software released under the GNU General Public License version 3.0 and is based on the i3 window manager design.

## Key Facts
- Miracle is a tiling Wayland window manager built on top of Mir.
- Miracle is licensed under the GNU General Public License, version 3.0.
- Miracle is described as instance_of: free software and tiling window manager.
- Miracle is based_on the i3 window manager.
- The official website is https://miracle-wm.org/ (English).
- The source code repository is https://github.com/miracle-wm-org/miracle-wm.
- A series of stable releases were published in 2024, including: 0.1.0 (2024-02-18), 0.2.0 (2024-04-19), 0.2.1 (2024-04-23), 0.3.0 (2024-07-02), 0.3.1 (2024-08-12), 0.3.2 (2024-08-13), 0.3.3 (2024-08-26), 0.3.4 (2024-08-27), 0.3.5 (2024-09-08), and 0.3.6 (2024-09-25).
- Programming language is recorded as Q2407 (as listed in source metadata).
- Copyright status is listed as copyrighted.
- Known aliases: miracle-wm, Miracle (window manager), Miracle Window Manager.

## FAQs
### Q: What is Miracle?
A: Miracle is a tiling window manager that runs on Wayland and is built on top of the Mir display server. It implements an i3-inspired tiling workflow and is distributed under the GNU GPLv3.

### Q: Is Miracle free and open source?
A: Yes. Miracle is classified as free software and is released under the GNU General Public License version 3.0. Its source code is publicly available on GitHub at https://github.com/miracle-wm-org/miracle-wm.

### Q: Where can I find releases and version history?
A: Stable release tags and dates are available in the project's GitHub releases. Notable 2024 stable releases include 0.1.0 (2024-02-18) through 0.3.6 (2024-09-25).

### Q: What is Miracle based on technically?
A: Miracle is built on the Mir display server and is based_on the i3 window manager design, providing a tiling Wayland window manager that follows i3-like principles.

## Why It Matters
Miracle provides an i3-style tiling window manager experience specifically for Wayland environments by building on the Mir display server. As Wayland adoption grows, having tiling window managers that natively target Wayland and work with Mir fills a gap for users who prefer keyboard-driven, tiling workflows and who previously relied on X11-based solutions like i3. Miracle's GPLv3 licensing and publicly available source repository make it accessible for examination, modification, and redistribution, aligning with free software principles. The project's release history in 2024, with a sequence of stable releases from 0.1.0 through 0.3.6, indicates an active development effort during that period. For users and developers seeking an i3-inspired tiling experience on Wayland/Mir, Miracle is a relevant, openly licensed option with an established release trail and a public codebase.

## Notable For
- Being a tiling Wayland window manager implemented on top of the Mir display server.
- Explicitly based on i3, carrying an i3-inspired design into the Wayland/Mir ecosystem.
- Distributed under the GNU General Public License version 3.0.
- Public development and releases hosted on GitHub at https://github.com/miracle-wm-org/miracle-wm.
- A documented series of stable releases in 2024, culminating in version 0.3.6 (2024-09-25).

## Body
### Overview
- Miracle is a tiling window manager targeting Wayland.
- It is built on top of the Mir display server.
- The project lists aliases: miracle-wm, Miracle (window manager), Miracle Window Manager.

### Classification and Licensing
- Instance_of: free software; tiling window manager.
- License: GNU General Public License, version 3.0.
- Copyright status: copyrighted.

### Technical Basis
- Based_on: i3 (indicating design or workflow inspiration from i3).
- Runs on Wayland and integrates with Mir as the display server layer.
- Programming language metadata is recorded as Q2407 (per source metadata).

### Development and Releases
- Source code repository: https://github.com/miracle-wm-org/miracle-wm.
- Documented stable releases (with publication dates):
  - 0.1.0 — publication_date: 2024-02-18
  - 0.2.0 — publication_date: 2024-04-19
  - 0.2.1 — publication_date: 2024-04-23
  - 0.3.0 — publication_date: 2024-07-02
  - 0.3.1 — publication_date: 2024-08-12
  - 0.3.2 — publication_date: 2024-08-13
  - 0.3.3 — publication_date: 2024-08-26
  - 0.3.4 — publication_date: 2024-08-27
  - 0.3.5 — publication_date: 2024-09-08
  - 0.3.6 — publication_date: 2024-09-25

### Distribution and Information
- Official website: https://miracle-wm.org/ (English).
- Source and release information available on GitHub repository linked above.

### Metadata and Identifiers
- Wikidata description: "tiling Wayland window manager built on top of Mir."
- Source_code_repository_url: https://github.com/miracle-wm-org/miracle-wm (with associated repository metadata in source).
- Related software class: free software (definition provided in source metadata).

## References

1. [Release 0.1.0. 2024](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.1.0)
2. [Release 0.2.0. 2024](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.2.0)
3. [Release 0.2.1. 2024](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.2.1)
4. [Release 0.3.0. 2024](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.3.0)
5. [Release 0.3.1. 2024](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.3.1)
6. [Release 0.3.2. 2024](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.3.2)
7. [Release 0.3.3. 2024](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.3.3)
8. [Release 0.3.4. 2024](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.3.4)
9. [Release 0.3.5. 2024](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.3.5)
10. [Release 0.3.6. 2024](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.3.6)
11. [Release 0.3.7. 2024](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.3.7)
12. [Release 0.4.0. 2024](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.4.0)
13. [Release 0.4.1. 2025](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.4.1)
14. [v0.5.0. 2025](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.5.0)
15. [v0.5.1. 2025](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.5.1)
16. [Release 0.5.2. 2025](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.5.2)
17. [Release 0.6.0. 2025](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.6.0)
18. [Release 0.6.1. 2025](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.6.1)
19. [Release 0.6.2. 2025](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.6.2)
20. [Release 0.7.0. 2025](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.7.0)
21. [Release 0.7.1. 2025](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.7.1)
22. [Release 0.8.0. 2025](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.8.0)
23. [Release 0.8.1. 2025](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.8.1)
24. [Release 0.8.2. 2025](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.8.2)
25. [Release 0.8.3. 2025](https://github.com/miracle-wm-org/miracle-wm/releases/tag/v0.8.3)