Skip to content

WebUI Features

7h30th3r0n3 edited this page Aug 31, 2026 · 3 revisions

🌐 WebUI Features

Full browser-based interface for remote control, monitoring, and data visualization


📋 Overview

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

🎮 Device Remote Control

The main dashboard provides a full remote control interface for the CardputerZero.

Live LCD Screen Mirror

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.

Virtual Buttons

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

Device Shell Themes

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

Terminal

An xterm.js terminal provides a full remote shell to the CZ, directly in the browser. Supports colors, scrollback, and keyboard input.


📦 Payload Studio

The main dashboard (accessed via the sidebar) has 3 tabs:

Device Tab

  • 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

Settings Tab

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

Loot Tab

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

💻 Payload IDE (/ide.html)

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

🤖 AI Assistant (/llm.html)

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

Available Models

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.


📊 System Monitor (/monitor.html)

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.


📡 Tool Pages

ADS-B Radar (/adsb.html)

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)

Wardriving Map (/wardriving.html)

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

GNSS Tracker (/gnss.html)

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

Meteor Receiver (/noaa.html)

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

APRS Monitor (/aprs.html)

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

Honeypot SIEM (/honeypot.html)

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

SDR Suite (/sdr.html)

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

Radio Scanner (/scanner.html)

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

PCAP Analyzer (/pcap.html, /pcap-analyzer.html)

Browser-based network packet capture analysis — upload or browse PCAP files from loot.

Kismet Scanner (proxied at /kismet/)

WiFi and Bluetooth scanner via Kismet daemon:

  • Proxied through RaspyJack WebUI (Kismet listens on 127.0.0.1:2501)
  • KISMET_URI_PREFIX injected 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)

Torrent Client (proxied at /torrent/)

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
  • /rpc endpoint also proxied for API calls

🗺️ Map Themes

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.


🔐 Authentication & Security

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)

🌐 HTTPS via Caddy

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.


🔗 Tailscale VPN

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>.


🔔 Discord Webhook

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.

⚡ Autostart

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

📍 Manual Position

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 to config/observer.json

Fallback chain used by all location-aware payloads:

  1. GNSS live (/dev/shm/rj_gnss_live.json)
  2. Manual config (config/observer.json)
  3. IP geolocation (ip-api.com)

🔌 API Endpoints

Authentication

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

System

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

Payloads

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

Loot

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

Radio & SDR

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

Wardriving & Honeypot

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

Settings

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

Proxied Services

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

Clone this wiki locally