Skip to main content
Persistent drum part→pitch overrides and kit-swap note retargeting.

​
Command line

​
drums map show

Show the project drum map (part-type → pitch overrides)
​
--project
Path to the .vibrai file (defaults to Untitled.vibrai in CWD)

​
drums map set

Set drum map entries (merged), e.g. snare=40 hi_hat=42
​
entries
required
Drum map entries like snare=40 hi_hat=42 (keys: bd, snare, hi_hat, hi_hat_plus, percussion, crash, fill, roll, drums)
​
--project
Path to the .vibrai file (defaults to Untitled.vibrai in CWD)

​
drums map clear

Clear the drum map, or only the named part keys
​
parts
Drum part keys to remove; omit to clear the whole map
​
--project
Path to the .vibrai file (defaults to Untitled.vibrai in CWD)

​
drums retarget

Re-resolve drum pitches against current kits and remap written notes (kit-swap fixer)
​
--track
Live track number (1-based); repeatable to limit the retarget
​
--dry-run
Preview without remapping or saving
​
--project
Path to the .vibrai file (defaults to Untitled.vibrai in CWD)

​
MCP tools

​
get_drum_map

Show the project’s drum map: explicit drum-part→pitch overrides used as the first rung of drum-pitch resolution. Empty map = fully automatic (pad names, then GM).
​
project_path
String
Path to the .vibrai file (defaults to Untitled.vibrai in CWD when omitted)

​
set_drum_map

Set drum map entries (merged into the existing map) like [“snare=40”,“hi_hat=42”]. Keys are drum part types (bd, snare, hi_hat, hi_hat_plus, percussion, crash, fill, roll, drums); pitches 0-127. Mapped pitches win over pad-name matching at generate time; run retarget_drums to move already-written notes.
​
entries
String[]
required
Entries like “snare=40”
​
project_path
String
Path to the .vibrai file (defaults to Untitled.vibrai in CWD when omitted)

​
clear_drum_map

Clear the project drum map entirely, or only the named drum part keys (e.g. [“snare”]).
​
parts
String[]
Drum part keys to remove; omit/empty to clear the whole map
​
project_path
String
Path to the .vibrai file (defaults to Untitled.vibrai in CWD when omitted)

​
retarget_drums

Re-resolve every drum part’s pitch against the CURRENT kits (drum map → pad names → GM → snap) and remap already-written notes from the last-generated pitch to the new one — session and arrangement clips, server-side. Run after swapping a kit. dry_run previews without writing. Tracks with no recorded pitch (never generated with this feature) are skipped with a warning; use remap_pitch for those.
​
project_path
String
Path to the .vibrai file (defaults to Untitled.vibrai in CWD when omitted)
​
tracks
String[]
Optional live track numbers (1-based, as in list_tracks) to limit the retarget
​
dry_run
Boolean
Preview the plan without remapping or saving