wayland compositor base wlroots and scenefx(dwl but no suckless)
Find a file
2026-05-12 09:46:10 +08:00
.github fix: simplify sync commit message to use source URL only 2026-03-15 20:53:28 +08:00
assets docs: improve sponsor section 2026-05-11 15:03:02 +08:00
docs update docs 2026-05-11 17:50:07 +08:00
mmsg refactor(mmsg): simplify dispatch arguments parsing 2026-04-11 07:01:49 +08:00
nix Sets default for addLoginEntry correctly 2026-05-11 13:45:33 +08:00
protocols Fix wayland protocol directory variable retrieval 2026-02-15 19:15:08 +08:00
src feat(window_rule): support width/height as fractions in window rules. 2026-05-12 09:46:10 +08:00
.clang-format format code index to tab no space 2025-06-07 14:40:13 +08:00
.gitignore change: change project name to mango 2025-08-27 09:42:00 +08:00
flake.lock Updated flake.lock nixpkgs input 2026-05-11 13:25:38 +08:00
flake.nix nix: bump scenefx flake and fix build 2025-11-09 18:13:58 +08:00
format.sh project: merge mmsg meson.build file into mango meson.build 2025-10-19 18:14:18 +08:00
LICENSE change: change project name to mango 2025-08-27 09:42:00 +08:00
LICENSE.dwl add dwl license 2025-02-28 21:54:18 +08:00
LICENSE.dwm init 2025-02-03 23:18:47 +08:00
LICENSE.sway init 2025-02-03 23:18:47 +08:00
LICENSE.tinywl init 2025-02-03 23:18:47 +08:00
LICENSE.wlroots comment: Add a reference declaration 2025-08-27 09:42:01 +08:00
mangowm.scm fix(guix): pin wlroots version 2026-04-05 18:44:05 +08:00
meson.build bump version to 0.12.9 2026-04-24 11:03:17 +08:00
meson_options.txt feat: make asan as the debug type feature 2025-08-27 09:42:01 +08:00
README.md update readme 2026-05-11 16:17:10 +08:00

Mango Logo

Mango Wayland Compositor

A fast, feature-rich Wayland compositor built on dwl

Stars License Packaged in Discord


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

Packaging status

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

Sponsor

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

Thanks to everyone who has sponsored this project:


tonybanters

vinthara

Crypto donations accepted:

Network: BEP20 (BSC)
Address: 0xf9cda472f2556671d2504afc4c35340ec5615da1
sponsor QR