pwnbox documentation
pwnbox is a portable, hardened NixOS + home-manager configuration for hacking, reverse engineering, Active Directory and networking. It ships a Hyprland desktop (with GNOME as a second session) driven by Quickshell, and a wallpaper-driven theming system that reaches every app.
This folder is the full manual. Start with Getting started and jump to whatever you need.
| Document | What it covers |
|---|---|
| Getting started | Install, first boot, updates, host config |
| Desktop | Hyprland, GNOME, Quickshell, sessions |
| Keybinds | Every keyboard shortcut |
| Themes | Wallpaper themes, custom themes, the ALT+S menu |
| Fonts | System/application fonts and sizes |
| Apps | Per-app theming and live updates (Spotify, Discord, Telegram…) |
| Packages | Tool categories and optional app sets |
| Privacy | Hardening and zero-trace defaults |
| Architecture | Repo layout and how a theme switch works |
| Troubleshooting | Common problems and fixes |
| Development | Add themes, packages and bar styles |
At a glance
- One settings menu ALT+S changes theme, wallpaper, bar style, corner radii, fonts, font sizes, blur, transparency and animations.
- Everything follows the wallpaper colours are extracted with pywal and applied to the bar, terminal, launcher, notifications, editor, GTK apps and chat clients.
- Live app theming Spotify, Discord (Equibop) and Telegram (AyuGram) update while they are running, without quitting them.
- Reproducible nothing is downloaded at runtime; every tool, theme and font is provided by the flake.
Conventions used here
- Paths starting with
~are relative to the primary user's home. - ALT+S opens the theme/settings menu unless stated otherwise.
- Commands are shown for the default setup; replace the host name if you installed under a different one.