MangoWM

Mango is a modern, lightweight, high-performance tiling Wayland compositor built on dwl — crafted for speed, flexibility, and a customizable desktop experience.

Installation

Install the mangowm package.

Starting

Select Mango from the menu in a display manager or run mango from a tty.

LXQT

See LXQt#Wayland session.

Configuration

The system-wide mango configuration file is /etc/mango/config.conf while user configuration is ~/.config/mango/config.conf:

Creating the configuration file

First, run the following to create the directory needed in the next step:

$ mkdir -p ~/.config/mango/

Whenever started, mango will attempt to use whatever custom settings are contained in ~/.config/mango/config.conf, then fall back to /etc/mango/config.conf. The user configuration file is not created by default, so copy the template file:

$ cp /etc/mango/config.conf ~/.config/mango/

Autostart

Adding exec-once or exec commands in configuration file can execute a command or script at startup. For example:

exec-once=waybar

exec=bash ~/.config/mango/reload-settings.sh

exec-once command runs only once when mango starts.

exec command runs every time the config is reloaded.

Screen sharing

To setup PipeWire screen sharing install the xdg-desktop-portal-wlr package.

If the portal does not start automatically try autostarting /usr/lib/xdg-desktop-portal-wlr.

Troubleshooting

Fixing misbehaving Java applications

See Java#Gray window, applications not resizing with WM, menus immediately closing.