How rommmmaha/dotfiles works
1. What this repo is
- This is a home-directory dotfiles repository for a CachyOS / Arch-based Linux desktop, managed with chezmoi.
- The repo is not an app codebase; it is a configuration distribution system that materializes files into ~/.config, ~/.local, shell startup files, and other user-level locations.
2. Primary deployment model
- The source of truth lives in the repo, and chezmoi applies it into the user’s home directory.
- Files named with prefixes like dot_config, dot_local, dot_zshrc, dot_bashrc, etc. map to their target paths under $HOME.
- Template files (*.tmpl) indicate rendered configuration with machine-specific or environment-specific values injected at apply time.
3. Configuration orchestration layer
- .chezmoi.toml.tmpl likely defines chezmoi behavior and host-specific variables.
- .chezmoiscripts/ contains post-apply hooks that run after synchronization, used to refresh stateful desktop components.
- This gives the repo a two-stage flow: render files → run follow-up actions.
4. Package baseline and system dependencies
- packages.txt is the package manifest for the desktop environment.
- The README shows packages are installed via yay, so the repo assumes an Arch/AUR package workflow.
- The repo depends on external system packages for its full behavior; the dotfiles configure them rather than vendor them.
5. Shell and session initialization
- dot_bashrc, dot_zshrc, and dot_zprofile define the interactive shell/session layer.
- starship.toml.tmpl, direnv/direnv.toml, bat/config, btop/btop.conf, and micro/* support a CLI-first workflow.
- This layer is the user-facing entry point for terminal environment setup and prompt/tool behavior.
6. Wayland desktop stack
- The core desktop subsystem is Hyprland under dot_config/hypr/.
- Related components include:
- hyprpaper for wallpaper management,
- hyprlock for lock screen,
- eww for custom desktop widgets,
- rofi and rofimoji for launchers/pickers,
- swaync for notifications,
- xdg-desktop-portal/hyprland-portals.conf for desktop integration.
- This forms the main graphical control plane around the compositor.
7. Host-specific window-manager behavior
- dot_config/hypr/custom/hyprland-laptop.conf and hyprland-pc.conf split the desktop config by device class.
- application-style.conf, _ws.sh, and executable__clipvault.sh suggest custom Hyprland helpers for workspace behavior and app-specific automation.
- This indicates the repo supports multiple hardware profiles with shared base config plus overrides.
8. Audio, media, and screen-related subsystems
- pipewire/conf.d/* configures the audio stack, including realtime settings, larger quantum, loopbacks, and virtual sinks.
- mpv configures media playback behavior.
- flameshot supports screenshots/annotations, and the custom local scripts include r_sndcpy.py, suggesting additional audio/video utility glue.
- These configs indicate the repo tunes multimedia behavior beyond defaults.
9. Theme and visual consistency
- GTK theming is handled by gtk-3.0/gtk.css, gtk-4.0/gtk.css, and qt6engine integration via Hyprland config.
- fastfetch/simple.jsonc, BreezeMidnight.colors, wallpaper/, and eww.scss contribute to the desktop’s visual identity.
- The repo treats appearance as a cross-application concern, not a single-tool concern.
10. System and desktop integration boundaries
- systemd/user.conf configures user-session behavior.
- hblock/allow.list suggests ad/tracker blocking integration at the DNS/hosts layer.
- yay/config.json.tmpl and gitconfig support package and source control workflows.
- The README also calls out several manual system-wide settings under /etc, which are explicitly outside chezmoi’s managed scope.
11. Local user scripts and executables
- dot_local/bin/ contains user-owned executable helpers, including r_game.py and r_sndcpy.py.
- These are part of the personalized automation/tooling layer and likely consumed from shell or desktop launchers.
- dot_local/share/... stores per-user data assets such as color schemes.
12. Operational flow to keep in mind
- The repo is applied with chezmoi, packages are installed separately with yay, and some services/configs are then refreshed via post-apply scripts.
- The architecture is therefore: repo source → chezmoi-rendered home config → installed system packages/services → live desktop session.
- Anything listed in the README as /etc edits is a deliberate boundary: it supports the environment but is not managed by this repo.
Main entry points: hyprland.conf.tmpl Hyprland core · .chezmoi.toml.tmpl chezmoi config · .chezmoiscripts apply hooks · starship.toml.tmpl prompt setup
Components 20
Orchestration
chezmoi-driven application and post-apply hooks
- chezmoi config · Top-level chezmoi behavior and host variables
.chezmoi.toml.tmpl - apply hooks · Runs follow-up actions after syncing dotfiles
.chezmoiscripts
Shell & CLI
Interactive shell, terminal, and CLI tooling
- bash startup · Bash session initialization
dot_bashrc - zsh startup · Zsh login and interactive initialization
dot_zshrc - zprofile · Login-shell environment setup
dot_zprofile - prompt setup · Cross-shell prompt rendering
dot_config/starship.toml.tmpl - CLI tools · Terminal, editor, and command-line workflow settings
dot_config
Desktop Stack
Hyprland-based Wayland session and related UI components
- Hyprland core · Primary Wayland compositor and session control plane
dot_config/hypr/hyprland.conf.tmpl - Hypr helpers · Workspace and app automation helpers
dot_config/hypr/custom - lock & wallpaper · Lock screen and wallpaper management
dot_config/hypr/hyprlock.conf - widgets & notifications · Custom widgets and notification styling
dot_config/eww - launchers · Application launcher and emoji picker configuration
dot_config/rofi - theme system · Cross-application theming and visual identity
dot_config/gtk-3.0/gtk.css - audio stack · Realtime, quantum, virtual sinks, and loopbacks
dot_config/pipewire/pipewire.conf.d - media & screenshots · Media playback and screenshot workflow settings
dot_config/mpv
System Integration
Package baseline and session-level integration points
- package manifest · Baseline packages for the desktop environment
packages.txt - session integration · Desktop portal, user services, and content blocking support
dot_config/xdg-desktop-portal/hyprland-portals.conf - package manager · AUR/package workflow configuration
dot_config/yay/config.json.tmpl
Local Assets
User-owned scripts and shared data
- local executables · Personal automation and helper programs
dot_local/bin - color assets · User-shared color schemes and palette data
dot_local/share/color-schemes/BreezeMidnight.colors
Connections 27
- chezmoi config → Hyprland core: renders · chezmoi materializes compositor config
- chezmoi config → prompt setup: renders · renders prompt template
- chezmoi config → package manager: renders · renders package-manager config
- chezmoi config → media & screenshots: renders · renders media configuration
- chezmoi config → theme system: renders · renders theme-related files
- chezmoi config → session integration: renders · renders integration config
- chezmoi config → package manifest: describes · package baseline is tracked alongside dotfiles
- apply hooks → Hyprland core: refreshes · post-apply hooks reload desktop state
- apply hooks → lock & wallpaper: refreshes · reloads wallpaper/lockscreen state
- apply hooks → widgets & notifications: refreshes · restarts widget-related state
- apply hooks → launchers: refreshes · updates launcher-dependent state
- package manifest → package manager: feeds · package workflow depends on baseline manifest
- bash startup → prompt setup: uses · shell startup picks up prompt tooling
- zsh startup → prompt setup: uses · zsh startup picks up prompt tooling
- zprofile → prompt setup: uses · login shell layers into prompt setup
- CLI tools → bash startup: supports · CLI tooling is surfaced from shell init
- CLI tools → zsh startup: supports · CLI tooling is surfaced from shell init
- Hyprland core → Hypr helpers: includes · core compositor config references custom helpers
- Hyprland core → lock & wallpaper: coordinates · compositor session ties into lock and wallpaper
- Hyprland core → widgets & notifications: coordinates · compositor drives widget/notification layer
- Hyprland core → launchers: coordinates · compositor launches rofi-based tools
- Hyprland core → audio stack: depends on · desktop session relies on tuned audio stack
- theme system → color assets: shares · theme system reuses palette assets
- audio stack → media & screenshots: supports · audio/video configs depend on PipeWire tuning
- session integration → Hyprland core: integrates · portal integration is tied to Hyprland session
- local executables → Hypr helpers: invokes · local executables are used by compositor helpers
- local executables → media & screenshots: supports · custom scripts support media-related workflows