bspwm-config

Personal bspwm backup repo for fresh installs. This repo is for restoring my Linux desktop environment on a new machine with a single bootstrap flow instead of piecing configs back together by hand.

Quick start:

git clone https://github.com/nassimna/bspwm-config.git
cd bspwm-config
./bootstrap.sh --yes

Included

• .config/bspwm
• .config/polybar
• .config/conky
• .config/autostart
• .config/ghostty
• .tmux.conf
• .local/bin/audio-profile
• .config/pipewire
• .config/wireplumber
• .local/share/pipewire-echo-fix (rollback snapshots + restore script)

Recommended restore (fresh install)

git clone https://github.com/nassimna/bspwm-config.git bspwm-config
cd bspwm-config
./bootstrap.sh --yes

Preview what will be installed first:

./bootstrap.sh --list-packages

bootstrap.sh does:

• best-effort dependency install (supports pacman, apt, dnf, zypper)
• config restore to configurable target paths
• sxhkd compatibility symlink creation (~/.config/sxhkd/sxhkdrc -> bspwm sxhkdrc)
• post-restore validation (check-deps.sh)

Custom target paths

Use these flags if your environment uses different locations:

./bootstrap.sh \
  --config-home "$HOME/.config" \
  --bspwm-dir "$HOME/.config/bspwm" \
  --sxhkd-dir "$HOME/.config/sxhkd"

To skip package installation:

./bootstrap.sh --skip-deps

If you only want to copy configs (no dependency install logic), use:

./install.sh

audio-profile local file dependencies are included in this repo.

Runtime requirements

• pactl (PulseAudio/PipeWire utilities)
• rg (ripgrep)
• systemctl (user services: pipewire, pipewire-pulse, wireplumber)

Full sweep + validation

See RESTORE-CHECKLIST.md for:

• what was discovered in the .config dependency sweep
• external files still needed outside this repo
• command/runtime requirements

Run a quick validation after restore:

./check-deps.sh