Skip to content

Alerts and analysis

Alerts are shared records of conditions that need attention: an aircraft’s or module’s health warnings, recording failures, and conditions modules raise. Acknowledge an alert to show it has been seen, then resolve it when the condition has been handled. Events provide the surrounding time-ordered activity, including command outcomes.

The optional detections module analyzes authorized camera feeds with the configured vision models. Analysis sessions have concurrency, duration, and interval limits. The module needs an API key and may incur model charges. Opening the panel does not establish that a model is available or that an inference has succeeded.

A capture is one still frame from an aircraft’s video at a known moment, kept apart from the recording. Pilots and the analyst module create the same kind of record, and everyone annotates it in the same place.

Take one with the camera button on a Video panel, the P key with an aircraft selected, D-pad up on a DualSense, a bound RC controller button, ⌘K → Capture frame, or an aircraft’s menu. When a Video panel shows the aircraft, the exact frame on screen is uploaded; otherwise Mainframe takes one from the live feed, or from the recording when the workspace is replaying the past. A toast offers to open the capture. Every capture is also an event, so it appears in Events, as a marker on the timeline bar, and as a camera glyph on the Map at the aircraft’s position. Click the glyph to select the capture (the Selection panel shows its frame and details; its notes are in the Captures panel); double-click it to open the Captures panel on it.

The Captures panel lists captures newest first, filtered to All, Mine, AI, or Clips. Each shows the frame with its annotations. Press B or the box tool and drag to draw a box, type a label and press Enter. Press Enter to write a note; select a box first to attach the note to it. Notes on captures and on clips take mentions (@), reactions, edits and copy exactly like notes on markings (see Markings). Boxes and notes show who made them: analyst boxes carry a confidence, and people can edit and delete only their own annotations. Analyze asks the detections module to describe the frame and box what it sees, appending to whatever is already there.

j/k move between captures. Download saves the original JPEG; the second download button saves a PNG with the boxes and labels burned in. The toolbar’s clock button jumps the whole workspace to the capture’s moment (a clip’s start), and the target button shows where the camera was on the Map. Delete is under … and offers Undo.

Capture stills live in the blob bucket under blobs/captures/, apart from recorded video, and are not subject to media retention. Capture records are documents in Postgres.

Use Charts and Events to compare a suspected event with battery, link quality, altitude, and command outcomes. Recorded measurements and operator review remain the evidence when an automated interpretation is wrong.