ferraus sounds list

List installed sounds, or what a folder contains

Synopsis

ferraus sounds list [options]

Without --path, lists installed sounds and everything in --sound-path folders. With --path, shows what that folder contains (CLAP/VST3 plugins, SF2, SFZ, impulse responses) with the category ferraus inferred for each: keys, strings, guitar, bass, drums, synth, pad, brass, winds, vocal, fx.

Examples

Installed sounds and sound-path folders

ferraus sounds list

What a folder holds, with inferred categories, as JSON

ferraus sounds list --path ~/Samples --json

Only installed keyboard sounds (pianos, electric pianos, organs)

ferraus sounds list --category keys

Options

Flag	Type	Default	Meaning
`--path`	path	—	Folder to inspect instead of the installed sounds
`--category`	text	—	Only sounds in this category (keys, strings, guitar, bass, drums, synth, pad, brass, winds, vocal, fx)

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 --json for a stable machine result.

For models

MCP tool: ferraus_sounds_list
Schema: ferraus schema sounds list
Pipeline: { op: sounds list, args: { ... } } (flag names with _ instead of -)
fx stage: no

{"command": "sounds list", "defaults": {}}