Mango Dotfiles

Personal MangoWM dotfiles for Gentoo GNU/Linux.

Quick Install

git clone https://github.com/fxmfxmfx/mango-dotfiles.git
cd mango-dotfiles
./scripts/check-deps.sh
./scripts/install.sh --dry-run
# If your primary output is not DP-1, apply the sed example in docs/customize.md.
# Edit .config/mango/conf.d/00-monitors.conf if your monitor layout differs.
./scripts/install.sh

This repo mirrors $HOME for dot directories such as .config and .local. The installer backs up overwritten files by default and asks whether to install the Graphite GTK theme and Goldy icon theme. The dry run shows what would be copied and whether optional theme/icon installs would use local sources or clone their upstream repositories.

Run Mango from a TTY with:

~/.local/bin/start-mango.sh

The setup is intentionally not distro-neutral. It assumes MangoWM, GNU userland, Wayland tooling and fish as the interactive shell.

Contents

• .config/mango - MangoWM session, monitor rules, key binds and autostart
• .config/yambar - top bar with Mango workspace and keyboard-layout scripts
• .config/foot, .config/fuzzel, .config/dunst - terminal, launcher and notifications
• .config/nvim - Neovim config using lazy.nvim and pinned plugin lockfile
• .config/fish - shell aliases and colors
• .local/bin - helper scripts for screenshots, clipboard, layout, portals, wallpaper and emoji picker
• Wallpaper - wallpapers used by the wallpaper picker
• docs - package list and customization notes for forks
• screenshots - some screenshots

Compatibility Notes

• Monitor config is machine-specific: DP-1 at 1920x1080@170 and HDMI-A-1 at 1920x1080@60. Edit .config/mango/conf.d/00-monitors.conf before using this on another machine. See Mango's monitor docs: mangowm.github.io/docs/configuration/monitors.
• Yambar is pinned to DP-1 in .config/yambar/config.yml. The workspace script can read YAMBAR_MANGO_OUTPUT, but the bar config and click actions still need edits if your output has another name.
• layout.sh defaults to DP-1; override with MANGO_OUTPUT=... if needed.
• Wallpaper picker reads images from ~/Wallpaper by default. Override with WALLPAPER_DIR=/path/to/wallpapers.
• Portal autostart uses .local/bin/start-portals.sh, which starts the main, GTK and wlr portal binaries after checking normal $PATH lookup and common backend locations.
• Neovim bootstraps lazy.nvim from GitHub on first launch and Treesitter parsers may need a C toolchain.
• Fish aliases and functions assume the shell-experience tools listed below (eza, bat, rg, fd, dust, btop, fastfetch, doas, tty-clock, etc.). Install them first or edit .config/fish/config.fish and .config/fish/functions before using this setup.
• See docs/customize.md for the files that usually need local edits.

Dependencies

Run the checker first:

./scripts/check-deps.sh

It is the source of truth for this setup. If it reports everything you need as ok, you usually do not need to audit this list by hand. The list below is here mainly so missing tools have links and are easier to install.

Portal checks are split on purpose:

• Gentoo: portal binaries commonly live under /usr/libexec, so the checker reports those paths separately.
• Most other distros: portal binaries are usually found through $PATH or under /usr/lib.

The important part is that each portal has at least one ok line. notfound for a Gentoo-only path is fine on a non-Gentoo system, and the reverse is fine on Gentoo.

Mango Session

• mango
• dbus
• dbus-run-session
• pipewire
• pipewire-pulse
• wireplumber
• xdg-desktop-portal
• xdg-desktop-portal-wlr
• xdg-desktop-portal-gtk
• foot
• fuzzel
• awww
• yambar
• dunst
• xsettingsd

Script Dependencies

These are mostly command-line tools used by helper scripts. Prefer ./scripts/check-deps.sh over manually reading this section.

• bash
• GNU coreutils
• findutils
• gawk or compatible awk
• grep
• sed
• head
• procps/psmisc tools such as pgrep and killall
• wl-clipboard
• cliphist
• wayfreeze
• grim
• slurp
• swappy

Optional Apps And Tools

• mpv
• imv
• thunar
• librewolf
• pavucontrol

Shell And Editor

• fish
• fisher
• neovim
• git
• make
• gcc or another C compiler for Treesitter parsers
• python
• btop
• fastfetch
• ripgrep
• fd
• eza
• bat
• dust
• doas
• tty-clock
• neo

UI And Themes

• DejaVu Sans
• DejaVu Sans Mono
• Symbols Nerd Font Mono
• Graphite-Dark
• Goldy-Dark-Icons

For a more readable package list, see docs/packages.md.

Key Binds

• Super+Return - terminal
• Super+Esc - launcher
• Super+W - browser
• Super+E - file manager
• Super+V - clipboard history
• Super+X - wallpaper picker
• Super+/ - emoji picker
• Print - monitor screenshot to clipboard
• Ctrl+Print - full screenshot to clipboard
• Super+Shift+S - area screenshot to clipboard
• Super+Shift+D - area screenshot through Swappy