Manage Streams (server-saved)

Name

Path or Full URL

Import JSON

Current Streams

Order	Name	Path / URL	Send to	Actions

Drag rows using the ⇅ handle to reorder. Saves to server.

Settings

HLS Base URL

Viewer Stats URL (optional)

For Nginx RTMP stats (XML) or MediaMTX (JSON). Leave blank to auto-detect.

Set Passcode for Public Viewer

Set new passcode for each event. DO NOT SHARE PASSCODES WITH UNAUTHORIZED PERSONNEL.

Current Passcode: Hidden

Visible to admins only. Public viewers receive hash validation only.

User Access

Approve registrations, grant admin access, and reset passwords.

Email	Role	Approval	Actions

Settings & Streams persist to server.

User Guide

FlightWatch User Manual v 2025-10-28

FlightWatch is an HLS video wall for operations centers. No in-app login. Streams & Settings persist through the server API (/api/*). Protect the dashboard and write methods with Basic Auth.

At a glance: RTMP ingest → HLS origin. This page consumes HLS at /hls/<key>/index.m3u8.

1) Quick Start

Open the dashboard over HTTPS (Basic Auth).
Click Streams to add/assign streams. Set Base URL in Settings.

2) Adding & Sorting Streams

Open Streams → enter Name and a Path or Full URL.
Assign via Send to… or drag the sidebar card onto a tile.
Reorder: drag cards (sidebar) or rows (Streams modal ⇅ handle). Saves to server.
Swap tiles: drag a tile’s ⇅ Slot badge onto another tile.

3) Base URL

final_url = BaseURL_without_trailing_slash + path_without_leading_slash

4) Layouts & Assignments

Quad / Single / Side-by-Side / Six-Pack (3×2 on large screens); hidden tiles pause to save CPU.
Per-tile Reload & Fullscreen; labels show Slot & Stream name.

5) Playback & Autoplay

Attempts unmuted autoplay → fallback muted with overlay.
Unmute all clears overlays in one click.
Fatal errors auto-retry with backoff.

6) Keyboard Shortcuts

1–4 select slot • S/B/Q layouts
F fullscreen • R reload • M unmute-all • ? guide

7) Troubleshooting

Cannot save: Ensure the FlightWatch API service is running and write requests are authorized.
Black tile: Verify HLS URL, HTTPS/CORS, and origin segments.

8) Security & Deployment

Protect the site with Basic Auth + HTTPS (Nginx).
Limit write access on /api/.

9) Data Storage

/api/streams — shared streams list (server)
/api/settings — Base URL and stats URL (server)
Local only: layout & tile assignments via localStorage

10) Change Log

v2.0.0 (2026-06-30): Modular Vite/TypeScript admin architecture, hardened deployment, and source-controlled build pipeline.
v1.3.2 (2025-10-29): Settings manages the viewer passcode.
v1.3.1 (2025-10-28): New Offline state for non-live streams (red outline); background retries.
v1.3.0 (2025-10-28): Drag-sort streams (sidebar/modal). Tile swap via “⇅ Slot”.
v1.2.1 (2025-10-26): Server-save for streams/settings; guide improvements.
v1.1.x: Layouts, Unmute-all, drag-assign, resilient reload.