---

https://github.com/user-attachments/assets/bb83004a-0563-4b48-ad89-6461a9b78b1f

https://github.com/user-attachments/assets/f6af5b70-0f2e-4ef3-ba40-349e8666fc9d

See all layouts in action at 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(Supports scale without blurring)
• 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

Arch Linux

yay -S mangowm-git

use my config

• install dependencies

yay -S rofi foot xdg-desktop-portal-wlr swaybg waybar wl-clip-persist cliphist wl-clipboard wlsunset xfce-polkit swaync pamixer wlr-dpms sway-audio-idle-inhibit-git swayidle dimland-git brightnessctl swayosd wlr-randr grim slurp satty swaylock-effects-git wlogout sox

• clone config

git clone https://github.com/DreamMaoMao/mango-config.git ~/.config/mango

Other distributions

See the Installation Guide for Fedora, Gentoo, Guix, NixOS, openSUSE, PikaOS, AerynOS, and building from source.

Documentation

• mangowm.github.io — website docs with configuration reference, keybindings, layouts, IPC, and more
• GitHub Wiki — community-maintained wiki

Community

Join us on Discord

Acknowledgements

• wlroots — Wayland protocol implementation
• dwl — the foundation Mango builds on
• scenefx — window effects library
• owl — animation groundwork
• sway — protocol reference

Sponsor

If Mango makes your desktop better, consider supporting its development.

Thanks to everyone who has sponsored this project:

Crypto donations accepted: