336 lines
18 KiB
Markdown
336 lines
18 KiB
Markdown
# Armin's MangoWM (MangoWC) Config
|
||
|
||
My personal config for **[MangoWM](https://github.com/DreamMaoMao/mango/)** (also known as MangoWC) - a Wayland compositor built on `wlroots`. This setup tries to replicate my custom **DWM (Dynamic Window Manager)** workflow (including most of my custom keybinds) onto Wayland, bringing that keyboard-driven tiling window experience I've been living in for MANY years to the modern world.
|
||
|
||

|
||
|
||
## The big idea: DWM for Wayland, but make it bling
|
||
|
||
[DWM](https://dwm.suckless.org/) is an absolute legend in the Unix world. Seriously minimalist, dynamic tiling, almost entirely keyboard-driven via **Alt (Mod1)** or **Super (Win)**. It basically invented the **master-stack** layout - a big "master" zone on the left, a "stacking" zone on the right. DWM also gave us **tags** (virtual desktops you flip through with `Mod+1..9`), **scratchpads**, and a whole "do one thing well" ethos for window management.
|
||
|
||
**MangoWM** is the closest thing to a spiritual DWM successor on Wayland. MangoWM just tries to stay out of your way. This config pushes it into DWM-replacement territory for me: basically every keybind I've accumulated over the last ~7-8 years is here. Master resize (`Alt+h/l`), stack navigation (`Alt+j/k`), tag-based window wrangling (`Alt+Shift+1..9`). All that muscle memory transfers one-to-one, but now finally with those cool Wayland goodies: **tearing-free rendering, per-display fractional scaling, proper hardware cursor support, seamless GPU integration, no screen-tearing.**
|
||
|
||
If you're coming from Xorg and want a Wayland compositor that feels like DWM instead of i3 or Sway - then Mango might be worth an evening of fiddling.
|
||
|
||
## Color scheme: NORD
|
||
|
||
Colors follow the awesome [NORD palette](https://www.nordtheme.com/) by [Arctic Ice Studio](https://github.com/arcticicestudio/nord). I've been switching forth and back in terms of color palettes, but NORD is one I come back to on a regular basis.
|
||
|
||
- **High contrast, but low harshness** - Polar Night backgrounds + Snow Storm foregrounds = readable even after 12-hour coding sessions.
|
||
- **Frost accents** - the Frost biome (`#8FBCBB`, `#88C0D0`, `#81A1C1`, `#5E81AC`) gives us four distinct accent tones for focused windows, borders, UI elements.
|
||
- **Aurora for attention** - the Aurora biome (`#BF616A`, `#D08770`, `#EBCB8B`, `#A3BE8C`, `#B48EAD`) handles urgency, maximize, and split indicators without some too distracting visual clashing.
|
||
|
||
| Token | Hex | NORD Definition |
|
||
|---------------------|-----------|-------------------------------|
|
||
| Root background | `#2E3440` | `nord0` - Polar Night |
|
||
| Borders (inactive) | `#4C566A` | `nord3` - Polar Night lighter |
|
||
| Focused border | `#5E81AC` | `nord10` - Frost |
|
||
| Split indicator | `#BF616A` | `nord11` - Aurora red |
|
||
| Maximize indicator | `#A3BE8C` | `nord14` - Aurora green |
|
||
| Urgency | `#BF616A` | `nord11` - Aurora red |
|
||
| Scratchpad border | `#81A1C1` | `nord9` - Frost |
|
||
|
||
Links: [Nord Homepage](https://www.nordtheme.com/) · [Nord Docs](https://www.nordtheme.com/docs) · [Nord Ports](https://www.nordtheme.com/ports)
|
||
|
||
## Built on
|
||
|
||
- **Fedora 44**, May 2026
|
||
- **MangoWM** (git main)
|
||
- **Wayland** (wlroots-based)
|
||
|
||
## Keybindings
|
||
|
||
Modifier key is **Alt** (a.k.a. Mod1 in X11). Every binding has its DWM equivalent listed so you can cross-reference.
|
||
|
||
### General
|
||
|
||
| Binding | DWM Equivalent | Action |
|
||
|-------------------------|-----------------------|------------------------------------------------------|
|
||
| `Alt + Shift + r` | `Mod + Shift + r` | **Reload config** - hot-reloads `config.conf` without restarting. |
|
||
| `Alt + Shift + q` | `Mod + Shift + q` | **Quit** MangoWM entirely. |
|
||
| `Alt + Ctrl + Backspace`| `Ctrl + Alt + Bksp` | Secondary quit (classic Xorg muscle memory). |
|
||
|
||
### Application launcher
|
||
|
||
| Binding | DWM Equivalent | Action |
|
||
|-------------------------|-----------------------|------------------------------------------------------|
|
||
| `Alt + space` | - | **Launch wofi** app runner (drun mode). |
|
||
| `Alt + Shift + d` | - | **Launch wofi** (alternative binding). |
|
||
| `Alt + Return` | `Mod + Return` | **Spawn foot terminal** - the main terminal emulator. |
|
||
|
||
### Tag / workspace navigation
|
||
|
||
Tags = DWM's name for virtual desktops. 9 numbered tags plus a "view all" tag.
|
||
|
||
| Binding | DWM Equivalent | Action |
|
||
|-------------------------|-----------------------|------------------------------------------------------|
|
||
| `Alt + 1` through `9` | `Mod + 1..9` | **Switch to tag N** - views that tag. |
|
||
| `Alt + 0` | `Mod + 0` | **View all tags** - shows every window everywhere (handy for overview). |
|
||
| `Alt + p` | - | **Previous tag** - cycles to the tag on the left. |
|
||
| `Alt + n` | - | **Next tag** - cycles to the tag on the right. |
|
||
| `Alt + ScrollUp` | - | **Scroll to previous tag** - scroll on desktop bg. |
|
||
| `Alt + ScrollDown` | - | **Scroll to next tag** - same deal, opposite direction. |
|
||
|
||
### Moving windows between tags
|
||
|
||
| Binding | DWM Equivalent | Action |
|
||
|-------------------------|-----------------------|------------------------------------------------------|
|
||
| `Alt + Shift + 1..9` | `Mod + Shift + 1..9` | **Move focused client to tag N and follow** - teleports the active window there and switches to it. |
|
||
| `Alt + Shift + Left` | `Mod + Shift + Left` | **Move client to tag on the left** (`tagtoleft`). |
|
||
| `Alt + Shift + Right` | `Mod + Shift + Right`| **Move client to tag on the right** (`tagtoright`). |
|
||
|
||
### Multi-monitor
|
||
|
||
| Binding | DWM Equivalent | Action |
|
||
|-------------------------|-----------------------|------------------------------------------------------|
|
||
| `Alt + Shift + ,` | `Mod + Shift + ,` | **Send client to monitor on the left** (`tagmon`). |
|
||
| `Alt + Shift + .` | `Mod + Shift + .` | **Send client to monitor on the right** (`tagmon`). |
|
||
| `Alt + Shift + -` | - | **Send client to next monitor and follow** (cycles monitors in list order, wrapping). |
|
||
|
||
### Focus & stack navigation
|
||
|
||
DWM's `j`/`k` stack traversal and `Tab` cycling, all here.
|
||
|
||
| Binding | DWM Equivalent | Action |
|
||
|-------------------------|-----------------------|------------------------------------------------------|
|
||
| `Alt + j` | `Mod + j` | **Focus next window** in the stack (down). |
|
||
| `Alt + k` | `Mod + k` | **Focus previous window** in the stack (up). |
|
||
| `Alt + Tab` | `Mod + Tab` | **Focus next** (wraps around). |
|
||
| `Alt + Shift + Tab` | `Mod + Shift + Tab` | **Focus previous** (wraps around). |
|
||
|
||
### Directional focus
|
||
|
||
For moving focus in cardinal directions - handy in floating or non-linear tiling layouts.
|
||
|
||
| Binding | Action |
|
||
|-------------------------|------------------------------------------------------|
|
||
| `Alt + Left` | **Focus window to the left**. |
|
||
| `Alt + Right` | **Focus window to the right**. |
|
||
| `Alt + Up` | **Focus window above**. |
|
||
| `Alt + Down` | **Focus window below**. |
|
||
|
||
### Moving windows in stack
|
||
|
||
| Binding | DWM Equivalent | Action |
|
||
|-------------------------|-----------------------|------------------------------------------------------|
|
||
| `Alt + Shift + j` | `Mod + Shift + j` | **Move window down** in stack order. |
|
||
| `Alt + Shift + k` | `Mod + Shift + k` | **Move window up** in stack order. |
|
||
|
||
### Master area management
|
||
|
||
Classic DWM master-stack layout: master zone on the left, stack zone on the right.
|
||
|
||
| Binding | DWM Equivalent | Action |
|
||
|-------------------------|-----------------------|------------------------------------------------------|
|
||
| `Alt + h` | `Mod + h` | **Shrink master area** by 5% (`mfact -0.05`). |
|
||
| `Alt + l` | `Mod + l` | **Grow master area** by 5% (`mfact +0.05`). |
|
||
| `Alt + u` | `Mod + u` | **Increase number of masters** (`nmaster +1`). |
|
||
| `Alt + i` | `Mod + i` | **Decrease number of masters** (`nmaster -1`). |
|
||
|
||
### Window resize (floating)
|
||
|
||
| Binding | DWM Equivalent | Action |
|
||
|-------------------------|-----------------------|------------------------------------------------------|
|
||
| `Alt + Shift + h` | - | **Resize floating window left** by 10px. |
|
||
| `Alt + Shift + l` | - | **Resize floating window right** by 10px. |
|
||
|
||
### Gaps
|
||
|
||
| Binding | DWM Equivalent | Action |
|
||
|-------------------------|-----------------------|------------------------------------------------------|
|
||
| `Alt + Ctrl + j` | `Mod + Ctrl + j` | **Decrease inner gaps** by 1px. |
|
||
| `Alt + Ctrl + k` | `Mod + Ctrl + k` | **Increase inner gaps** by 1px. |
|
||
|
||
### Layout cycling
|
||
|
||
| Binding | DWM Equivalent | Action |
|
||
|-------------------------|-----------------------|------------------------------------------------------|
|
||
| `Alt + ,` (comma) | - | **Previous layout** - cycles backward through tile, scroller, grid, deck, monocle, center_tile, vertical_tile, vertical_scroller. |
|
||
| `Alt + .` (period) | - | **Next layout** - cycles forward through the same list. |
|
||
|
||
### Floating / scratchpad
|
||
|
||
| Binding | DWM Equivalent | Action |
|
||
|-------------------------|-----------------------|------------------------------------------------------|
|
||
| `Alt + Shift + space` | `Mod + Shift + space` | **Toggle floating** - switches window between tiled and floating mode. |
|
||
| `Alt + grave` | `Mod + grave` | **Toggle scratchpad** - opens/closes a persistent scratchpad terminal (floating, centered, great for quick commands). |
|
||
|
||
### Killing windows
|
||
|
||
| Binding | DWM Equivalent | Action |
|
||
|-------------------------|-----------------------|------------------------------------------------------|
|
||
| `Alt + x` | `Mod + x` | **Kill focused client** - sends a close signal. |
|
||
| `Alt + Shift + x` | `Mod + Shift + x` | **Force kill focused client** (same effect in Mango).|
|
||
|
||
### System control
|
||
|
||
| Binding | Action |
|
||
|-------------------------|------------------------------------------------------|
|
||
| `Alt + Ctrl + l` | **Lock screen** - invokes `swaylock`. |
|
||
| `Alt + Ctrl + Up` | **Increase brightness** - via `xbacklight`. |
|
||
| `Alt + Ctrl + Down` | **Decrease brightness** - via `xbacklight`. |
|
||
| `Alt + Ctrl + Right` | **Volume up** - invokes `scripts/vol +10`. |
|
||
| `Alt + Ctrl + Left` | **Volume down** - invokes `scripts/vol -10`. |
|
||
|
||
### Screenshots
|
||
|
||
| Binding | Action |
|
||
|-------------------------|------------------------------------------------------|
|
||
| `Alt + Shift + s` | **Screenshot region** - interactive area selection. |
|
||
| `Alt + Ctrl + s` | **Screenshot full** - captures all monitors. |
|
||
|
||
### Mouse
|
||
|
||
| Binding | Action |
|
||
|--------------------------------------|------------------------------------------------------|
|
||
| `Alt + Left-click` | **Move window** - drag to reposition (works on any client, tiled included). |
|
||
| `Alt + Right-click` | **Resize window** - drag to resize. |
|
||
|
||
## Animation & visual config
|
||
|
||
MangoWM supports per-action animations with configurable curves and durations. This config enables smooth **slide** transitions for window open/close and **horizontal tag switching**. Key parameters:
|
||
|
||
| Parameter | Value | Effect |
|
||
|-------------------------------------|----------|-----------------------------------------------------|
|
||
| `animation_duration_*` | 250ms | All animations in a quarter-second - fast enough to be useful, slow enough to feel polished. |
|
||
| `animation_curve_open` | `0.46,1,0.29,1` | Ease-out cubic bezier - windows "settle" into place. |
|
||
| `animation_curve_close` | `0.08,0.92,0,1` | Ease-in cubic bezier - windows fade out snappy. |
|
||
| `blur` | On | Background blur with 5px radius, subtle noise, brightness/contrast tweaks for transparent surface readability. |
|
||
| `shadows` | On (floating only) | Drop shadows on floating windows only - tiled windows stay flat, keeping DWM's no-nonsense look. |
|
||
| `border_radius` | 6px | Rounded corners on all windows for a modern, polished feel. |
|
||
|
||
## Supported layouts
|
||
|
||
The default is DWM's classic `tile` layout on all 9 tags, but MangoWM comes with more layouts you can flip through with `Alt + ,` and `Alt + .`:
|
||
|
||
- **tile** - The classic DWM master-stack. Master left, stack right.
|
||
- **scroller** - Horizontal scrolling layout; windows laid out left-to-right with focus-on-scroll.
|
||
- **grid** - All windows in an equally-sized grid.
|
||
- **deck** - Only the focused window fully visible; the rest stack like a deck of cards (monocle with previews).
|
||
- **monocle** - All windows maximized; only the focused one visible; `Alt+j/k` cycles through them.
|
||
- **center_tile** - Master centered instead of left-aligned.
|
||
- **vertical_tile** - Master on top, stack below (classic tile flipped).
|
||
- **vertical_scroller** - Scrollable vertical layout with a master area.
|
||
|
||
## Monitor setup
|
||
|
||
This config targets the 2x 4k 32" dual-monitor setup of my Fedora desktop machine:
|
||
|
||
| Monitor | Resolution | Scale | Position |
|
||
|---------|--------------------|-------|-------------|
|
||
| DP-2 | 3840×2160 (4K) | 1.5 | `x:0, y:0` (left) |
|
||
| DP-1 | 3840×2160 (4K) | 1.5 | `x:2560, y:0` (right - the offset accounts for 2560px effective width at 1.5× scale) |
|
||
|
||
Both monitors are 4K at 1.5× fractional scaling, giving a comfy 2560×1440 logical resolution. The `x:2560` offset on DP-1 lines things up right at scaled resolutions.
|
||
|
||
> Tip: `find . | less` in this repo to poke around the file tree.
|
||
|
||
## Requirements
|
||
|
||
- **MangoWM** - built from source: https://github.com/DreamMaoMao/mango/
|
||
- **Wayland session** - Fedora 44 (or any distro with a modern wlroots stack)
|
||
- **waybar** - status bar
|
||
- **wofi** - app launcher
|
||
- **foot** - terminal emulator
|
||
- **swaybg** - wallpaper
|
||
- **grim / slurp** - screenshots
|
||
- **swaylock** - screen locking (optional)
|
||
- **xbacklight** - backlight control (optional, probably only makes sense with acpilight)
|
||
|
||
## Installation
|
||
|
||
### Fedora
|
||
|
||
MangoWM is available via the [Terra](https://terra.fyralabs.com/) repo and a [COPR](https://copr.fedorainfracloud.org/coprs/dennemann/MangoWC/):
|
||
|
||
```bash
|
||
# Terra repo (recommended)
|
||
sudo dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terra$releasever' terra-release
|
||
sudo dnf install mangowm
|
||
|
||
# COPR (alternative)
|
||
sudo dnf copr enable denneman/MangoWC
|
||
sudo dnf install mangowm
|
||
```
|
||
|
||
### Arch Linux
|
||
|
||
In the AUR - stable and git variants:
|
||
|
||
| Package | Type |
|
||
|---------|------|
|
||
| `mangowm` | AUR (stable release) |
|
||
| `mangowm-git` | AUR (git master) |
|
||
|
||
```bash
|
||
yay -S mangowm # stable release
|
||
yay -S mangowm-git # git version (latest)
|
||
```
|
||
|
||
[ArchWiki page](https://wiki.archlinux.org/title/MangoWM) has detailed setup guides.
|
||
|
||
### Debian / Ubuntu
|
||
|
||
No official packages yet. Build from source:
|
||
|
||
```bash
|
||
sudo apt install git meson ninja-build libwayland-dev wayland-protocols \
|
||
libinput-dev libdrm-dev libxkbcommon-dev libpixman-1-dev \
|
||
libdisplay-info-dev libliftoff-dev hwdata libpcre2-dev libxcb-dev \
|
||
libxcb-util-dev seatd xwayland
|
||
git clone https://github.com/DreamMaoMao/mango.git
|
||
cd mango
|
||
meson setup build --prefix=/usr --buildtype=release
|
||
ninja -C build
|
||
sudo ninja -C build install
|
||
```
|
||
|
||
### Void Linux
|
||
|
||
Available in the main repo:
|
||
|
||
```bash
|
||
sudo xbps-install mangowc
|
||
```
|
||
|
||
### Other distributions
|
||
|
||
| Distribution | Package | Source |
|
||
|---|---|---|
|
||
| **Alpine Linux** | `mangowc` | edge/community |
|
||
| **Gentoo** | `gui-wm/mangowm` | GURU overlay |
|
||
| **NixOS** | `mangowm` | Flake with NixOS module |
|
||
| **openSUSE** | `mangowc-git` | OBS `home:darix:playground` |
|
||
| **FreeBSD** | `x11-wm/mangowc` | FreshPorts |
|
||
|
||
### Build from source (universal)
|
||
|
||
Deps: `meson`, `ninja`, `wayland`, `wayland-protocols`, `libinput`, `libdrm`, `libxkbcommon`, `pixman`, `libdisplay-info`, `libliftoff`, `hwdata`, `seatd`, `pcre2`, `xwayland`, `libxcb`
|
||
|
||
```bash
|
||
git clone https://github.com/DreamMaoMao/mango.git
|
||
cd mango
|
||
meson setup build --prefix=/usr --buildtype=release
|
||
ninja -C build
|
||
sudo ninja -C build install
|
||
```
|
||
|
||
### Installing this config
|
||
|
||
```bash
|
||
git clone https://github.com/armin/mango-config.git
|
||
cd mango-config
|
||
# Symlink or copy the config to MangoWM's config directory:
|
||
# mkdir -p ~/.config/mangowm
|
||
# ln -sf "$(pwd)/config.conf" ~/.config/mangowm/config.conf
|
||
```
|
||
|
||
> **Note:** Adjust paths and deps for your installation. Check the [MangoWM repo](https://github.com/DreamMaoMao/mango/) for the latest build instructions.
|
||
|
||
### IRC
|
||
|
||
So far I'm not aware of some IRC channel for Mango. :-( If you come across one, please let me know. Thank you.
|
||
|
||
## License
|
||
|
||
[MIT](LICENSE)
|