ferraus sounds alias

Set what an instrument name resolves to

Synopsis

ferraus sounds alias <assignment> [options]

Writes [aliases] in <config>/sounds/aliases.toml so --instrument piano or --to piano picks the sound you chose. The target is an installed sound id, a registry id, or an explicit source such as plugin:"Surge XT" or sf2:/path/gm.sf2. With no arguments, lists the aliases.

Examples

Make 'piano' mean the Salamander Grand Piano

ferraus sounds alias piano=salamander-grand-piano

Point two names at explicit sources

ferraus sounds alias strings=sfz:/libs/vsco/Strings.sfz pad='plugin:"Surge XT"'

Delete two aliases so the names resolve to their defaults again

ferraus sounds alias --remove piano,pad

Options

Flag	Type	Default	Meaning
`<assignment>`	text	—	name=target pairs, e.g. piano=salamander-grand-piano Repeatable.
`--remove`	list	—	Alias names to delete

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_alias
Schema: ferraus schema sounds alias
Pipeline: { op: sounds alias, args: { ... } } (flag names with _ instead of -)
fx stage: no

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