0. Replace the path from the commands bellow with the path of where you cloned this repo.
1. Open configuration.nix and add the following line to your systemPackages:

(pkgs.callPackage /home/beamy/mangowm/mango.nix {})

2. Add this to the bottom:

services.displayManager.sessionPackages = [ (pkgs.callPackage /home/beamy/mangowm/mango.nix {}) ];

3. Run nixos-rebuild switch and thats it

Run this in the cloned folder:

git fetch origin main && git reset --hard origin/main

Then just nixos-rebuild switch

Mango Wayland Compositor

A fast, feature-rich Wayland compositor built on dwl

See all layouts in action at mangowm.github.io

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

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.

yay -S mangowm-git

• 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

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

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

Join us on Discord

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

dl09r

tonybanters

vinthara

Crypto donations accepted:

Network: BEP20 (BSC) Address: 0xf9cda472f2556671d2504afc4c35340ec5615da1