dotfiles

May 12, 2026 · View on GitHub

Personal macOS configuration.

Demo

https://github.com/user-attachments/assets/793e7eaa-7909-4086-8380-1fb7861f8780

Overview

ToolRole
PaneruSliding tiling window manager
SketchyBarCustom menu bar
bordersActive window border highlight
fastfetchSystem info on terminal launch
cmatrixMatrix rain in terminal
ZshShell with custom prompt

Preview

Shell prompt: user@host ~/path % in green/white
Window border: #b3e1a7 (green) active, #3c3836 inactive, 6px rounded
Menu bar: transparent, clock + battery + volume + window titles

Requirements

  • macOS
  • Internet connection (Homebrew, Xcode Tools, and optionally Rust are fetched automatically)

Install

git clone https://github.com/yourusername/dotfiles.git
cd dotfiles
chmod +x install.sh
./install.sh

The installer will:

  1. Install Homebrew if not present
  2. Check for Xcode Command Line Tools
  3. Append shell config to ~/.zshrc (PROMPT, PATH, aliases)
  4. Install Paneru — choose between stable (brew) or testing (built from source, ~5-10 min)
  5. Copy .config/ contents to ~/.config/
  6. Install borders, sketchybar, and fastfetch via Homebrew
  7. Open custom.terminal for the terminal theme

After the installer finishes, run:

source ~/.zshrc
paneru install
paneru start
brew services start borders
brew services restart sketchybar

Note: Paneru requires Accessibility permissions. A dialog should appear on first launch — if not, go to System Settings → Privacy & Security → Accessibility and add it manually.

Paneru Keybindings

ShortcutAction
ctrl + alt + ,Focus window west
ctrl + alt + .Focus window east
cmd + ctrl + alt + ,Swap window west
cmd + ctrl + alt + .Swap window east
ctrl + alt + ]Resize window wider
ctrl + alt + [Resize window narrower
ctrl + alt + 'Full width
ctrl + alt + ;Manage window
ctrl + alt + qQuit Paneru

Shell

Lines added to ~/.zshrc:

PROMPT='%F{#b3e1a7}%n%f%F{#ffffff}@%f%F{#b3e1a7}%m%f %F{#ffffff}%~ %F{#ffffff}%%%f '
alias matrix='cmatrix -C green'
export PATH="$HOME/.local/bin:$PATH"

Issues

If you run into any problems, feel free to open an issue.

Structure

dotfiles/
├── .config/
│   ├── paneru/        # paneru.toml
│   ├── sketchybar/    # sketchybarrc + plugins/
│   ├── borders/       # bordersrc
│   └── fastfetch/     # config.jsonc
├── assets/
│   └── wallpaper.jpg
├── custom.terminal
└── install.sh