home/.config/mango/README.md

336 lines
18 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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