ferraus plugin presets list

List a plugin's presets

Synopsis

ferraus plugin presets list <name> [options]

What it does

Discovers presets through the plugin's own preset-discovery interface (CLAP) or program lists (VST3). Use a name with --preset.

Examples

List Surge XT's presets

ferraus plugin presets list "Surge XT"

Presets as JSON

ferraus plugin presets list Dexed --json

Presets of one plugin inside a multi-plugin bundle

ferraus plugin presets list ./MyPlugin.clap#com.acme.reverb

Options

FlagTypeDefaultMeaning
<name>text—Plugin name, id, or path to a .clap/.vst3 bundle (path#plugin.id picks one plugin in a bundle) Required.
--watchdogtime—Stop the plugin host after this long without progress (default 60s, or FERRAUS_PLUGIN_WATCHDOG_S)

Global options

Every command also accepts the global options (-o, --json, --dry-run, --overwrite, --progress, ...). See Global options.

Exit codes

CodeMeaning
0Success
1Processing failed
2Usage or parameter error
3Input missing or unreadable
7Plugin crashed, timed out, or was not found
8Cancelled
70Internal error (bug)

Common mistakes

  • Beat-based times (4b, 1/4) need a tempo: pass --bpm or write 4b@120.

For models

  • MCP tool: ferraus_plugin_presets_list
  • Schema: ferraus schema plugin presets list
  • Pipeline: { op: plugin presets list, args: { ... } } (flag names with _ instead of -)
  • fx stage: no
{"command": "plugin presets list", "defaults": {}}