~/dotfiles

Dotfile configuration for Arch Linux and macOS.

Screenshots

Quick Start (Arch Linux)

After a fresh Arch install, you'll be in a TTY. Clone the repo and run the setup script:

git clone git@github.com:phcurado/dotfiles.git ~/dotfiles
cd ~/dotfiles
./setup.sh
reboot

SDDM will start on boot. Select niri and login. Open a terminal with Super + T and connect to WiFi using the Noctalia control center.

Quick Start (macOS)

git clone git@github.com:phcurado/dotfiles.git ~/dotfiles
cd ~/dotfiles
./setup.sh

The setup script will install Xcode CLI tools, Homebrew, and all packages from macos-pkgs/Brewfile. Packages can be managed with make install and make tofile (OS is detected automatically).

AI tools

The setup script can install Pi:

pi
/login

Window management (AeroSpace + SketchyBar)

The macOS desktop uses three Homebrew packages (in macos-pkgs/Brewfile), all autostarting at login:

• AeroSpace — tiling WM → .config/aerospace/aerospace.toml
• SketchyBar — top bar → .config/sketchybar/
• JankyBorders — focused-window border → .config/borders/bordersrc

Before first launch, turn off Displays have separate Spaces in System Settings > Desktop & Dock > Mission Control, then log out and back in. Grant AeroSpace Accessibility permissions when prompted.

Cross-platform configs

These configs work on both Linux and macOS: neovim, ghostty, tmux, zsh, starship, git, yazi, bat, btop, mise, zoxide.

Linux-only configs

These are Linux-specific and create harmless dead symlinks on macOS: niri, noctalia.

Main Packages

Paru

Paru is an AUR helper for installing packages from the Arch User Repository.

sudo pacman -S --needed base-devel
git clone https://aur.archlinux.org/paru.git /tmp/paru
cd /tmp/paru
makepkg -si

Note

All packages below are included in arch-pkgs/pkgs.txt and can be installed at once with make install. The individual install commands are shown for reference only.

Neovim

Neovim is my preferred text editor.

paru -S neovim

Ghostty

Ghostty is a modern terminal emulator.

Important

Ghostty is configured to use the font 0xProto Nerd Font. Install it or change the font in .config/ghostty/config. List available fonts with ghostty +list-fonts.

paru -S ghostty

Tmux

tmux is a terminal multiplexer.

paru -S tmux

To install plugins, open a tmux session and press prefix + I (prefix is Ctrl + a).

Mise

Mise manages versions of programming languages and tools.

paru -S mise
mise install   # Install versions from mise.toml

Zsh

Zsh is my preferred shell.

paru -S zsh
chsh -s /usr/bin/zsh

Reboot or log out/in to apply.

Starship

Starship is a cross-shell prompt.

paru -S starship

GNU Stow

GNU Stow manages symlinks for dotfiles.

paru -S stow
stow --no-folding .

If files conflict, use --adopt to override:

stow --no-folding --adopt .

Additional Packages

Install packages from the saved list:

make install
# or: paru -S --needed - < arch-pkgs/pkgs.txt

Save current packages to file:

make tofile
# or: paru -Qqen > arch-pkgs/pkgs.txt

Review arch-pkgs/pkgs.txt before installing - some packages may be system-specific.

Makefile Commands

Command	Description
make install	Install packages from package list
make show	List installed packages
make tofile	Save installed packages to list file
make cleanCache	Clean package cache
make secrets.setup	Restore AGE key from 1Password
make secrets.backup	Show AGE key for backup to 1Password

Additional Configuration

Niri

Niri is my window manager (Wayland scrolling compositor).

Noctalia provides the desktop shell (bar, notifications, launcher, lock screen, wallpaper, etc). WiFi is managed via NetworkManager through the Noctalia control center.

Keybindings

Key	Action
Super + T	Terminal
Super + B	Open browser
Super + Space	App launcher
Super + Q	Close window
Super + Tab	Previous workspace
Super + M	Power menu
Super + Alt + L	Lock screen
Super + Ctrl + W	Random wallpaper
Print	Screenshot (full)
Ctrl + Print	Screenshot (screen)
Alt + Print	Screenshot (window)
Super + Y	Voice typing (hold)

Optional Services

Bluetooth

sudo systemctl enable --now bluetooth.service

Syncthing

Syncthing is a continuous file synchronization program.

systemctl --user enable --now syncthing

Access the web UI at localhost:8384 or search "Syncthing" in the app launcher.

Secrets Management (SOPS + AGE)

Personally I use SOPS with AGE for encrypting secrets in projects. My AGE private key is stored in 1Password and it's restored locally using the OP cli.

On a new machine:

make secrets.setup    # Restores key from 1Password to ~/.config/sops/age/keys.txt

Backup your key (if generating a new one):

mkdir -p .config/sops/age
age-keygen -o .config/sops/age/keys.txt
make secrets.backup   # Shows key to copy to 1Password

The keys.txt file is gitignored and never committed.

Macropad

Macropad configuration is in macropad/macropad.ron. Upload using:

ansible-playbook --ask-become-pass ansible-scripts/macropad.yml