Bundled command-line interface

Automation and export

Run repeatable file, folder, reference-pair, and stream analysis with corevq. Licensed builds export versioned CSV and JSON from the same engine as Studio.

Command surface

Analyze individual media, folders, reference pairs, or streams with the bundled corevq command line.

Details

Analyze one image or video

No-reference perceptual measurement.

corevq --json --profile mixed_source \
  subjective input.mp4 -n 3 -o result

Analyze a media tree

Recursive batch analysis with one workbook.

corevq --json --profile hd_content \
  subjective-folder media/ -n 3 -o batch

Compare a reference pair

Every same-index pair in the decoded common prefix contributes to VMAF, PSNR, and SSIM. Unequal input coverage is exported as incomplete and returns exit 1.

corevq --json full-reference \
  reference.mp4 candidate.mp4 -o comparison

Probe or monitor a stream

Startup-only check or bounded transport/content window.

corevq stream-check "https://example/media.mp4" -o startup
corevq stream-monitor "rtsp://example/live" \
  --window 30 --duration 120 -o monitor

Explicit configuration

Set the profile, analysis mode, sampling, range, and output options explicitly for repeatable measurements.

Details

Profilehd_contentsd_contentcamcordermobilewebcammastered_contentmixed_source

Analysis modefastbalancedfull

Source context--content-tier--capture-class--content-style--lighting-state--target-use

Global options precede the command for portable invocation. Profiles are explicit; there is no automatic profile mode.

-n N and --frames N accept an integer of at least 1 and analyze every Nth decoded frame in the no-reference perceptual path. This is a sampling interval, not a maximum frame count. Full-Reference Analysis still processes every decoded index pair in the common prefix for VMAF, PSNR, and SSIM; N applies only to the candidate's accompanying no-reference analysis.

Versioned output contract

Licensed builds export CSV and JSON with named fields, result states, model identities, and measurement provenance.

Details

CSV: UTF-8 header and deterministic field order
JSON: Workbook arrays plus structured _corevq metadata
Unavailable numbers: Empty CSV cell / JSON null

Contract: Versioned field names and measurement provenance
Compatibility rule: Read by field name, tolerate new fields, preserve unknown JSON members
Conversion: corevq json2csv input.json output

Identity and source

Input, codec, resolution, bitrate, profile, source class, style, lighting, target use, frame interval, and analysis mode.

Result and evidence

Score, grade, type, status, reason, confidence, coverage, samples, scenes, transitions, core score, and support penalty.

Provenance

Scoring, calibration, metric, evidence, and export versions plus model identity/checksum in structured JSON.

Cancellation and process status

Check process status alongside the result. Cancellation may retain usable partial evidence.

Details

CLI exit codes
Exit	Meaning
0	Completed, informational command, or graceful command with valid decoded evidence.
1	A one-shot analysis decoded no frames, Full-Reference Analysis failed or ended with incomplete input coverage, stream checking, conversion, or output failed, or a folder contained no supported media. Incomplete Full-Reference metrics remain exportable.
2 / parser code	Invalid syntax, missing argument, or rejected option value.

Ctrl-C requests graceful cancellation. Consumers must inspect both the process exit code and exported result status; an output file alone does not prove a complete analysis.