Mangowc

Resources

MangoWC is a Wayland Compositor based on wlroots and scenefx.

Installation

Note
MangoWC and its dependency SceneFX are available in the GURU repository. Before proceeding with the installation, ensure this repository has been enabled on the system. Instructions for setting up GURU can be found at GURU setup page.

First, unmask MangoWC and SceneFX:

FILE /etc/portage/package.accept_keywords/mango

gui-wm/mangowc **
gui-libs/scenefx **

Emerge MangoWC:

root #emerge --ask gui-wm/mangowc

Usage

Invocation

To start Mango on systemd:

user $mango

To start Mango under OpenRC:

user $dbus-run-session mango

Configuration

Copy the default configuration file to the user directory:

user $

mkdir -p ~/.config/mango/

user $

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

Terminal emulator

By default, the MangoWC configuration file uses gui-apps/foot as the terminal emulator. It is recommended to install this terminal emulator to ensure a terminal will be available once MangoWC is running:

root #emerge --ask gui-apps/foot

Tip
Other popular options include x11-terms/alacritty or x11-terms/kitty, which are GPU-accelerated and work natively with Wayland.

Launcher

By default, the MangoWC configuration file uses x11-misc/rofi as the application launcher. It is recommended to install this launcher to ensure that programs can be opened when MangoWC is running.

root #emerge --ask x11-misc/rofi

Tip
gui-apps/wofi is a popular option as a launcher.

Essential Keybindings

Alt+Return = Open Terminal (defaults to gui-apps/foot).
Alt+Space = Open Launcher (defaults to x11-misc/rofi).
Alt+Q = Close (Kill) the active window.
Super+M = Quit MangoWC.
Super+F = Toggle Fullscreen.
Ctrl+1-9 = Switch to Tag 1-9.
Alt+1-9 = Move window to Tag 1-9.