ptztrack

Settings

Health

loading…

Diagnostic recording

Capture full state @ 10 Hz to a file. Start before triggering the weirdness, stop after, then download the JSONL for analysis.

Service control

Restart the ptztrack service from here. The web UI will reconnect automatically once the service is back (~3-5 s).

Download backup

Tracker events

Recent lock/lose events. Helps diagnose "tracking randomly stops".

Service logs

Last 100 lines of the systemd journal.

About

Site & identity

Where the camera physically lives. Edits apply live (no restart).

Camera feed (overlay)

Streams to play in the draggable overlay. WHEP mode talks directly to MediaMTX's /whep endpoint (clean WebRTC, no iframe). Two URLs = swap button in the overlay header to toggle between visible / thermal.

Camera connection

TCP control + telemetry for the PTZ camera. Save will reconnect the driver automatically (no service restart).

Web server bind

Where this UI listens. Changes require a service restart.

Authentication

HTTP Basic auth. When enabled, the API + UI require user/password. Local connections (127.0.0.1) can be exempted.

System overview

Boresight calibration

Aim camera at a target of known lat/lon/alt, then capture. 3+ targets recommended. Stop tracking first so the servo doesn't fight your manual slew.

CAM_PAN_ZERO_DEG— mount.pan_offset— mount.tilt_offset—

Preset

Nudge — fine-tune before capturing

After ↗ Aim, use these to bypass the deadband and finalize centering. Or press arrow keys (this tab only).

step

label	true az	cam pan	Δpan	true el	cam tilt	Δtilt
no captures yet

Applied as mount.pan_offset (live, no restart). For a cleaner config, set CAM_PAN_ZERO_DEG=— in the systemd unit and re-run calibration to zero the residual.

Raw mount & boresight

Direct edit. Changes apply live (no restart). Wrong values will make tracking point at the wrong sky — write them down before changing.

PID gains (live)

Servo loop PID. Changes apply on the next 30 Hz tick (integral term resets on save). Use ↗ Aim → Fisher Peak as a step test — watch the CMD readout in the bottom bar.

Aircraft data source

Where ptztrack pulls aircraft positions from. Changes apply live.

Mount history (0)

Every change to mount params is snapshotted. Click any row to revert.

when	roll	pitch	pan_off	tilt_off	cpz	RMS
no history yet

Excluded records (0)

Records soft-pruned by Re-solve. Never deleted — restore any time.

idx	flight	residual	reason	when
no exclusions

CAM — / — —

TGT — / —

ERR — / —

CMD — / — dps

LAT ADS-B: — KF: — CMD: —

FOV vis —° thr —°