Mango is a modern, lightweight, high-performance Wayland compositor built on
dwl - crafted for speed, flexibility, and a customizable desktop experience.
Feature Highlights
- 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)
===> The following configuration options are available for mango-0.18.2:
DOCS=on: Build and/or install documentation
===> Use 'make config' to modify these settings
Reason:
To make the configuration format appear more regular, some configuration keys
have now been renamed/duplicated. Please run the following commands to migrate
them globally:
fetch -o migrate-config-keys.sh \
https://github.com/user-attachments/files/33058895/migrate-config-keys.sh
pkg install bash # as root
bash migrate-config-keys.sh -b ~/.config/mango
pkg delete bash # as root, if you no longer need the bash program
Reason:
Version 16.0.3 has some breaking changes. More details at these addresses:
1. https://github.com/mangowm/mango/releases/tag/0.15.0
2. https://github.com/mangowm/mango/releases/tag/0.15.5
3. https://github.com/mangowm/mango/releases/tag/0.16.0
4. https://github.com/mangowm/mango/releases/tag/0.16.1
5. https://github.com/mangowm/mango/releases/tag/0.16.3
Besides, it is not compatible with x11/waybar v. 0.15.0, so, if you use it,
you have to consider (temporarily) other alternatives like x11/sfwbar or
x11/mangobar, while waiting for a new version of waybar to be released.
2026-06-09
Affects: users of x11-wm/mango
Author: nivit@FreeBSD.org
Reason:
Version 0.14.0 of Mango has some breaking changes:
- IPC Protocol Upgrade: The old dwl IPC protocol is now deprecated and will
be removed in the next version.
- Socket Restructuring: mmsg(1) now restricts the use of independent sockets.
This structural change delivers a more powerful, concise, and reliable
syntax, allowing you to seamlessly retrieve data for all clients, tags,
monitors, and messages.
As a result, you must adapt any script that uses the mmsg(1) command to
the new syntax.
