Skip to content

Latest commit

 

History

History
84 lines (57 loc) · 1.94 KB

README.md

File metadata and controls

84 lines (57 loc) · 1.94 KB

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
  1. Edit a dotfile
editrc [index|filename]
  1. 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