---
https://github.com/user-attachments/assets/bb83004a-0563-4b48-ad89-6461a9b78b1f
> See all layouts in action at [mangowm.github.io](https://mangowm.github.io/)
## Why Mango?
Mango starts where dwl ends. It keeps the lightweight, fast-build philosophy while adding the features that make a compositor actually usable day-to-day — without the bloat.
- **Lightweight & fast** — as lean as dwl, builds in seconds, no functionality compromised
- **Excellent xwayland support** — run X11 apps without friction
- **Tags, not workspaces** — each tag maintains its own independent window layout
- **Smooth animations** — window open/move/close, tag transitions, layer surfaces
- **Flexible layouts** — scroller, master-stack, monocle, dwindle, grid, and more
- **Rich window states** — swallow, minimize, maximize, global, overlay, fakefullscreen
- **Window effects** — blur, shadow, corner radius, opacity (via scenefx)
- **Excellent input method support** — text-input v2/v3
- **Sway-like scratchpad** — named scratchpad support included
- **Hycov-style overview** — see all windows at a glance
- **IPC** — send/receive messages from external programs
- **Hot-reload config** — no restart needed for keybinding changes
- **Zero flickering** — every frame is correct
## Vision
**Stability first.** After months of testing, Mango is solid enough for daily use. Breaking changes will be minimal.
**Practicality over novelty.** Features get added when they genuinely improve daily workflows — not for the sake of completeness.
**Focused scope.** Niche requests are evaluated by community interest. Significant upvotes move things forward.
## Installation
[](https://repology.org/project/mangowm/versions)
### Arch Linux
```bash
yay -S mangowm-git
```
### Other distributions
See the [Installation Guide](https://mangowm.github.io/docs/installation) for Fedora, Gentoo, Guix, NixOS, openSUSE, PikaOS, AerynOS, and building from source.
## Documentation
- **[mangowm.github.io](https://mangowm.github.io/)** — website docs with configuration reference, keybindings, layouts, IPC, and more
- **[GitHub Wiki](https://github.com/mangowm/mango/wiki/)** — community-maintained wiki
## Community
Join us on **[Discord](https://discord.gg/CPjbDxesh5)**
## Acknowledgements
- [wlroots](https://gitlab.freedesktop.org/wlroots/wlroots) — Wayland protocol implementation
- [dwl](https://codeberg.org/dwl/dwl) — the foundation Mango builds on
- [scenefx](https://github.com/wlrfx/scenefx) — window effects library
- [owl](https://github.com/dqrk0jeste/owl) — animation groundwork
- [sway](https://github.com/swaywm/sway) — protocol reference
## Sponsor
If Mango makes your desktop better, consider supporting its development.
Thanks to everyone who has sponsored this project:
