Added some basic mangowm configuration.

This commit is contained in:
Johannes Findeisen 2026-11-19 18:36:16 +01:00
commit 8ecd3e9447
16 changed files with 1532 additions and 0 deletions

336
.config/mango/README.md Normal file
View file

@ -0,0 +1,336 @@
# 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.
![mangoprint.jpg](mangoprint.jpg)
## 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)