Setup and Deploy

Setup & Deploy

First time

1. Clone or download this repo to your own computer (not the Pager).
2. Copy config.txt.example to config.txt and fill in your device's real IP and SSH password. config.txt is gitignored - it never gets committed, and this wiki/repo never contains your real credentials.
3. Run the installer:

python setup.py

This uploads every script under scripts/ to /root/scripts/ on the Pager, deploys the 8 payloads under payloads/ to the on-screen Payload menu, sets up command aliases so you can just type battery.sh instead of the full path, adds /root/scripts to PATH, installs python3 + scapy (needed by a couple of scripts), starts the usb_monitor.sh background watcher and makes it survive a reboot, and sets a Control Panel access token.

Everyday use

python setup.py            # incremental - only pushes what changed since the last push
python setup.py --force    # ignore the incremental cache, push everything
python sync.py              # wait for SSH to come back up, then run setup.py
python sync.py --watch      # keep watching scripts/ and payloads/ for local changes, auto-push

sync.py exists because the Pager's SSH isn't always up (rebooting, unplugged, mid-reconnect) - it retries quietly instead of failing outright.

Once deployed

SSH in and just run any script by name (aliases mean you don't need the full /root/scripts/ path):

ssh root@<device-ip>
battery.sh
sniff.sh --help

Every script also supports no-arguments interactive mode, and every payload is reachable from the Pager's own on-screen Payload menu without SSH at all.

Optional: the Control Panel

A local web dashboard (scripts/guiserver/) that shells out to the same scripts you'd run over SSH - nothing it does bypasses the official commands underneath. Binds only to br-lan (Management WiFi / USB-C), never the internet-facing uplink. Start it with:

webui.sh --start

See Shared Library & Testing for more, or Device & Platform for webui.sh's own --help.