pwnagotchi-control-center

A menu-driven control center for managing a pwnagotchi device. Provides scripts to:

• Local operations: Flash/backup SD cards, edit config.toml, download pwnagotchi images
• Remote operations: Setup SSH connections (USB/Ethernet, Bluetooth PAN, Ethernet, WLAN AP), manage plugins, install SecLists, modify remote configs

Prerequisites

• whiptail (menu dialogs)
• wget, unzip (download/extract images)
• dd, mount, umount (SD card operations)
• ssh (remote operations)
• sudo access (for mounting, iptables, etc.)

Quick Start

1. Clone the repository:

   git clone https://github.com/itsdarklikehell/pwnagotchi-control-center.git
   cd pwnagotchi-control-center

2. Edit .config/config to match your setup:

   nano .config/config

3. Run the main menu:

   ./menu.sh

Configuration

All settings are in .config/config. Key variables:

Variable	Description	Default
BACKUP_DIR	Directory for backups	$PWD/Backups
SD_DEVICE	SD card device path	/dev/sdc
ROOT_MOUNT_DIR	Root partition mount point	/media/usb0
BOOT_MOUNT_DIR	Boot partition mount point	/media/usb1
PWNAGOTCHI_USERNAME	SSH username	pi
PWNAGOTCHI_HOSTNAME	Device hostname	wifikirby
PWNAGOTCHI_VERSION	Image version to download	v1.5.5
PWNAGOTCHI_BTIP	Bluetooth IP	10.0.0.2
PWNAGOTCHI_USBIP	USB IP	10.0.0.2
PWNAGOTCHI_ETHIP	Ethernet IP	192.168.1.6
PWNAGOTCHI_WLANIP	WLAN IP	192.168.1.6
CUSTOM_PLUGIN_DIR	Custom plugins path	/home/pi/pwnagotchi-control-center/pwnagotchi-plugins-contrib
HANDSHAKE_DIR	Handshakes directory	/root/hanshakes

Usage

Local Scripts (Scripts/Local/)

Script	Description
download.sh	Download pwnagotchi image
flash.sh	Flash image to SD card
backup.sh	Backup SD card to image
pull-files.sh	Extract files from SD card
push-files.sh	Copy files to SD card
modconf.sh	Edit config.toml on SD card

Remote Scripts (Scripts/Remote/)

Script	Description
setup-conn-usb.sh	Setup USB-Ethernet gadget connection
setup-conn-bt.sh	Setup Bluetooth PAN connection
setup-conn-eth.sh	Setup Ethernet connection
setup-conn-wlan.sh	Setup WLAN AP connection
mod-pwnagotchi-conf.sh	Edit remote config.toml
mod-plugin-conf.sh	Edit remote plugin config
install-seclists.sh	Install SecLists wordlists
plugin-install.sh	Install a plugin
plugin-enable.sh	Enable a plugin
plugin-disable.sh	Disable a plugin
reboot.sh	Reboot the pwnagotchi

Connection Setup

The connection setup scripts configure IP forwarding and NAT to share your internet connection with the pwnagotchi. They support:

• USB-Ethernet gadget: Connect via USB, appears as enx* interface
• Bluetooth PAN: Connect via Bluetooth, appears as bnep* interface
• Ethernet: Direct Ethernet connection
• WLAN AP: Connect to pwnagotchi's access point

Each script will:

1. Ask for the interface name
2. Validate the interface exists
3. Configure IP forwarding and NAT
4. Test connectivity

See: (references)

---

Gource Visualization

De ontwikkelhistorie van dit project in een film:

De video wordt automatisch gegenereerd door de Gource workflow bij elke push.

Lokale video genereren:

gource --max-files 1000 --key -800x600 \
  --highlight-users --filename-time 3 --output-framerate 25 \
  -s 0.6 --multi-sampling --auto-skip-seconds 0.1 \
  --stop-at-end --hide mouse,progress -o gource.ppm
ffmpeg -y -r 15 -f image2pipe -vcodec ppm -i gource.ppm \
  -vcodec libx264 -preset medium -pix_fmt yuv420p \
  -crf 1 -threads 0 -bf 0 gource.mp4