ferraus sounds search
Search the sounds registry
Synopsis
ferraus sounds search <query> [options]
What it does
Searches the curated registry of free instruments, SoundFonts, SFZ libraries, and impulse responses by name, tag (piano, synth, drums, strings), type, or license. Shows size, license, and whether each entry is verified (has a pinned SHA-256) for this platform.
Examples
Find piano sounds
ferraus sounds search piano
CC0 reverbs and impulse responses as JSON
ferraus sounds search reverb --type ir,clap --license CC0 --json
String libraries in SFZ format
ferraus sounds search strings --type sfz
Options
| Flag | Type | Default | Meaning |
|---|---|---|---|
<query> | text | — | Words to match in name, id, tags, category, type, or license (empty lists everything) |
--type | list | — | Only these types: clap, vst3, sf2, sfz, ir |
--license | text | — | Only entries whose SPDX license contains this text (e.g. CC0, GPL, MIT) |
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 |
| 7 | Plugin crashed, timed out, or was not found |
| 8 | Cancelled |
| 10 | Network error |
| 70 | Internal error (bug) |
Common mistakes
- Expecting human-readable text when scripting: add
--jsonfor a stable machine result.
For models
- MCP tool:
ferraus_sounds_search - Schema:
ferraus schema sounds search - Pipeline:
{ op: sounds search, args: { ... } }(flag names with_instead of-) - fx stage: no
{"command": "sounds search", "defaults": {}}