redpill

Backup and restore tool for Hyprland configuration files.

"You take the red pill, you stay in Hyprland and I show you how deep the rabbit-hole goes"

Credits

Inspired by 28allDay's video.

Features

• Backup your Hyprland stack configs (hypr, waybar, mako, etc.)
• Restore from any backup archive
• TUI interface with whiptail (falls back to select menu)
• Configurable include list
• Supports zstd or gzip compression

Installation

sudo cp redpill /usr/local/bin/
sudo chmod +x /usr/local/bin/redpill

Optionally, add the desktop entry:

cp redpill.desktop ~/.local/share/applications/

Usage

redpill              # Launch TUI
redpill backup       # Create backup
redpill restore      # Restore latest backup
redpill restore FILE # Restore specific backup
redpill list         # List backups
redpill includes     # Edit include list
redpill where        # Show paths

Configuration

Edit ~/.config/redpill/includes.conf to customize which paths to backup:

~/.config/hypr
~/.config/waybar
~/.config/mako
~/.config/hyprpaper
~/.config/hypridle
~/.config/wlogout
~/.config/kanshi
~/.config/walker
~/.config/swayosd
~/.config/uwsm

Dependencies

• bash
• rsync (for restore)
• whiptail (optional, for TUI)
• zstd (optional, falls back to gzip)

Storage

• Backups: ~/.local/state/redpill/backups/
• Config: ~/.config/redpill/