dotfiles

Overview

The provided dotfiles program manages the usual dotfiles.

• Bare git repository for dotfiles, no symlinks are needed
• Installs required dependencies

Linux workstation

The provided setup-tumbleweed and setup-user are highly interactive programs to get up and running a new openSUSE Tumbleweed box.

• Places /etc into separate, local version control (etckeeper)
• Performs optimizations for SSD, swap
• Setups hibernation, clock, hostname
• Adds/removes packages
• Configures automatic download of updates
• Other conveniences

Setup on new computer

git clone <git-repo-url>
./dotfiles/bin/setup-tumbleweed
./dotfiles/bin/setup-user
./dotfiles/bin/dotfiles install <git-repo-url>

At this point the programs are available in $PATH.

Operation

1. Pull from upstream

dotfiles pull

2. Edit a dotfile

editrc [index|filename]

3. Create bash script from template

newscript filename

System maintenance

General maintenance:

• auto-update: fetches packages in background for available upgrades
• upgrade: performs a system upgrade, checks for known issues
• drive-health: health routine for file systems / drives
• backup: makes a backup from a btrfs subvolume to external drive

System utilities:

• boot-svg: export boot sequence to .svg/.txt
• btrfs-size: prints storage space for each subvolume
• zypper-download: downloads .rpm packages in parallel
• zypper-changelog: prints changelogs for updated packages

Tools:

• delta: a viewer for git and diff output
• notes: write a note
• serve: serve HTTP content out of a directory
• sp: controls spotify playback
• up: tool for writing Linux pipes with instant live preview
• vpn: checks and connects to a VPN

Local-specific script:

• local-overrides: checks for each local configuration overrides

References

• https://news.ycombinator.com/item?id=11070797
• https://www.atlassian.com/git/tutorials/dotfiles