No description
  • Python 36.4%
  • Shell 34.4%
  • Lua 17.9%
  • CSS 9.8%
  • Just 0.8%
  • Other 0.7%
Find a file
Love Billenius 79deb903c7 xdg-dirs: Name a theme command that still exists
The migration notes told Hyprland users to run theme auto, which is
theme-auto again after the rebase onto the sun-based switching, and
that one skips a theme already applied, so it would not create the
GTK 2 link. Point at theme dark or theme light instead.
2026-11-18 17:20:32 +01:00
bat/.config/bat/themes spring-cleaning: Fold the theme scripts into one 2026-11-18 17:19:54 +01:00
foot/.config/foot fix foot and gtk 2026-03-11 11:22:09 +01:00
ghostty/.config ghostty: Raise scrollback, use left Option as Alt 2026-11-18 17:19:54 +01:00
hyprland xdg-dirs: Move the tmux and GTK 2 files to ~/.config 2026-11-18 17:20:18 +01:00
neomutt/.config spring-cleaning: Fold the theme scripts into one 2026-11-18 17:19:54 +01:00
paru/.config/paru theme: theme-auto timer, cgroup-safe respawns, bat theming, waybar rework 2026-08-12 21:16:09 +02:00
password-store neomutt + theme fix + packages 2026-04-15 11:31:21 +02:00
shell xdg-base-dirs: Restore a lost XDG_RUNTIME_DIR 2026-11-18 17:20:18 +01:00
tmux xdg-dirs: Move the tmux and GTK 2 files to ~/.config 2026-11-18 17:20:18 +01:00
vim/.config/vim xdg-dirs: Add bun, NuGet and Vim 2026-11-18 17:20:18 +01:00
wezterm/.config/wezterm wezterm 2026-03-04 17:59:01 +01:00
.gitignore xdg-dirs: Add bun, NuGet and Vim 2026-11-18 17:20:18 +01:00
justfile setup-hypr: theme-auto, pre-create shared dirs before stow 2026-10-02 14:42:28 +02:00
README.md xdg-dirs: Name a theme command that still exists 2026-11-18 17:20:32 +01:00

Dotfiles

Some of the configuration for the software that I use. This doesn't include neovim as that's in a separate repo.

How to use?

Clone the repo to your homedirectory. Then, use GNU Stow to "install" and "uninstall" the configurations.

To install:

stow ghostty

To uninstall:

stow -D ghostty

Some packages also ship a just setup recipe that stows them and wires up their systemd timers in one step — run just (or just --list) to see them.

Configs

foot

Foot terminal config with Catppuccin themes sourced via include=.

  • Dependencies: foot, ttf-jetbrains-mono
sudo pacman -S --needed foot ttf-jetbrains-mono

ghostty

Ghostty terminal config with Catppuccin themes.

  • Dependencies: ghostty
sudo pacman -S --needed ghostty

hyprland

Hyprland compositor config (Lua), Waybar, Rofi themes, wallpaper automation, and theme switchers for Hyprland, GTK, and Qt.

Requires Hyprland 0.55+ — the config is written in the new Lua format (hyprland.lua); earlier versions only understand hyprland.conf.

sudo pacman -S --needed \
    hyprland hyprpaper hypridle hyprlock hyprpolkitagent \
    xdg-desktop-portal-hyprland xdg-desktop-portal-gtk \
    waybar rofi dunst \
    network-manager-applet \
    wl-clipboard cliphist \
    grim slurp jq socat python \
    pipewire-pulse pavucontrol \
    playerctl brightnessctl wlsunset \
    qt5ct qt6ct kvantum \
    papirus-icon-theme breeze \
    kwallet kwallet-pam ksshaskpass libsecret gcr-4 \
    ghostty thunar gvfs thunar-volman thunar-archive-plugin thunar-media-tags-plugin \
    ristretto ffmpegthumbnailer libgsf \
    firefox thunderbird zathura mpv \
    foot wezterm \
    flatpak \
    ttf-jetbrains-mono-nerd noto-fonts
  • OSD and power menu: swayosd (volume/brightness/mic on-screen display) and wlogout (power menu) — paru -S swayosd wlogout. swayosd is also in the official repos on current Arch (sudo pacman -S swayosd); wlogout is AUR-only. wlsunset (night light) is already in the pacman list above.
  • Enable automatic day/night theme switching (light between sunrise and sunset, computed locally by sun-times): run just setup-hypr (stows, enables the timer, applies the current theme), or do it manually with systemctl --user enable --now theme-auto.timer && systemctl --user enable theme-auto.service. Toggle manually with Mod+Shift+T, or run ~/.local/bin/theme dark|light|toggle.
  • Night light turns on at 21:00 and reverts at 07:00 via wlsunset, autostarted from hyprland.lua; edit the -S/-s/-t/-T flags there to change the times or warmth.
  • New keybinds: Mod+M power menu, Mod+/ keybind cheatsheet, Mod+Shift+M / XF86AudioMicMute microphone mute, Mod+N notification history, Mod+Shift+N dismiss all notifications.
  • steam (used by the Mod+Shift+S bind) needs the multilib repo — install separately.
  • Flatpak fallbacks (Spotify, Discord, Bitwarden, Telegram): flatpak install flathub com.spotify.Client com.discordapp.Discord com.bitwarden.desktop org.telegram.desktop.
  • Theme assets: install Catppuccin GTK and Kvantum themes so the light/dark switchers can target Latte and Mocha variants.
  • If AUR packages are unavailable, run ~/.local/bin/update-catppuccin-themes to install the Catppuccin GTK and Kvantum assets directly for the current user.
  • Keyring support: KWallet provides the Secret Service. kwalletd6 is the wallet daemon; ksecretd is the bridge that actually registers org.freedesktop.secrets (the name libsecret, git-credential-libsecret, and Electron's --password-store talk to). The Hyprland session imports DISPLAY, WAYLAND_DISPLAY, and the XDG session variables into the user D-Bus/systemd environment so prompts work.
  • hyprland.lua autostarts ksecretd (Plasma normally does this). It must run, and must start after dbus-update-activation-environment: the kwallet-pam --pam-login instance races the user bus at login and loses, so without the explicit autostart org.freedesktop.secrets ends up unregistered (secret-tool reports "The name is not activatable").
  • SDDM: Arch's default /etc/pam.d/sddm already includes the pam_kwallet5.so auth/session lines (the module name is pam_kwallet5.so even with the KF6 kwalletd6 daemon). With kwallet-pam installed, the wallet is unlocked at login using your login password — no manual socket to enable.
  • After install, fully log out through SDDM or reboot so kwallet-pam unlocks the wallet and kwalletd6 claims the Secret Service. Reloading Hyprland alone is not enough.
  • Do NOT also run gnome-keyring: it races KWallet for org.freedesktop.secrets (whoever registers it first wins). This setup removes it entirely (pacman -Rns gnome-keyring). Note KDE has no org.freedesktop.impl.portal.Secret backend, so Flatpak apps using the Secret portal lose secret storage — keep gnome-keyring installed only if you need that.
  • Optional Git HTTPS credential storage: git config --global credential.helper /usr/lib/git-core/git-credential-libsecret (works against KWallet via the Secret Service).
  • Electron app wrappers: this repo ships ~/.local/bin/element-desktop, ~/.local/bin/discord, ~/.local/bin/bitwarden-desktop, and ~/.local/bin/signal-desktop, all of which force --password-store=kwallet6. Without it, Electron auto-detects the keyring from XDG_CURRENT_DESKTOP (which is Hyprland here, for theming), fails to match KDE/GNOME, and falls back to the plaintext basic store.
    • Discord and Bitwarden are launched via keybinds (Mod+Ctrl+D / Mod+Ctrl+B) that call the wrappers directly.
    • Signal is launched from its .desktop entry, so this repo ships a local override in ~/.local/share/applications/signal.desktop that points Exec at the wrapper (the system entry calls /usr/bin/... directly and bypasses it). Note ~/.local/bin is after /usr/bin in PATH, so the override uses the wrapper's absolute path, not the bare command.
    • Element is not forced onto kwallet: element-desktop's safeStorage migration to kwallet6 relaunches in an infinite loop (element-hq/element-desktop#2381, unfixed). It's left on Electron's default (basic_text) until upstream fixes it; the element-desktop wrapper stays shipped but no .desktop override points at it.

neomutt

NeoMutt with one file per account in accounts/, Catppuccin themes, and DavMail as the local IMAP/SMTP gateway for the LiU Exchange account. The passwords come from pass (see password-store).

  • Dependencies: neomutt, pass, and davmail (AUR) for the LiU account
sudo pacman -S --needed neomutt pass
paru -S davmail

paru

Paru AUR helper configuration.

  • Dependencies: paru
sudo pacman -S --needed base-devel
git clone https://aur.archlinux.org/paru-bin.git /tmp/paru
pushd /tmp/paru
makepkg -si
popd
rm -rf /tmp/paru

password-store

The pass store holding the mail passwords that the neomutt accounts read, encrypted to the key in .gpg-public-key.asc.

  • Dependencies: pass, gnupg
sudo pacman -S --needed pass gnupg

shell

zsh config, git config and attributes, and the small scripts in ~/.local/bin. Works on both Linux and macOS.

  • ~/.zshenv is the only file left in the home directory; it points zsh at ~/.config/zsh (ZDOTDIR), where .zshenv, .zprofile and .zshrc live.

  • .zshenv sets PATH and the environment. Every zsh reads it, so scripts and ssh host command see the same as an interactive shell; .zprofile applies it again because macOS reorders PATH for login shells.

  • .zshrc is the interactive setup and sources every *.sh and *.zsh file in ~/.config/shell on its own — a new file there needs no registration. The one file in devices/ that matches $SHELL_DEVICE (detected from the OS when unset) goes first, then the rest in alphabetical order.

  • ~/.config/shell/device.zsh is sourced last when it exists and is ignored by git — the place for what belongs to one machine only.

  • The .sh files are plain POSIX sh, so that nothing in them is a zsh-only fact. env.sh holds the variables that keep programs out of the home directory (see below) and aliases.sh the aliases; for bash, add to ~/.bashrc:

    . ~/.config/shell/env.sh
    . ~/.config/shell/aliases.sh
    

XDG base directories

env.sh tells the programs that would otherwise keep a dotfile in $HOME (cargo, rustup, go, bun, gnupg, pass, npm, NuGet, docker, less, …) to use ~/.config, ~/.cache, ~/.local/share and ~/.local/state instead. xdg-migrate moves what is already there. It reads the destinations from those same variables, so env.sh is the one place that decides where things live, and it never overwrites: a destination that exists is reported and skipped. It also removes what earlier setups left behind (oh-my-zsh, old caches).

It also exports the four base directories themselves (XDG_CONFIG_HOME, XDG_CACHE_HOME, XDG_DATA_HOME, XDG_STATE_HOME) with their default values, for the programs that fall back to a dotfile when they are unset. On macOS a few programs then read ~/.config instead of ~/Library/Application Support; xdg-migrate moves the ones it knows (glab, lazygit, nushell). Add a line to it if another starts empty.

On a machine that still has the old layout:

git pull
stow -R shell tmux vim    # plus hyprland where it is installed
exec zsh                  # a shell that has the new variables
xdg-migrate --dry-run     # the plan, including what is left alone and why
xdg-migrate

Open new terminals afterwards: a shell started before the move still looks in the old places. Notes:

  • ~/.npm is a cache; when the script skips it because ~/.cache/npm already exists, delete one of the two.

  • gnupg: the script stops the agent before moving ~/.gnupg. Programs not started from a shell (a GUI mail client, say) do not see GNUPGHOME.

  • On the Hyprland desktop, run theme dark or theme light once (theme-auto skips a theme that is already applied): GTK 2 now reads ~/.config/gtk-2.0/gtkrc, which the theme script creates.

  • Left alone, because the program cannot be told otherwise or it is not worth the risk: ~/.ssh, ~/.vscode, ~/.dotnet, ~/.m2, ~/.colima, bash's own files. xdg-migrate --dry-run lists every remaining dotfile with the reason.

  • Optional, used when installed: zsh-autosuggestions, zsh-syntax-highlighting, fzf, eza, and fortune + cowsay + lolcat for the greeting.

  • Dependencies: zsh, git, bat, neovim, git-lfs, odt2txt

sudo pacman -S --needed zsh git bat neovim git-lfs odt2txt \
    zsh-autosuggestions zsh-syntax-highlighting fzf eza

tmux

tmux config: vim-style navigation, vi copy-mode (selections go to the system clipboard via OSC-52, so copy works over SSH too), and a Catppuccin status bar that switches between Mocha and Latte on its own systemd timers — no graphical session required, so it also works on a headless server.

  • Dependencies: tmux, plus stow and just for setup
sudo pacman -S --needed tmux stow just

First-time setup (stows tmux, enables the 07:00/19:00 theme timers, applies the current theme):

just setup-tmux

On a headless server, also enable lingering once so the timers fire without an active login:

sudo loginctl enable-linger "$USER"

Switch manually any time with ~/.local/bin/tmux-theme dark|light|toggle.

vim

A minimal vimrc in ~/.config/vim, which Vim reads on its own since 9.1.0327. It sends viminfo and the netrw history to ~/.local/state/vim, so nothing of Vim's is left in the home directory. (Neovim is configured in its own repo.)

  • Dependencies: vim
sudo pacman -S --needed vim

wezterm

WezTerm terminal config with Catppuccin schemes.

  • Dependencies: wezterm
sudo pacman -S --needed wezterm