Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

mango

MangoWC (mango) is a Wayland compositor descended from dwl, with several layouts (tiling, scrolling, dwindle and more), an overview of all windows, animations and numbered tags as workspaces. It is configured with one text file.

Login screengreetd
Terminalkitty
BarWaybar
Launchersfuzzel, nwggrid, d77run
Notificationsdunst
Lock screenswaylock, with Super + T or after 5 minutes idle; screen off after 10

Where to change things

WhatFile
keys, programs started with the session, keyboard, layouts, look~/.config/mango/config.conf
environment variables~/.config/mango/env.conf
the bar~/.config/waybar/
fuzzel launcher and power menu~/.config/fuzzel/

Programs started with the session are the exec_once= lines. Press Super + R after saving to reload the configuration. The originals are in /etc/skel/.config/mango/.

Keys

Most actions use Alt; workspace and session actions use Super.

KeysAction
Alt + Returnterminal
Alt + Spacefuzzel (application launcher)
Alt + Nnwggrid (application grid)
Alt + Rd77run
Alt + Qclose window
Alt + Zdrop-down (scratchpad)
Alt + Taboverview of all windows
Alt + Ffull screen
Alt + Amaximize
Alt + \ (backslash)float or tile the window
Alt + arrowsfocus the window in that direction
Super + Shift + arrowsswap with the window in that direction
Super + Tabfocus the next window
Super + Nnext layout
Ctrl + 1 … 9go to tag
Alt + 1 … 9move window to tag
Super + Left / Rightprevious / next tag
Alt + Shift + Left / Rightfocus the monitor on the left / right
Super + left mouse button / right mouse buttonmove / resize a window
Super + Rreload the configuration
Super + Tlock screen
Super + Xpower menu
Super + Mquit mango

Idle

After 5 minutes without input the screen locks, after 10 it turns off and comes back on with any input, and it always locks before the computer suspends. This is the exec_once=swayidle … line in config.conf. Installations made from ISOs built before 16 October 2026 have no lock screen; to add it, install swaylock, swayidle and wlopm and copy that line and the bind=SUPER,t,spawn,swaylock -f line from /etc/skel/.config/mango/config.conf of a newer ISO, or from this page:

exec_once=swayidle -w timeout 300 'swaylock -f' timeout 600 "wlopm --off '*'" resume "wlopm --on '*'" before-sleep 'swaylock -f'
bind=SUPER,t,spawn,swaylock -f

Keyboard layout

In config.conf:

xkb_rules_layout=pt

Wallpaper

The line exec_once=swaybg -i Wallpaper/d77void_2560x1600.png -m fill sets it at start-up; change the file name to another image in ~/Wallpaper/.