Dotfiles

A collection of config files and scripts for Fedora GNU/Linux and macOS.

Linux installation

chezmoi init --apply git@github.com:AquaMorph/dotfiles.git

macOS installation

1. Install the Xcode Command Line Tools with xcode-select --install, then install Homebrew and follow its brew shellenv instructions. Its default prefix is /opt/homebrew on Apple Silicon and /usr/local on Intel Macs.

2. Download the dotfiles without applying them, then install dependencies:

   brew install chezmoi
   chezmoi init git@github.com:AquaMorph/dotfiles.git
    brew bundle --file="$(chezmoi source-path ~/.brewfile)"
   

   The Brewfile includes chezmoi, Git, Emacs, Python, jq, pass, GnuPG, Brave Browser, Alacritty, Inconsolata, and AutoRaise. FFmpeg and Ollama are optional; install them separately if needed.

3. Restore your password store to ~/.password-store and import its GPG private key from a secure backup before applying the dotfiles:

   gpg --import /path/to/private-key-backup.asc
   

   If the store is kept in Git, clone it to ~/.password-store using your password-store repository URL. Verify that all required secrets can be decrypted without printing their values:

   pass show self-host/token/audible-activation-bytes >/dev/null
   pass show self-host/token/aquaai >/dev/null
   pass show self-host/token/todoist >/dev/null
   

   settings.conf is rendered using pass, so applying it requires these entries and the matching private key. Never commit keys or plaintext tokens.

4. Review and apply the dotfiles, then open a new terminal:

   chezmoi diff
   chezmoi apply
   

   The generated ~/.config/settings.conf is private (mode 0600) and its values are shell-quoted. Linux-only configuration and scripts are ignored on macOS; shared shell, Git, and terminal configuration remains managed.

To install newly added macOS dependencies later:

brew bundle --file="$(chezmoi source-path ~/.brewfile)"

Hover window focus on macOS

AutoRaise focuses and brings a window to the front after a short hover, without moving the cursor. Its settings are managed in ~/.config/AutoRaise/config.

After installing dependencies and applying the dotfiles, enable it at login:

brew services start dimentium/autoraise/autoraise

Grant AutoRaise access in System Settings → Privacy & Security → Accessibility. If it is not listed, use +, press Cmd+Shift+G, and enter the path printed by echo "$(brew --prefix autoraise)/bin/AutoRaise". Then restart it with brew services restart dimentium/autoraise/autoraise.

Hold Control to temporarily suspend hover focus. To turn it off entirely:

brew services stop dimentium/autoraise/autoraise