dotfiles
May 12, 2026 · View on GitHub
Personal macOS configuration.
Demo
https://github.com/user-attachments/assets/793e7eaa-7909-4086-8380-1fb7861f8780
Overview
| Tool | Role |
|---|---|
| Paneru | Sliding tiling window manager |
| SketchyBar | Custom menu bar |
| borders | Active window border highlight |
| fastfetch | System info on terminal launch |
| cmatrix | Matrix rain in terminal |
| Zsh | Shell with custom prompt |
Preview
Shell prompt:
user@host ~/path %in green/white
Window border:#b3e1a7(green) active,#3c3836inactive, 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:
- Install Homebrew if not present
- Check for Xcode Command Line Tools
- Append shell config to
~/.zshrc(PROMPT, PATH, aliases) - Install Paneru — choose between stable (brew) or testing (built from source, ~5-10 min)
- Copy
.config/contents to~/.config/ - Install
borders,sketchybar, andfastfetchvia Homebrew - Open
custom.terminalfor 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
| Shortcut | Action |
|---|---|
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 + q | Quit 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