obk's dotfiles

this repository contains my personal dotfiles and setup script for macos.

installation

1. install xcode-select --install
   • a window will pop up asking if you want to install the command line developer tools
   • click install
   • this will give you git
2. clone the repository:

   git clone https://git.sr.ht/~obk/.dotfiles

3. navigate to the directory:

   cd .dotfiles

4. run the installation script:

   ./install.sh

---

what the installer does

the install.sh script handles the following tasks:

• replace .zshrc: backs up your existing configuration and symlinks the repository's .zshrc to ~/.zshrc.
• link configs: symlinks all directories found in .config to ~/.config to avoid conflicts.
• install homebrew: checks if homebrew is installed; if not, it installs it (supporting both arm and intel macs).
• bundle packages: checks for a brewfile and prompts to install packages via brew bundle.
• system defaults: checks for the .macos script and prompts to apply system-wide preferences.

---

configuration details

macos preferences (.macos)

the included .macos script modifies system defaults to improve usability and speed. it requires sudo permissions at the start to update system settings.

key changes:

• finder:
  • shows all hidden files and file extensions.
  • sets the default search scope to the current folder.
  • defaults to list view.
  • shows the full path bar.
• dock:
  • removes all persistent app icons (starts fresh).
  • hides recent applications.
  • sets icon size to 36px.
  • enables auto-hide with 0 second delay (instant animation).
• general ui/ux:
  • expands save and print panels by default.
  • disables "smart" features: automatic dash/quote substitution and spell correction.
  • screensaver asks for a password immediately (0 delay).
  • screenshots are saved to the desktop as pngs.

zsh configuration (.zshrc)

the shell configuration uses oh-my-posh for prompt theming.

useful aliases:

alias	command	description
bf	brew update && brew upgrade...	full homebrew maintenance: updates, upgrades, removes old deps, and cleans up.
mu	sudo softwareupdate -i -a	install all available macos software updates.
gp / gl / gcm	git push / git pull / git commit -m	git shortcuts.
vi / vim	nvim	defaults to neovim.
ll	ls -l --color=auto	list files with details and color.
lal	ls -a -l --color=auto	list all files with details and color.