ferraus media streams

List every stream in a container: video, audio, subtitle, data

Synopsis

ferraus media streams <input> [options] [-o <output>]

What it does

Lists each elementary stream with its kind, codec, language, duration, and per-kind index (the N in media extract-audio --track N). Uses ffprobe when available, otherwise Symphonia (audio containers only).

Examples

Video, audio (with languages), subtitle and attachment streams

ferraus media streams movie.mkv

The stream inventory as JSON for an agent

ferraus media streams interview.mp4 --json

Find the index of each audio track before media extract-audio --track

ferraus media streams concert.mka

Global options

Every command also accepts the global options (-o, --json, --dry-run, --overwrite, --progress, ...). See Global options.

Exit codes

CodeMeaning
0Success
1Processing failed
2Usage or parameter error
3Input missing or unreadable
4Unsupported format or codec
8Cancelled
70Internal error (bug)

Common mistakes

  • Forgetting that outputs are never overwritten: pass --overwrite or a new -o path when re-running.

For models

  • MCP tool: ferraus_media_streams
  • Schema: ferraus schema media streams
  • Pipeline: { op: media streams, args: { ... } } (flag names with _ instead of -)
  • fx stage: no
{"command": "media streams", "defaults": {}}