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
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
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
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:
Crypto donations accepted:
Network: BEP20 (BSC)
Address: 0xf9cda472f2556671d2504afc4c35340ec5615da1
|
|
评论