dotfiles
My personal configuration for an Arch-based Linux desktop, built around Niri on Wayland. It covers the compositor, session/autostart plumbing, shell, audio, terminal, editor, multiplexer, media, and default applications.
These are hand-maintained dotfiles with no installer or dotfiles manager — I copy files into $HOME by hand. The repository layout mirrors $HOME, so individual files can be copied along the same paths, but do not copy the whole tree into $HOME blindly; review each file and adjust the machine-specific values noted below.
Table of contents
Layout
| Path |
Contents |
.config/niri/ |
Niri config, keybinds, layout, rules, outputs |
.local/bin/ |
Session helpers and utility scripts (start-comp, autostart*, keyring-doctor, …) |
.config/autostart.env |
Autostart options (wallpaper mode, theme, cursor) |
.bashrc, .profile, .config/aliasrc |
Shell, history, aliases, PATH |
.config/pipewire/, .config/wireplumber/ |
Audio drop-ins (clock, ROC mic, ATH-M40x EQ) |
.config/foot/, .config/fuzzel/, .config/fnott/ |
Terminal, launcher, notifications |
.config/nvim/, .config/tmux/ |
Editor and terminal multiplexer |
.config/xdg-desktop-portal/, .config/mimeapps.list |
Portals and default applications |
.local/share/applications/ |
Desktop entries for the default apps |
Dependencies
Required for the setup as configured:
- Niri (Wayland compositor). X11 apps require
xwayland-satellite ≥ 0.7 on PATH; since niri 25.08 it is detected and started automatically, so this repository does not launch it.
- foot (
foot --server + footclient), fuzzel (launcher), fnott (notifications).
- PipeWire + WirePlumber; wl-clipboard + cliphist, wlsunset, brightnessctl.
- swaybg (wallpaper), hyprlock / hypridle, imv, mpv, pcmanfm-qt, firefox.
- flavours (base16 colour generation).
- Neovim ≥ 0.12, tmux ≥ 3.0, plus
tree-sitter-cli, a C compiler, curl and tar for parser installation.
- fzf (with optional bat previews) for shell integration.
Optional or conditional:
- pipewire-roc — only for the ROC network microphone input.
- mpv-shim-default-shaders — provides
CAS-scaled.glsl for mpv’s modern-hardware profile (the bundled FSRCNNX shader ships here).
- libva-utils (
vainfo) — used by the mpv auto-profile script to pick a GPU profile; playback works without it.
- openrgb, gnome-keyring, yt-dlp, wlr-randr — used when present, skipped otherwise.
The fonts and cursor theme referenced by the configs are assumed to be installed; they are not part of this repository.
Session and startup
start-comp <compositor> (for example start-comp niri-session) sets the Wayland/XDG environment and execs the compositor. Niri spawns autostart at startup, which waits for the compositor, clears stale daemons, imports the environment into systemd and D-Bus first, starts the keyring (systemd unit if available, waits for org.freedesktop.secrets), launches a polkit agent (systemd unit, then plain binaries), and then runs autostart-services and autostart-wallpaper. Wallpaper mode, theme mode and cursor are set in .config/autostart.env.
Keyring
Apps such as Proton VPN keep their login in the Secret Service (gnome-keyring). For it to survive reboots without prompting, the login keyring must be unlocked at login. Best option: add the PAM module so it unlocks with your tty1 password (it only works when you type the password, not with autologin):
# /etc/pam.d/login (end of the auth block, and end of the session block)
auth optional pam_gnome_keyring.so
session optional pam_gnome_keyring.so auto_start
The login keyring’s password must equal your user password (change it once in Seahorse if it is not). .local/bin/keyring-doctor prints what is wrong (owner of the Secret Service, keyring files, default alias, PAM, apps started by xdg-autostart).
Audio
Audio uses small PipeWire drop-ins under .config/pipewire/pipewire.conf.d/:
10-clock.conf pins default.clock.quantum = 1024 and min-quantum = 256; everything else uses upstream defaults.roc-source.conf exposes the ROC network microphone as an Audio/Source named Phone Mic (ROC). It is guarded with flags = [ ifexists nofail ], so it stays inert unless pipewire-roc is installed — normal audio works either way.20-ath-m40x-eq.conf adds a parametric EQ (AutoEq/oratory1990, Harman target) as a virtual sink named ATH-M40x (AutoEq Harman). It does not change the default output: select it manually in pavucontrol/wpctl and route it to a real sink. The profile path inside it is absolute and must be adjusted for a different $HOME. There is no automatic headphone-jack detection.
.config/wireplumber/examples/51-disable-suspension.conf.example is an inactive example (idle-suspend disable) and is not loaded by default.
Applications and integrations
- Portals —
niri-portals.conf sets default=gnome;gtk; (GNOME preferred, then GTK) for every interface without an explicit override; Access, Notification and FileChooser are pinned to GTK, while Secret is pinned to gnome-keyring (one Secret Service provider only). Requires xdg-desktop-portal with the GTK and GNOME backends.
- Default apps —
mimeapps.list maps common types to desktop entries in .local/share/applications/. Archive (lxqt-archiver.desktop) and torrent (torrent.desktop) associations are not shipped here and rely on an installed archiver/client.
- mpv — a
modern-hardware profile enables GPU decoding and shader sharpening (bundled FSRCNNX plus external CAS-scaled.glsl); automatic profile selection lives in .config/mpv/scripts/auto-profile.lua.
- Neovim —
nvim-treesitter tracks the main branch (Neovim ≥ 0.12); parsers are installed asynchronously on first launch.
- tmux — needs
tmux ≥ 3.0 (the C-\ binding relies on its parser). The <C-f> Neovim mapping expects an external tmux-sessionizer on PATH, which is not provided here.
Usage
Copy the files you need into $HOME, keeping the same relative paths. Review the machine-specific values first: the absolute EQ path in 20-ath-m40x-eq.conf, monitor names in outputs.kdl/keybinds.kdl, and the paths in .config/autostart.env. Optional components (ROC microphone, ATH-M40x EQ, external shaders, vainfo-based profile selection) only activate when their dependency is installed.
评论