mangowm / mango

Mango Wayland Compositor This project's development is based on dwl. • **Lightweight & Fast Build** • _Mango_ is as lightweight as _dwl_, and can be built completely within a few seconds. Despite this, _Mango_ does not compromise on functionality. • **Feature Highlights** • In addition to basic WM functionality, Mango provides: • Excellent xwayland support. • Base tags not workspaces (supports separate window layouts for each tag) • Smooth and customizable complete animations (window open/move/close, tag enter/leave,layer open/close/move) • Excellent input method support (text input v2/v3) • Flexible window layouts with easy switching (scroller, master-stack, monocle,center-master, etc.) • Rich window states (swallow, minimize, maximize, unglobal, global, fakefullscreen, overlay, etc.) • Simple yet powerful external configuration(support shortcuts hot-reload) • Sway-like scratchpad and named scratchpad • Ipc support(get/send message from/to compositor by external program) • Hycov-like overview • Window effects from scenefx (blur, shadow, corner radius, opacity) • Zero flickering - every frame is perfect. https://github.com/user-attachments/assets/bb83004a-0563-4b48-ad89-6461a9b78b1f Mango's Vision **Mango's primary goal is stability**: After months of testing and development—and aside from a few lingering GPU compatibility issues—it should now be stable enough. I don't plan on making many breaking changes. **Mango's preference is practicality**: I tend to add features that genuinely help with daily workflows—things that make our work more convenient. **Mango won't cater to every user preference**: For niche feature requests, I'll take a wait-and-see approach. I'll only consider adding them if they get a significant number of upvotes. Our discord mangowm Supported layouts • tile • scroller • monocle • grid • deck • center_tile • vertical_tile • vertical_grid • vertical_scroller • tgmix Installation Dependencies • wayland • wayland-protocols • libinput • libdrm • libxkbcommon • pixman • libdisplay-info • libliftoff • hwdata • seatd • pcre2 • xorg-xwayland • libxcb Arch Linux The package is in the Arch User Repository and is available for manual download here or through a AUR helper like yay: Gentoo Linux The package is in the community-maintained repository called GURU. First, add GURU repository: Then, add and to the . Finally, install the package: Fedora Linux The package is in the third-party Terra repository. First, add the Terra Repository. Then, install the package: Guix System The package definition is described in the source repository. First, add channel to file: Then, run and after update you can either run or add it to your configuration via: And then rebuild your system. Other Suggested Tools Hybrid component • dms-shell Independent component • Application launcher (rofi, bemenu, wmenu, fuzzel) • Terminal emulator (foot, wezterm, alacritty, kitty, ghostty) • Status bar (waybar, eww, quickshell, ags), waybar is preferred • Wallpaper setup (swww, swaybg) • Notification daemon (swaync, dunst,mako) • Desktop portal (xdg-desktop-portal, xdg-desktop-portal-wlr, xdg-desktop-portal-gtk) • Clipboard (wl-clipboard, wl-clip-persist, cliphist) • Gamma control/night light (wlsunset, gammastep) • Miscellaneous (xfce-polkit, wlogout) Some Common Default Keybindings • alt+return: open foot terminal • alt+space: open rofi launcher • alt+q: kill client • alt+left/right/up/down: focus direction • super+m: quit mango My Dotfiles Daily • Dependencies Dms • Dependencies • use my dms config • use my daily config Config Documentation Refer to the repo wiki wiki or the website docs docs NixOS + Home-manager The repo contains a flake that provides a NixOS module and a home-manager module for mango. Use the NixOS module to install mango with other necessary components of a working Wayland environment. Use the home-manager module to declare configuration and autostart for mango. Here's an example of using the modules in a flake: Packaging mango To package mango for other distributions, you can check the reference setup for: • nix • arch. • gentoo You might need to package for your distribution, check availability here. If you encounter build errors when packaging , feel free to create an issue and ask a question, but Read The Friendly Manual on packaging software in your distribution first. Thanks to These Reference Repositories • https://gitlab.freedesktop.org/wlroots/wlroots - Implementation of Wayland protocol • https://github.com/dqrk0jeste/owl - Basal window animation • https://codeberg.org/dwl/dwl - Basal dwl feature • https://github.com/swaywm/sway - Sample of Wayland protocol • https://github.com/wlrfx/scenefx - Make it simple to add window effect. Sponsor At present, I can only accept sponsorship through an encrypted connection. If you find this project helpful to you, you can offer sponsorship in the following ways. Thanks to the following friends for their sponsorship of this project @tonybanters