Dotfiles

Personal Gentoo Linux dotfiles managed with chezmoi.

Quick Start

# Bootstrap chezmoi and apply dotfiles
sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply Saulimedes/dotfiles

You'll be prompted once for your name and email (used for git/jj config, kept out of this repo).

This will:

Install chezmoi
Clone dotfiles
Run atomic setup scripts (overlays, packages, flatpak, etc.)
Apply all configuration files

What's Included

Package Management

Gentoo packages (packages.txt):

Shells: zsh, starship, atuin, zoxide
CLI tools: bat, eza, fd, ripgrep, fzf
Network: nmap, mtr, tcpdump, iperf
Media: mpv, ffmpeg
Browsers: Brave, Helium
Messaging: Telegram, Session

mise (dot_config/mise/config.toml):

Languages: Node, Python, Go, Rust, Zig, Java, Bun, Deno
Kubernetes: kubectl, helm, k9s, stern, kustomize, k3s
IaC/Cloud: OpenTofu, Vault, Ansible, gcloud, azure-cli
Dev tools: direnv, gh, jq, yq, shellcheck, shfmt

Atomic Setup Scripts

Script	Purpose
`run_once_setup-portage.sh`	Enable Gentoo overlays (guru, another-brave-overlay, pentoo)
`run_once_setup-flatpak.sh`	Configure Flathub, install Flatpak apps
`run_once_install-packages.sh`	Install packages from `packages.txt`
`run_once_install-antidote.sh`	Install zsh plugin manager
`run_once_install_tmux_plugins`	Install TPM and plugins
`run_once_install-mpv-plugins.sh`	Install mpv scripts/shaders (mpv360, gif-generator, webm)
`run_once_setup-podman.sh`	Configure rootless podman (subuid/subgid, docker symlink)
`run_once_setup-xkb-udev-rule.sh`	udev rule to re-apply the XKB patch on keyboard hotplug
`run_onchange_mise-install`	Install mise tools
`run_onchange_install-packages.sh`	Re-installs packages when `packages.txt` changes
`run_onchange_setup-openrc-services.sh`	Enable OpenRC services (chronyd, tlp, bluetooth, mullvad-daemon, i2pd, autofs, syncthing)
`run_onchange_setup-samba-mounts.sh`	Configure autofs mounts to the Unraid NAS
`run_onchange_sync-genkernel.sh.tmpl`	Sync `genkernel.conf` to `/etc/genkernel.conf`
`run_onchange_sync-useflags.sh.tmpl`	Sync `useflags.txt` to `/etc/portage/package.use/`

Shell Configuration

Zsh with antidote plugin manager
Starship prompt
Atuin shell history
forgit for fzf + git integration
Custom abbreviations and functions

Keyboard Layout

US QWERTY with altgr-weur variant for Western European characters
; key remapped to dead_diaeresis via XKB — type ;a for ä, ;o for ö, ;s for ẞ
;; for literal semicolon, ; (space) preserves natural typing flow
AltGr+letter still available for direct accented characters (hold AltGr+a → ä, AltGr+8 → ß)
Custom .XCompose overrides for ẞ and semicolon fallback sequences
Caps Lock → Control via ctrl:nocaps

Editor

Emacs with custom config (dot_emacs.d/)
emacsclient as default editor
Dired alias: d opens current directory

Mise Tasks

Task	Purpose
`mise run kernel`	Copy saved config, build kernel, install modules, rebuild initramfs, update limine.conf
`mise run kernel-config-save`	Save `/usr/src/linux/.config` back to chezmoi (`~/.config/kernel/linux.config`)

Kernel upgrade workflow:

eselect kernel set <new>
mise run kernel                          # applies saved config, builds
# if config needs updating for new kernel:
sudo make -C /usr/src/linux olddefconfig
mise run kernel-config-save              # save updated config
git -C ~/.local/share/chezmoi add dot_config/kernel/linux.config && git commit
mise run kernel

Re-running Scripts

# Re-run all setup scripts
chezmoi state delete-bucket --bucket=scriptState
chezmoi apply

# Re-run a specific script manually
chezmoi execute-template < run_onchange_install-packages.sh.tmpl | bash
chezmoi execute-template < run_onchange_sync-useflags.sh.tmpl | bash

Requirements

Gentoo Linux with ~amd64 in ACCEPT_KEYWORDS
Overlays: guru, another-brave-overlay, pentoo (auto-configured)

License

GPLv3

Saulimedes/dotfiles

README