dotfiles/README.md

dotfiles

too many dotfiles

Installation

Use GNU Stow (apt install stow, etc.). The repo has a .stowrc which should target your home directory as the installation directory, but in some cases the ~ may not be evaluated and you'll have to specify --target="$HOME".

Install the essentials with stow zsh vim git.

Notes

Git

Most of my git configuration lives in ~/.config/git/personal.gitconfig, which is included from ~/.gitconfig. I do this to separate system-specific configuration that may be set by automated tools (i.e. the Github CLI setting up credential managers for guthub.com and gist.github.com) from my personal, cross-platform configuration (e.g. my identity and aliases).

Keep configuration that should be synced between computers in the personal.gitconfig file, and after cloning the repository, consider telling Git to ignore local changes to the main .gitconfig file:

git update-index --skip-worktree git/.gitconfig

zsh

The zsh config has secrets now, because of the prompt username color fetching thing. You'll probably want to avoid committing your secrets:

git update-index --skip-worktree zsh/.config/zsh/config.d/00_secrets.zsh

The prompt will still work if you don't fill in anything in that file, it'll just always be the default color (your terminal's cyan).

KDE

KDE stuff is split up a lot. If you want everything, stow kde-* should work in all the shells I care about.

kde-autostart-ksuperkey

Adds an autostart entry for /usr/bin/ksuperkey -e 'Super_L=Alt_L|F2', which maps presses of the left meta key to Alt+F2 (the default bind for krunner). ksuperkey can only be used in X, it breaks on Wayland. Install it via cloning, make, and make install:

mkdir -p ~/src/github.com/hanschen
git clone https://github.com/hanschen/ksuperkey.git ~/src/github.com/hanschen/ksuperkey
cd ~/src/github.com/hanschen/ksuperkey
make
sudo make install

kde-dolphin

Configuration for Dolphin. Mostly toolbar layout and icon sizes.

kde-icon-*

Custom icons for various apps I use. They wind up in ~/.local/share/icons/hicolor/* alongside other icons for user-installed apps.

kde-konsole

My Konsole profile, as well as some additional configuration for default window size on different screens. You can see what screen sizes I use in here!

kde-krunner

Just adds a .desktop entry that launches krunner. Mostly useful as a thing I used to keep on my application switcher, but nowadays I don't really use it - if I have a launcher icon on my dock at all, it'll be a proper switcher so I can log out/shutdown/etc without my keyboard if I need to.

kde-kwin-apprules

Custom application rules for kwin. Files in ~/.local/share/color-schemes come from my repo of KDE titlebar color schemes.

kde-spectacle

Configures Spectacle to act more like ShareX or macOS's screenshot tool by default - pressing print screen will bring up rectangle select, and hitting enter will save the screenshot to disk and copy the image contents to the clipboard. My screenshots are saved to ~/Pictures/Screenshots/YYYY-MM/YYYYMMDDHHmmSS.png.