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
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Processing failed |
| 2 | Usage or parameter error |
| 3 | Input missing or unreadable |
| 4 | Unsupported format or codec |
| 8 | Cancelled |
| 70 | Internal error (bug) |
Common mistakes
- Forgetting that outputs are never overwritten: pass
--overwriteor a new-opath 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": {}}