Repository navigation
WebUI Features
Full browser-based interface for remote control, monitoring, and data visualization
The RaspyJack WebUI runs on port 8080 (HTTP) and optionally on port 443 (HTTPS via Caddy). Access it at http://<CZ_IP>:8080 from any browser on the same network.
Authentication is required — set up a username (3+ chars) and password (8+ chars) on first access.
| Feature | Description |
|---|---|
| Remote Control | Live LCD screen mirror + virtual buttons — control CZ from your phone/laptop |
| Payload Studio | Browse, launch, stop payloads + search |
| Payload IDE | CodeMirror Python editor with file tree, save, run, live output |
| AI Assistant | On-device LLM chat via WebGPU (Phi-3.5, Llama 3.2, Qwen2.5) |
| System Monitor | btop-like dashboard with 4 CPU cores, RAM, swap, processes |
| Loot Browser | Browse, preview, download captured data + ZIP export |
| Settings | Discord webhook, WiGLE API, Tailscale VPN, themes |
| 14 Tool Pages | ADS-B, Wardriving, GNSS, Meteor, APRS, Honeypot, SDR, Scanner, PCAP, Kismet, Torrent |
| HTTPS | Auto-configured via Caddy with internal TLS certificates |
| Tailscale | Remote access from anywhere via Tailscale VPN |
The main dashboard provides a full remote control interface for the CardputerZero.
A <canvas> element displays the CZ LCD screen in real-time via WebSocket. The device server (device_server.py) captures the framebuffer and streams frames to connected browsers. Supports both 128x128 (ST7735) and 320x170 (CardputerZero) displays.
Click the on-screen buttons to send commands to the CZ — exactly like pressing physical buttons:
| Button | Action |
|---|---|
| ▲ ▼ ◄ ► | D-pad navigation (UP/DOWN/LEFT/RIGHT) |
| OK | Confirm / Enter (center of D-pad, green) |
| KEY1 | Extra action / switch mode |
| KEY2 | Secondary action / delete |
| KEY3 | Back / Exit |
The remote control UI comes in 3 visual themes, switchable with arrow buttons:
| Theme | Style |
|---|---|
| Neon (default) | Cyberpunk glow — dark background with emerald/cyan neon borders, glowing screen frame, translucent buttons |
| Game Boy | Retro Nintendo — gray plastic shell with green-tinted screen, round D-pad, colored A/B buttons |
| Pager | 90s pager — silver body with clip, speaker grille, green monochrome screen, physical-style buttons |
An xterm.js terminal provides a full remote shell to the CZ, directly in the browser. Supports colors, scrollback, and keyboard input.
The main dashboard (accessed via the sidebar) has 3 tabs:
- Payload list — all available payloads organized by category
- Search — type to filter payloads instantly
- Launch — click to start a payload, status indicator (green dot = running)
- Stop — stop running payload
- LCD screen mirror — live view of what's displayed on the CZ
| Setting | Description |
|---|---|
| Theme | Switch between Dark and Light mode |
| Discord Webhook | Set a Discord webhook URL to receive alerts and notifications from payloads |
| WiGLE Upload | Configure WiGLE API Name + Token for automatic wardriving data upload |
| Tailscale | Install and configure Tailscale VPN with an auth key for remote access |
Browse all captured data from the CZ filesystem:
- File tree — navigate folders (click to expand)
- File preview — click a file to view contents (text, images, audio playback)
- Download — download individual files
- Download folder (.zip) — download entire folder as ZIP archive
- Nmap results — parsed view of scan results
A full in-browser Python editor for creating and editing payloads:
| Feature | Description |
|---|---|
| File tree | Browse all payload files with folder navigation |
| CodeMirror editor | Python syntax highlighting (Monokai theme), line numbers, auto-indent |
| Save | Save edited file back to the CZ |
| Run | Execute the payload directly and see output |
| Live output | Console panel shows stdout/stderr in real-time |
| Rename | Rename files/folders with modal dialog |
| Delete | Delete files with confirmation |
| Unsaved changes | Warning before navigating away from unsaved edits |
On-device LLM inference using WebGPU — no cloud, no API keys, fully offline:
| Feature | Description |
|---|---|
| WebGPU inference | Runs entirely in the browser using WebLLM (@mlc-ai/web-llm) |
| Chat interface | Full conversation with message history |
| Model selection | Grid of available models with size and description |
| Cached models | Downloaded models are cached in IndexedDB for instant reload |
| Model | Parameters | VRAM | Description |
|---|---|---|---|
| Phi-3.5 Mini | 3.8B | ~2.5 GB | Best quality, code + multilingual |
| Llama 3.2 | 3B | ~2.3 GB | Great conversation |
| Llama 3.2 | 1B | ~0.9 GB | Lightweight, fast |
| Qwen2.5 | 1.5B | ~1.6 GB | Code + math |
Note: Requires HTTPS (WebGPU is only available in secure contexts). The page auto-redirects to HTTPS if accessed over HTTP. Use Caddy or Tailscale for HTTPS access.
btop-like system dashboard with real-time data (polls every 2 seconds):
| Section | Features |
|---|---|
| CPU | 4 per-core progress bars (color-coded green/yellow/red) + individual sparkline graphs (2x2 grid, each core with its own color: cyan, green, orange, purple). Aggregate % displayed as large number. Load averages (1m/5m/15m) |
| Memory | Used/Total/Free with cyan progress bar |
| Swap | Used/Total/Free with orange progress bar (hidden if no swap active) |
| Disk | Used/Total/Free with purple progress bar |
| Processes | Sortable table (PID, name, CPU%, MEM%), live search filter, click to inspect, kill button per process |
| Network | Interface badges showing name + IP for all active interfaces |
| Temperature | CPU temperature with mini sparkline graph in topbar |
| Payload | Currently running payload name + green pulse dot |
| Uptime | System uptime in topbar |
| Hostname | Displayed in topbar and network section |
All data from GET /api/system/status.
| Feature | Description |
|---|---|
| Aircraft markers on map | Callsign, altitude, speed, heading |
| Flight trails | Polyline showing aircraft path |
| Aircraft database | Registration, type code, operator lookup |
| Airline + route | Departure/arrival airport lookup |
| Session recording | Save session data for later review |
| Live start/stop | Start/stop ADS-B receiver from WebUI |
| Theme selector | 4 map themes (Dark/Satellite/Topo/OSM) |
| Feature | Description |
|---|---|
| AP markers | Color-coded by security (WPA3=green, WPA2=cyan, WPA=orange, WEP=orange, Open=red) |
| Signal strength | Visual indicator per AP |
| Live mode | Real-time capture with GPS tracking |
| Session history | Browse and replay past wardriving sessions |
| Route polyline | GPS track overlay on map |
| Hide/show APs | Filter individual networks |
| Theme selector | 4 map themes |
| Feature | Description |
|---|---|
| 3D Globe | Satellite positions on interactive globe |
| Skyplot | Polar view of visible satellites with elevation/azimuth |
| Map | Position + accuracy circle + movement trail |
| Satellite cards | Per-satellite SNR, elevation, azimuth, constellation |
| Stats | Count by constellation (GPS/GLONASS/Galileo/BeiDou/QZSS) |
| Set Position | Manual lat/lon input for devices without GPS |
| Live toggle | Start/stop GNSS tracking |
| Feature | Description |
|---|---|
| Pass prediction | Next satellite passes with countdown timer |
| Ground track map | Satellite orbit displayed on map |
| Capture control | Start/stop satellite image capture |
| Image gallery | Browse decoded satellite images |
| Set Position | Manual position for pass calculations |
| Feature | Description |
|---|---|
| Station map | APRS stations with distance and bearing from observer |
| Real-time packets | Live decoded APRS data |
| Farthest station | Distance metric in toolbar |
| Set Position | Manual position input |
| Feature | Description |
|---|---|
| Live event feed | Real-time attack detection |
| 40+ exploit patterns | SSH brute-force, web exploits, SMB, FTP, etc. |
| Credential extraction | Captured usernames/passwords |
| Session history | Browse past honeypot sessions |
| SOC dashboard | Attack statistics and visualizations |
| Feature | Description |
|---|---|
| Waterfall display | Real-time spectrogram |
| Spectrum analyzer | Frequency vs power graph |
| Frequency tuning | Click to tune + manual frequency input |
| Zoom | Adjust bandwidth view |
| Recording | Record IQ samples |
| Bookmarks | Save and recall frequencies |
| Feature | Description |
|---|---|
| Band presets | Pre-configured FM/AM/Air bands |
| Live audio | Stream demodulated audio |
| FM station database | Station lookup by frequency |
| Scanner control | Start/stop/tune from WebUI |
Browser-based network packet capture analysis — upload or browse PCAP files from loot.
WiFi and Bluetooth scanner via Kismet daemon:
- Proxied through RaspyJack WebUI (Kismet listens on 127.0.0.1:2501)
-
KISMET_URI_PREFIXinjected for correct routing - Auto-starts daemon on first access
- Stop button in sidebar (conditional — only shown when running)
- Kismet's own authentication (default: kismet/kismet)
BitTorrent client via transmission-daemon:
- Proxied through RaspyJack auth (Transmission listens on 127.0.0.1:9091)
- Full Transmission WebUI with all features
- Auto-starts daemon on first access
-
/rpcendpoint also proxied for API calls
All map pages share the same 4 themes via map-styles.js:
| Theme | Provider | Background | API Key |
|---|---|---|---|
| Dark | OpenStreetMap | #0d1117 |
None |
| Satellite | Esri/ArcGIS | #0a0a0a |
None |
| Topo | OpenTopoMap | #1a1a2e |
None |
| OSM | OpenStreetMap | #e8e8e8 |
None |
All providers are free with no API key required. Theme selection is saved in localStorage and persists across sessions.
Each map page has an HTML <select> in the toolbar for theme switching.
| Feature | Description |
|---|---|
| First-time setup | Create username (3+ chars) and password (8+ chars) |
| Session cookie |
rj_session with configurable timeout (default 2 hours) |
| Signed tokens | HMAC-signed JWT-like session tokens |
| API token | Bearer token support for programmatic access |
| Rate limiting | 6 failed login attempts per 10 minutes per IP |
| Auth file | Credentials stored in /root/Raspyjack/.webui_auth.json (chmod 600) |
RaspyJack can serve over HTTPS using a Caddy reverse proxy:
| Feature | Description |
|---|---|
| Auto-generated Caddyfile | Generated from current network interfaces (eth0, wlan0, tailscale0) |
| Internal TLS | Self-signed certificates via Caddy's tls internal
|
| Reverse proxy | Caddy on :443 → RaspyJack on :8080 |
| WebSocket proxy | Device server WebSocket also proxied |
| Auto-reload | Caddyfile regenerated when Tailscale connects |
Required for: AI Assistant (WebGPU needs secure context), remote access over untrusted networks.
Remote access from anywhere via Tailscale:
| Feature | Description |
|---|---|
| One-click install | Install Tailscale from Settings tab with an auth key |
| Status monitoring | See Tailscale connection status, IP, hostname |
| Re-authentication | Re-auth with a new key if expired |
| Caddy integration | HTTPS auto-configured for Tailscale IP |
| SSH | Tailscale SSH enabled automatically |
Setup: Go to Settings → Tailscale → enter your auth key → Install. After that, access your CZ from anywhere via https://<tailscale-hostname>.
Send alerts and notifications from payloads to a Discord channel:
- Configure in Settings tab → Discord Webhook → paste URL → Save
- Validated format: must start with
https://discord.com/api/webhooks/ - Used by payloads for: handshake captures, deauth alerts, honeypot events, etc.
Automatically launch a payload when RaspyJack boots:
- Configure in
loot/Autostart/autostart.json - Set
{"autostart": "category/payload_name.py"} - The payload launches automatically after RaspyJack UI starts
- Set to
""or delete the file to disable
For devices without GPS, position can be set manually via the Set Pos button (available on GNSS, Meteor, and APRS pages):
-
GET /api/system/location— returns current position (source: gnss / manual / none) -
POST /api/system/set_location— saves manual lat/lon toconfig/observer.json
Fallback chain used by all location-aware payloads:
- GNSS live (
/dev/shm/rj_gnss_live.json) - Manual config (
config/observer.json) - IP geolocation (ip-api.com)
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/auth/bootstrap-status |
Check if admin account exists |
| POST | /api/auth/bootstrap |
Create initial admin account |
| POST | /api/auth/login |
Login with username/password |
| POST | /api/auth/logout |
Clear session |
| GET | /api/auth/me |
Get current user info |
| POST | /api/auth/ws-ticket |
Get WebSocket auth ticket |
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/system/status |
CPU (per-core), memory, swap, disk, temp, load, processes, interfaces, payload status |
| POST | /api/system/kill_process |
Kill a process by PID |
| POST | /api/system/restart-ui |
Restart RaspyJack UI service |
| GET | /api/system/location |
Get current position (GNSS/manual) |
| POST | /api/system/set_location |
Set manual position |
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/payloads/list |
List all available payloads |
| GET | /api/payloads/tree |
Payload file tree |
| GET | /api/payloads/status |
Running payload info |
| GET | /api/payloads/file |
Read payload source file |
| POST | /api/payloads/start |
Launch a payload |
| POST | /api/payloads/entry |
Create/edit payload entry |
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/loot/list |
Browse loot directory |
| GET | /api/loot/view |
Preview file contents |
| GET | /api/loot/download |
Download file |
| GET | /api/loot/archive |
Download folder as ZIP |
| GET | /api/loot/nmap |
Parsed Nmap results |
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/adsb/live |
Live aircraft data |
| POST | /api/adsb/start |
Start ADS-B receiver |
| GET | /api/gnss/live |
Live GNSS data |
| GET | /api/aprs/live |
Live APRS stations |
| GET | /api/meteor/live |
Meteor receiver status |
| GET | /api/meteor/gallery |
Satellite image gallery |
| GET | /api/sdr/start |
Start SDR suite |
| GET | /api/scanner/live |
Radio scanner live data |
| GET | /api/scanner/fm_stations |
FM station database |
| GET | /api/ism/live |
ISM decoder live data |
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/wardriving/live |
Live wardriving data |
| GET | /api/wardriving/sessions |
List wardriving sessions |
| GET | /api/wardriving/session |
Load specific session |
| GET | /api/honeypot/live |
Live honeypot events |
| GET | /api/honeypot/sessions |
List honeypot sessions |
| Method | Endpoint | Description |
|---|---|---|
| GET/POST | /api/settings/discord_webhook |
Get/set Discord webhook URL |
| GET/POST | /api/settings/tailscale |
Tailscale status/install/key |
| GET/POST | /api/settings/wigle |
WiGLE API credentials |
| Path | Target | Description |
|---|---|---|
/torrent/* |
127.0.0.1:9091 | Transmission WebUI (auth: RaspyJack session) |
/kismet/* |
127.0.0.1:2501 | Kismet WebUI (auth: kismet/kismet) |
/rpc |
127.0.0.1:9091 | Transmission RPC (for JS client calls) |
/kismet/stop |
— | Stop Kismet daemon |
/kismet/status |
— | Check if Kismet is running |
RaspyJack is for educational and authorized testing only. Use responsibly.
RaspyJack Wiki
Getting Started
Using RaspyJack
Payloads
Built-in Tools
Utilities
Reference
Radio & SDR
NFC & RFID
WebUI
Hardware