---

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

https://github.com/user-attachments/assets/be85e13f-7798-456d-957e-f8931687392e

See all layouts in action at mangowm.github.io

Why Mango?

• Lightweight & fast — 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, vertical-scroller, master-stack, monocle, dwindle and more
• Rich window states — swallow, group, minimize, maximize, global, overlay, fakefullscreen
• Window effects — blur, shadow, corner radius, opacity (via scenefx)
• Excellent input method support — text-input v2/v3
• Powerful scratchpad — sway-style scratchpad, special workspace and named-scratchpad support
• label jump overview — see all windows at a glance with easymotion jump label.
• Gnome-style application switcher — quick switching between apps
• 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.

AI Policy

• Pull requests: AI may be used to assist in preparing a pull request (PR), but direct AI-generated PRs are not accepted. Contributors must clearly understand what the code does, whether the implementation is reasonable and rigorous, whether it wastes resources, and whether the implementation is sufficiently convergent rather than scattered.

• Bug reports: Using AI to report bugs is acceptable. AI-provided information may serve as reference material, which is preferable to reports that provide no reference information.

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:

dl09r

tonybanters

vinthara

stepbrobd

Crypto donations accepted:

Network: BEP20 (BSC) Address: 0xf9cda472f2556671d2504afc4c35340ec5615da1