BSPWM Themes

Centralized registry and one-command installer for BSPWM themes.

---

This is not a theme — it is a hub. Each theme lives in its own repository. This project provides a central registry (themes.json) and a universal installer that handles discovery, dependency checks, and deployment in a single command.

---

Requirements

git · jq · bash

# Arch
sudo pacman -S git jq

# Kali / Parrot
sudo apt install git jq

---

Usage

git clone https://github.com/Crypt0xDev/Bspwm-Themes.git
cd Bspwm-Themes
chmod +x scripts/install.sh

./scripts/install.sh --list          # Browse available themes
./scripts/install.sh hacker-matrix   # Install a theme
./scripts/install.sh --help          # Show all options

The installer detects your distro, clones the theme repository into /tmp/bspwm-themes-hub/, and executes its install.sh.

---

Catalog

ID	Name	Author	Type	Distros
hacker-matrix	Hacker Matrix	Crypt0xDev	🟢 official	Arch, Kali, Parrot
nordic-frost	Nordic Frost	fr0stdev	🔵 community	Arch, Parrot
crimson-void	Crimson Void	voidhacker	🟡 custom	Kali, Parrot

🟢 official — maintained by Crypt0xDev · 🔵 community — contributed · 🟡 custom — personal setups

---

Contributing a Theme

Add an entry to themes.json and open a Pull Request:

{
  "id": "your-theme-id",
  "name": "Your Theme Name",
  "author": "yourhandle",
  "type": "community",
  "repo": "https://github.com/yourhandle/bspwm-your-theme",
  "description": "One line description.",
  "distros": ["arch", "kali", "parrot"]
}

Your repository must include an install.sh at the root. The hub executes it with no arguments — handle everything inside it.

Recommended structure:

bspwm-your-theme/
├── install.sh      ← required
├── config/
│   ├── bspwmrc
│   └── sxhkdrc
├── polybar/
└── rofi/

---

License

MIT — see LICENSE

---

_{Built by Crypt0xDev}