MangoWM - ArchWiki

Jump to content

# MangoWM

From ArchWiki

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 mangowmAUR package.

Alternatively mangowm-wlonly-gitAUR depends on wlroots-gitAUR which supports individual window capture but not scenefx.

## 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

Add an `exec-once` command in `~/.config/mango/config.conf` file to execute a command at startup. For example:

    exec-once=waybar

Using an `exec` command instead will ensure that the command is also run whenever mango is restarted.

### Screen sharing

To setup PipeWire screen sharing install the xdg-desktop-portal-wlr package (or xdg-desktop-portal-wlr-gitAUR for mangowm-wlonly-gitAUR).

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.

## See also

- bemenu - A Wayland native alternative to dmenu.
- An introduction to mango.
- Mango git repository.

Category:

- Wayland compositors

MangoWM
Add topic