Skip to main content

Reviewing Saved Results

Analyses of long files take time. Save the results once with -o, and review them later in the terminal view with view, without running the analysis again.

Opening a saved run​

surfmeter-media analyze -o results/channel1 channel1.ts
surfmeter-media view results/channel1/records.ndjson

The view is the same as with --tui during the analysis: timeline, summary and events. Press ? for the list of keys (see Basic Usage).

The results of compare open in the comparison view, with the reference and all encodes:

surfmeter-media view results/ladder/records.ndjson

Audio​

When the run has loudness results, the view shows them in two places:

  1. The timeline has a "Loudness M/S" track below the other tracks. It shows the short-term loudness as a bright line and the momentary loudness as a dim line, in LUFS. The level of the first loudness target is drawn as a dotted line.

  2. The audio panel shows the audio stream of the selected input:

    • meters for the momentary (M), short-term (S) and integrated (I) loudness and the true peak (TP)
    • the loudness range (LRA), and the highest momentary and short-term loudness
    • for AC-3 and E-AC-3, the dialnorm, the integrated loudness minus the dialnorm, and the number of dialnorm changes
    • PASS or FAIL for each loudness target, with the deviation in LU and the checks that failed
    • peak and RMS level of each channel

If the input has more than one audio stream, press a to switch to the next one. The loudness track and the audio panel then show that stream.

Comparing runs​

Pass several record files to view to show the runs side by side, without decoding anything. This is useful to compare:

  • the same channel recorded on different days, for example before and after a change of the encoder configuration
  • two encoders that received the same feed
  • results from different sites
surfmeter-media view results/2026-09-28/records.ndjson results/2026-10-05/records.ndjson

The inputs of all runs are drawn as tracks on the same timeline. Select an input with 1–9, or [ and ], and press v to switch between the comparison and the analysis view.

Following a running analysis​

view - reads the records from standard input while they arrive. You can use this to watch an analysis on a remote server from your own terminal:

ssh encoder-01 'surfmeter-media analyze -q /srv/recordings/channel1.ts' \
| surfmeter-media view -

The analysis runs on the server, while the terminal view runs locally.

Saving snapshots​

Press s in the view to save a snapshot of the current state. The toolkit writes two files into the current directory (or into the output directory of the run):

  • surfmeter-media-<time>.txt: the screen as text, for example to paste into a ticket or an e-mail
  • surfmeter-media-<time>.json: the summary shown on screen

view does not change the saved files and does not compute missing metrics. To add metrics to a saved run, run analyze or compare again with --tui and select the metrics with m.