Mango Wayland Compositor

A fast, feature-rich Wayland compositor built on dwl

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

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
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

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

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

Thanks to everyone who has sponsored this project:

_tonybanters

Crypto donations accepted:

Network: BEP20 (BSC)
Address: 0xf9cda472f2556671d2504afc4c35340ec5615da1

4.4 KiB Raw Blame History