ferraus media info

Container and stream details as JSON (ffprobe -show_format -show_streams)

Synopsis

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

What it does

Runs ffprobe with -show_format -show_streams -show_chapters and returns its JSON, plus a normalized inventory of streams. Without FFmpeg, audio-capable containers are described natively (Symphonia) with a warning.

Examples

Every stream, chapter, and container field as JSON

ferraus media info movie.mkv --json

Format, duration, bitrate, and tags of an audio file

ferraus media info podcast.m4a

Only the normalized stream inventory

ferraus media info lecture.mp4 --json | jq .result.inventory

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_info
  • Schema: ferraus schema media info
  • Pipeline: { op: media info, args: { ... } } (flag names with _ instead of -)
  • fx stage: no
{"command": "media info", "defaults": {}}