Skip to content
Documentation Vidshots
CLI reference /

Vidshots

Inspect captures, frames, and narration.

On this page

Usage

muesli-cli captures list --limit 5
muesli-cli captures get latest --manifest
muesli-cli captures frames latest
muesli-cli captures zoom latest --at 0:12
# If the capture contains mark m1:
muesli-cli captures zoom latest --mark 1

list: newest first; --limit defaults to 10 and must be positive.

get: summary, state, paths, and failures. --manifest adds the manifest. frames returns saved keyframes and a contact sheet.

zoom: choose --at M:SS (±2 seconds) or --mark N (mark mN plus one second on each side). Returns up to six frames and narration, saved locally under zoom/.

latest may still be recording, processing, or failed. Busy captures cannot be zoomed. Reuse an explicit ID across commands.

Paths are absolute, except inside manifests. Times use milliseconds. Check meta.warnings, failures, estimated, and missing for incomplete captures.