ferraus master deliver
Write the deliverable set
Synopsis
ferraus master deliver <input> [options] [-o <output>]
What it does
Writes one file per --formats entry from a finished master: wav24 (24-bit, original rate), wav16 (16-bit 44.1 kHz with TPDF dither), mp3 (320 kbps, 44.1 kHz), flac (24-bit), aac (256 kbps .m4a, 44.1 kHz; needs FFmpeg). Resampling re-limits any new inter-sample peaks to the master's true peak. --tags and --isrc are written into every file; --loudness-sheet also writes a JSON and a CSV loudness sheet (integrated loudness, LRA, true peak, PLR per deliverable). Output names: <output>.wav24.wav, <output>.wav16.wav, <output>.mp3, <output>.flac, <output>.m4a.
Examples
WAV 24, WAV 16, and MP3 with tags and a loudness sheet
ferraus master deliver master.wav --tags title=Song,artist=Me --isrc US-RC1-76-07839 --loudness-sheet -o release/song.wav
Lossless and AAC deliverables
ferraus master deliver master.wav --formats wav24,flac,aac -o release/song.wav
A single tagged MP3 for a podcast feed
ferraus master deliver episode.wav --formats mp3 --tags title=Episode1,artist=Show -o out/episode1.wav
Options
| Flag | Type | Default | Meaning |
|---|---|---|---|
--formats | list | wav24,wav16,mp3 | Comma list of wav24, wav16, mp3, flac, aac |
--tags | text | — | Metadata key=value (title, artist, album, date, genre, track, ...); repeat or comma-separate Repeatable. |
--isrc | text | — | ISRC code written to every deliverable (CC-XXX-YY-NNNNN) |
--loudness-sheet | flag | — | Also write a loudness sheet (<output>.loudness.json and .csv) |
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 |
| 5 | Model not cached and downloads disabled |
| 6 | Model download or verification failed |
| 8 | Cancelled |
| 10 | Network error |
| 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_master_deliver - Schema:
ferraus schema master deliver - Pipeline:
{ op: master deliver, args: { ... } }(flag names with_instead of-) - fx stage: no
{"command": "master deliver", "defaults": {"formats": "wav24,wav16,mp3"}}