livepilot 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/LICENSE +21 -0
  3. package/README.md +409 -0
  4. package/bin/livepilot.js +390 -0
  5. package/installer/install.js +95 -0
  6. package/installer/paths.js +79 -0
  7. package/mcp_server/__init__.py +2 -0
  8. package/mcp_server/__main__.py +5 -0
  9. package/mcp_server/connection.py +210 -0
  10. package/mcp_server/memory/__init__.py +5 -0
  11. package/mcp_server/memory/technique_store.py +296 -0
  12. package/mcp_server/server.py +87 -0
  13. package/mcp_server/tools/__init__.py +1 -0
  14. package/mcp_server/tools/arrangement.py +407 -0
  15. package/mcp_server/tools/browser.py +86 -0
  16. package/mcp_server/tools/clips.py +218 -0
  17. package/mcp_server/tools/devices.py +256 -0
  18. package/mcp_server/tools/memory.py +198 -0
  19. package/mcp_server/tools/mixing.py +121 -0
  20. package/mcp_server/tools/notes.py +269 -0
  21. package/mcp_server/tools/scenes.py +89 -0
  22. package/mcp_server/tools/tracks.py +175 -0
  23. package/mcp_server/tools/transport.py +117 -0
  24. package/package.json +37 -0
  25. package/plugin/agents/livepilot-producer/AGENT.md +62 -0
  26. package/plugin/commands/beat.md +18 -0
  27. package/plugin/commands/memory.md +22 -0
  28. package/plugin/commands/mix.md +15 -0
  29. package/plugin/commands/session.md +13 -0
  30. package/plugin/commands/sounddesign.md +16 -0
  31. package/plugin/plugin.json +19 -0
  32. package/plugin/skills/livepilot-core/SKILL.md +208 -0
  33. package/plugin/skills/livepilot-core/references/ableton-workflow-patterns.md +831 -0
  34. package/plugin/skills/livepilot-core/references/device-atlas/00-index.md +110 -0
  35. package/plugin/skills/livepilot-core/references/device-atlas/distortion-and-character.md +687 -0
  36. package/plugin/skills/livepilot-core/references/device-atlas/drums-and-percussion.md +753 -0
  37. package/plugin/skills/livepilot-core/references/device-atlas/dynamics-and-punch.md +525 -0
  38. package/plugin/skills/livepilot-core/references/device-atlas/eq-and-filtering.md +402 -0
  39. package/plugin/skills/livepilot-core/references/device-atlas/midi-tools.md +963 -0
  40. package/plugin/skills/livepilot-core/references/device-atlas/movement-and-modulation.md +874 -0
  41. package/plugin/skills/livepilot-core/references/device-atlas/space-and-depth.md +571 -0
  42. package/plugin/skills/livepilot-core/references/device-atlas/spectral-and-weird.md +714 -0
  43. package/plugin/skills/livepilot-core/references/device-atlas/synths-native.md +953 -0
  44. package/plugin/skills/livepilot-core/references/m4l-devices.md +352 -0
  45. package/plugin/skills/livepilot-core/references/memory-guide.md +107 -0
  46. package/plugin/skills/livepilot-core/references/midi-recipes.md +402 -0
  47. package/plugin/skills/livepilot-core/references/mixing-patterns.md +578 -0
  48. package/plugin/skills/livepilot-core/references/overview.md +209 -0
  49. package/plugin/skills/livepilot-core/references/sound-design.md +392 -0
  50. package/remote_script/LivePilot/__init__.py +42 -0
  51. package/remote_script/LivePilot/arrangement.py +693 -0
  52. package/remote_script/LivePilot/browser.py +424 -0
  53. package/remote_script/LivePilot/clips.py +211 -0
  54. package/remote_script/LivePilot/devices.py +596 -0
  55. package/remote_script/LivePilot/diagnostics.py +198 -0
  56. package/remote_script/LivePilot/mixing.py +194 -0
  57. package/remote_script/LivePilot/notes.py +339 -0
  58. package/remote_script/LivePilot/router.py +74 -0
  59. package/remote_script/LivePilot/scenes.py +99 -0
  60. package/remote_script/LivePilot/server.py +293 -0
  61. package/remote_script/LivePilot/tracks.py +268 -0
  62. package/remote_script/LivePilot/transport.py +151 -0
  63. package/remote_script/LivePilot/utils.py +123 -0
  64. package/requirements.txt +2 -0
@@ -0,0 +1,753 @@
1
+ # Drums & Percussion — Device Atlas
2
+
3
+ > Deep reference for every drum and percussion device, instrument, and processor in this Ableton Live 12 installation.
4
+ > Covers Drum Rack, DS Drum Synths (M4L), Drum Sampler (12.1), Impulse, Drum Buss, third-party M4L drum tools, and the full 139-kit library organized by genre/character.
5
+
6
+ ---
7
+
8
+ ## Core Architecture
9
+
10
+ ---
11
+
12
+ ### Drum Rack
13
+
14
+ - **Type:** Native (Instrument Rack variant)
15
+ - **Load via:** `find_and_load_device("Drum Rack")`
16
+ - **What it does:** The container system for all drum programming in Live. Each pad hosts an independent instrument chain with its own effects, mixer controls, and routing. Maps 128 MIDI notes to individual pads, supports layering, choke groups, and internal send/return processing. The backbone of every drum kit in Live.
17
+ - **Signal flow:** MIDI In -> Pad Note Assignment (Receive) -> Per-Pad Instrument Chain (with per-chain FX) -> Per-Chain Mixer (Volume/Pan/Sends) -> Send/Return Chains (up to 6) -> Main Output
18
+ - **Key concepts:**
19
+ - **Pad View:** 16 pads visible at once; navigate 128 total pads via the pad overview on the left. Each pad = one MIDI note. Drop samples, instruments, or presets directly onto pads.
20
+ - **Standard GM Mapping:** C1 (MIDI 36) = Kick, C#1 (37) = Sidestick, D1 (38) = Snare, D#1 (39) = Clap, E1/F1 (40/41) = Toms, F#1 (42) = Closed HH, G#1 (44) = Pedal HH, A#1 (46) = Open HH, C#2 (49) = Crash, D#2 (51) = Ride
21
+ - **Choke Groups:** 16 groups available. Chains in the same choke group silence each other when triggered. Classic use: closed hi-hat (F#1) chokes open hi-hat (A#1) by assigning both to Choke Group 1.
22
+ - **Layering:** Alt/Cmd-drag multiple samples onto a single pad to create a nested Instrument Rack (all play simultaneously). Without modifier, samples map chromatically from the target pad.
23
+ - **Send/Return Chains:** Up to 6 return chains for shared processing (reverb, delay, saturation). Each pad chain gets independent send level knobs. Return output can route to Rack main out or directly to Set return tracks.
24
+ - **Chain List Columns:** Receive (incoming MIDI note), Play (outgoing note to instrument), Choke (group assignment), output routing
25
+ - **Macro Controls:** Up to 16 macros (8 shown by default) that can map to any parameter across all pad chains. Support randomization, snapshots/variations.
26
+ - **Hot-Swap:** Press D to toggle hot-swap target between the Rack itself and the selected pad.
27
+ - **Individual Pad Routing:** Each chain has Volume, Pan, and Send sliders in the mixer section.
28
+ - **Presets:** Every drum kit in the browser is a Drum Rack preset. See the Kit Guide below for the full 139-kit breakdown.
29
+ - **LivePilot workflow:**
30
+ - Load a kit: `find_and_load_device("Kit Name")` on a MIDI track
31
+ - Add device to specific pad: Load instrument into Drum Rack chain, set Receive note
32
+ - Set choke groups: Access chain list, set Choke column value (1-16) for related pads
33
+ - Layer sounds: Load multiple instruments on one pad chain via nested Instrument Rack
34
+ - Notes always target pad MIDI notes (e.g., C1=36 for kick, D1=38 for snare)
35
+ - **Reach for this when:** building any drum kit, you need per-pad processing, you want choke groups, you need internal send/return for shared reverb/delay
36
+ - **Don't use when:** you need a quick 8-slot sketch (use Impulse), you want a single synthesized drum voice (use DS synths or Drum Sampler directly)
37
+
38
+ ---
39
+
40
+ ## DS Drum Synths (Max for Live)
41
+
42
+ > Nine lightweight synthesizers designed to drop into Drum Rack pads. Each generates a specific percussion voice from synthesis (no samples needed except DS Sampler). All share a consistent interface: visual waveform display (click to preview), Decay knob, Volume knob, and Pitch control.
43
+
44
+ ---
45
+
46
+ ### DS Kick
47
+
48
+ - **Type:** M4L Instrument (Drum Synth)
49
+ - **Load via:** `find_and_load_device("DS Kick")`
50
+ - **What it does:** Kick drum synth built on a modulated sine wave. Produces everything from deep sub-bass 808 kicks to punchy acoustic-style kicks. The OT (overtone) control adds a mid-range resonant tone reminiscent of a 909 kick.
51
+ - **Signal flow:** Sine Oscillator -> Pitch Envelope (Env) -> Drive/Saturation -> Click Layer -> Volume -> Output
52
+ - **Key parameters:**
53
+ - **Pitch** (Hz) -> fundamental frequency of the kick -> lower = deeper sub, higher = punchier
54
+ - **Env** -> pitch modulation envelope amount -> higher = more dramatic pitch sweep (classic 808 boom), lower = flatter thud
55
+ - **Drive** -> adds distortion/saturation -> subtle warmth at low values, aggressive grit at high values
56
+ - **OT** (Overtone) -> adds mid-range resonant harmonic -> 909-style presence, helps kick cut through on small speakers
57
+ - **Click** (switch) -> toggles a transient click layer -> ON for defined attack that cuts through mix, OFF for softer rounded onset
58
+ - **Attack** -> smooths the initial sine wave transient -> higher = softer attack
59
+ - **Decay** -> length of the kick tail -> short for tight electronic, long for boomy sub
60
+ - **Volume** -> output level
61
+ - **Presets:** 808 Kick, 909 Kick, Acoustic Kick, Sub Kick, Punchy Kick
62
+ - **Reach for this when:** you need a synthesized kick with control over sub content, pitch sweep, and drive character
63
+ - **Don't use when:** you need a sampled acoustic kick (use Drum Sampler), you want complex layered kicks (build in Drum Rack with multiple chains)
64
+ - **Pairs well with:** Drum Buss (Boom section for sub reinforcement), Saturator (additional harmonic control), EQ Eight (surgical low-end shaping)
65
+
66
+ ---
67
+
68
+ ### DS Snare
69
+
70
+ - **Type:** M4L Instrument (Drum Synth)
71
+ - **Load via:** `find_and_load_device("DS Snare")`
72
+ - **What it does:** Snare synth combining a pitched oscillator with noise. Covers the range from traditional acoustic snare sounds to gated noise electronic snares common in EDM.
73
+ - **Signal flow:** Pitched Oscillator + Noise Generator -> Filter (LP/HP/BP selectable) -> Decay Envelope -> Volume -> Output
74
+ - **Key parameters:**
75
+ - **Tune** -> global pitch of the snare body -> lower for fat snares, higher for cracking snares
76
+ - **Color** -> tone/character of the pitched signal -> shapes the body harmonic content
77
+ - **Tone** -> presence/level of the noise signal -> 0% = pure pitched body, 100% = dominated by noise (electronic snare)
78
+ - **Filter Type** (LP / HP / BP toggle) -> shapes the overall frequency response -> LP for warm/dark, HP for bright/thin, BP for focused mid-range
79
+ - **Decay** -> snare tail length -> short for tight, long for roomy
80
+ - **Volume** -> output level
81
+ - **Reach for this when:** you need a snare from synthesis, blending tonal body with noise rattle
82
+ - **Pairs well with:** Compressor (transient emphasis), Reverb (room character), Gate (tightening the tail)
83
+
84
+ ---
85
+
86
+ ### DS Clap
87
+
88
+ - **Type:** M4L Instrument (Drum Synth)
89
+ - **Load via:** `find_and_load_device("DS Clap")`
90
+ - **What it does:** Clap synth using filtered noise and impulses through panned delay lines. Creates everything from tight electronic claps to loose, humanized handclaps with natural spread.
91
+ - **Signal flow:** Impulse + Filtered Noise (Tail) -> Panned Delay Lines (Sloppy) -> Stereo Spread -> Tone Filter -> Volume -> Output
92
+ - **Key parameters:**
93
+ - **Tune** -> pitch of the clap
94
+ - **Sloppy** -> delay time between the panned delay lines -> 0% = tight, synchronized electronic clap; high = loose, humanized feel with audible flamming
95
+ - **Tail** -> amount of filtered noise added to the impulse -> adds sustain and body
96
+ - **Spread** (0-100%) -> stereo width -> 0% = mono, 100% = wide stereo image
97
+ - **Tone** -> color/brightness of the clap -> adjusts high-frequency content
98
+ - **Decay** -> combined with Tail to control overall duration
99
+ - **Volume** -> output level
100
+ - **Reach for this when:** you need a clap with natural humanization (Sloppy) and stereo width
101
+ - **Pairs well with:** Reverb (room ambience), Chorus-Ensemble (thickening), Drum Buss (glue)
102
+
103
+ ---
104
+
105
+ ### DS HH (Hi-Hat)
106
+
107
+ - **Type:** M4L Instrument (Drum Synth)
108
+ - **Load via:** `find_and_load_device("DS HH")`
109
+ - **What it does:** Hi-hat synth blending noise and sine waveforms through a resonant high-pass filter. Produces sharp closed hats to sizzling open hats.
110
+ - **Signal flow:** Noise Generator (White/Pink) + Sine Oscillator -> Resonant High-Pass Filter (12/24 dB) -> Attack Shaping -> Decay Envelope -> Volume -> Output
111
+ - **Key parameters:**
112
+ - **Pitch** -> global pitch control -> higher = brighter, more present
113
+ - **Noise Type** (White / Pink toggle) -> White = conventional metallic hat; Pink = more focused, cuts through mix with metallic edge
114
+ - **Tone** -> high-pass filter cutoff -> higher = removes more low end, thinner/brighter
115
+ - **Filter Slope** (12 dB / 24 dB toggle) -> steepness of the HP filter -> 24 dB = sharper, more defined; 12 dB = gentler roll-off
116
+ - **Attack** -> attack time of the resonant HP filter -> shapes the onset character
117
+ - **Decay** -> hat length -> very short for tight closed hats, longer for open hats, medium for pedal hats
118
+ - **Volume** -> output level
119
+ - **Tip:** Use two DS HH instances on different pads — one with short Decay (closed hat, F#1) and one with long Decay (open hat, A#1) — then set both to the same Choke Group so closed chokes open.
120
+ - **Reach for this when:** you need synthesized hi-hats with precise control over metallic character
121
+ - **Pairs well with:** Saturator (add grit), Auto Pan (movement), Erosion (lo-fi texture)
122
+
123
+ ---
124
+
125
+ ### DS Cymbal
126
+
127
+ - **Type:** M4L Instrument (Drum Synth)
128
+ - **Load via:** `find_and_load_device("DS Cymbal")`
129
+ - **What it does:** Electronic cymbal synth for splashes, crashes, and rides. Simple three-knob design for quick results.
130
+ - **Signal flow:** Noise/Oscillator Core -> Tone Filter -> Decay Envelope -> Volume -> Output
131
+ - **Key parameters:**
132
+ - **Pitch** -> cymbal pitch
133
+ - **Tone** -> high-pass filter cutoff -> shapes brightness and metallic character
134
+ - **Decay** -> cymbal sustain length -> short for splashes, long for crashes/rides
135
+ - **Volume** -> output level
136
+ - **Reach for this when:** you need a quick electronic cymbal without fuss
137
+ - **Don't use when:** you need realistic cymbal sounds (use sampled cymbals in Drum Sampler)
138
+
139
+ ---
140
+
141
+ ### DS Tom
142
+
143
+ - **Type:** M4L Instrument (Drum Synth)
144
+ - **Load via:** `find_and_load_device("DS Tom")`
145
+ - **What it does:** Tom synth with pitched oscillator, noise layer, and pitch envelope. Fills the mid-range with resonant, punchy toms. Pitch displayed in both note name and Hz for diatonic tuning.
146
+ - **Signal flow:** Pitched Oscillator -> Pitch Envelope (Bend) -> Resonant Band-Pass Filters (Tone) -> Color Filter -> Decay Envelope -> Volume -> Output
147
+ - **Key parameters:**
148
+ - **Pitch** (note/Hz) -> fundamental frequency -> tune toms to musical intervals for melodic fills
149
+ - **Bend** -> pitch envelope amount -> high = taut-skinned punch with dramatic pitch sweep; low = flatter resonant thud
150
+ - **Color** -> filter gain and cutoff -> shapes the character of both noise and primary timbre
151
+ - **Tone** -> level of resonant band-pass filters -> mimics drum membrane tuning; adds filtered noise texture
152
+ - **Decay** -> tom tail length
153
+ - **Volume** -> output level
154
+ - **Reach for this when:** you need synthesized toms, especially for tribal or electronic percussion with tunable pitch
155
+ - **Pairs well with:** Reverb (big room toms), Drum Buss (punch and body), Delay (rhythmic tom patterns)
156
+
157
+ ---
158
+
159
+ ### DS FM
160
+
161
+ - **Type:** M4L Instrument (Drum Synth)
162
+ - **Load via:** `find_and_load_device("DS FM")`
163
+ - **What it does:** FM synthesis percussion generator inspired by classic Japanese FM synthesizers (DX7/TX81Z). Creates everything from tuned claves and woodblocks to laser blasts and futuristic bleeps. Pitch displayed in note values for diatonic use.
164
+ - **Signal flow:** FM Algorithm (Carrier + Modulator) -> Feedback -> Low-Pass Filter (Tone) -> Decay Envelope -> Volume -> Output
165
+ - **Key parameters:**
166
+ - **Pitch** (note display) -> global pitch -> tune to key for melodic percussion
167
+ - **Tone** -> low-pass filter cutoff -> higher = more high-frequency content; lower = warmer/darker
168
+ - **Feedb.** (Feedback) -> FM algorithm feedback amount -> increases harmonic complexity and metallic character
169
+ - **Amnt** (Amount) -> FM modulation depth -> subtle = bell-like; extreme = noisy, chaotic
170
+ - **Mod** (Modulation) -> blends between modulation types -> warps the timbral character
171
+ - **Decay** -> percussion length
172
+ - **Volume** -> output level
173
+ - **Reach for this when:** you need metallic, bell-like, or otherworldly synthesized percussion; tuned percussion elements; sci-fi sound effects
174
+ - **Don't use when:** you need organic-sounding percussion (use DS Tom or sampled sounds)
175
+ - **Pairs well with:** Chorus-Ensemble (detuned bells), Delay (rhythmic patterns), Reverb (space)
176
+
177
+ ---
178
+
179
+ ### DS Clang
180
+
181
+ - **Type:** M4L Instrument (Drum Synth)
182
+ - **Load via:** `find_and_load_device("DS Clang")`
183
+ - **What it does:** Metallic percussion synth with two independent tones, white noise, and a filter. Creates cowbells, claves, rimshots, and noise percussion. Has a dedicated Clave mode with repeats.
184
+ - **Signal flow:** Tone A + Tone B + White Noise -> HP/BP Filter -> Clave Repeat (optional) -> Decay Envelope -> Volume -> Output
185
+ - **Key parameters:**
186
+ - **Pitch** -> global pitch of the instrument
187
+ - **Tone A / Tone B** (sliders) -> independent volume for each cowbell tone -> balance between two pitched components
188
+ - **Filter** -> high-pass and band-pass filter cutoff -> shapes metallic character; higher = brighter
189
+ - **Noise** -> amount of white noise added -> adds sizzle and texture
190
+ - **Clave** (switch) -> activates clave mode with metallic ping on top
191
+ - **Repeat** -> adds rattling repeats to the clave sound -> creates flam-like percussion patterns
192
+ - **Decay** -> sound length
193
+ - **Volume** -> output level
194
+ - **Reach for this when:** you need cowbell, clave, rimshot, or tuned metallic percussion
195
+ - **Pairs well with:** Saturator (grit), Auto Filter (movement), Delay (rhythmic cowbell patterns)
196
+
197
+ ---
198
+
199
+ ### DS Sampler
200
+
201
+ - **Type:** M4L Instrument (Drum Synth)
202
+ - **Load via:** `find_and_load_device("DS Sampler")`
203
+ - **What it does:** Sample-based drum voice that fits the DS Drum Synth form factor. Drag and drop any sample into the display. Provides Start, Length, Tuning, Loop mode, and a Shaper for saturation. The bridge between synthesis and sampling within the DS ecosystem.
204
+ - **Signal flow:** Sample Playback (Start/Length) -> Tuning -> Loop (optional) -> Shaper/Saturation -> Decay Envelope -> Volume -> Output
205
+ - **Key parameters:**
206
+ - **Start** -> sample playback start position -> find the sweet spot of the transient
207
+ - **Length** -> sample playback length -> trim unwanted tail
208
+ - **Tune** (+-48 semitones) -> pitch shift the sample
209
+ - **Loop** (switch) -> enables sample looping -> creates digital, stuttering textures at short lengths
210
+ - **Shaper** -> saturation/distortion -> adds punch and grit; thickens thin samples
211
+ - **Decay** -> amplitude decay time
212
+ - **Volume** -> output level
213
+ - **Reach for this when:** you want to use a custom sample in the DS Drum Synth visual format, maintaining consistent UI with the other DS synths
214
+ - **Don't use when:** you need advanced sample manipulation (use Drum Sampler 12.1 or Simpler)
215
+ - **vs Drum Sampler (12.1):** DS Sampler is simpler, fits the DS form factor. Drum Sampler has 9 playback effects, filter section, AHD envelope, and modulation matrix.
216
+
217
+ ---
218
+
219
+ ## Drum Sampler (Live 12.1+)
220
+
221
+ ---
222
+
223
+ ### Drum Sampler
224
+
225
+ - **Type:** Native Instrument (Live 12.1+, all editions)
226
+ - **Load via:** `find_and_load_device("Drum Sampler")`
227
+ - **What it does:** Purpose-built one-shot sample playback device for percussion. The modern replacement for dropping samples into Simpler in Slice mode. Features 9 playback effects with X/Y pad control, a filter section, AHD envelope, velocity/MPE modulation, and similarity-based sample swapping. Designed to be the default instrument on new Drum Rack pads (set via context menu: "Save as Default Pad").
228
+ - **Signal flow:** Sample (Start/Length) -> Playback Effect -> Filter -> AHD Envelope -> Velocity-to-Volume -> Pan -> Output
229
+ - **Key parameters:**
230
+ - **Sample Section:**
231
+ - **Sample Start** (% of length) -> where playback begins
232
+ - **Sample Length** (% of total) -> playback region length
233
+ - **Sample Gain** (-70 to +24 dB) -> pre-processing level
234
+ - **Transpose** (-48 to +48 semitones) -> pitch shift
235
+ - **Detune** (-50 to +50 cents) -> fine tuning
236
+ - **Swap Next/Previous** -> browse similar samples automatically
237
+ - **Save as Similarity Reference** -> set reference for similarity search
238
+ - **Envelope (AHD):**
239
+ - **Attack** -> time to reach peak level
240
+ - **Hold** -> sustain duration at peak (can be set to infinite); disabled in Gate mode
241
+ - **Decay** -> return time from peak to zero
242
+ - **Trigger Mode** -> sample plays for Hold duration after note release
243
+ - **Gate Mode** -> sample fades per Decay time once note is released
244
+ - **9 Playback Effects** (toggle on/off, X/Y pad control):
245
+ - **Stretch** -> Factor (time-stretch multiplier) + Grain Size (ms) -> change length without changing pitch
246
+ - **Loop** -> Loop Offset (start point) + Loop Length (ms) -> repeat a portion of the sample
247
+ - **Pitch Env** -> Amount (-100 to +100%) + Decay (return time) -> pitch sweep over time (808-style boom)
248
+ - **Punch** -> Amount (ducking intensity) + Release (recovery) -> emphasizes transient attack
249
+ - **8-Bit** -> Sample Rate (bit crush rate) + Decay (LP filter decay) -> lo-fi reduction
250
+ - **FM** -> Amount (FM depth) + Frequency (modulator freq) -> sine-wave pitch modulation
251
+ - **Ring Mod** -> Amount (mod depth) + Frequency (mod freq) -> ring modulation
252
+ - **Sub Osc** -> Amount (level) + Frequency (30-120 Hz) -> layers a sub oscillator
253
+ - **Noise Osc** -> Amount (level) + Color (filter freq) -> layers noise
254
+ - **Filter Section** (toggle on/off):
255
+ - **Types:** 12 dB LP, 24 dB LP, 24 dB HP, Peak
256
+ - **Frequency** -> cutoff/center frequency
257
+ - **Resonance** (LP/HP) or **Peak Gain** (Peak mode)
258
+ - **Modulation:**
259
+ - **Sources:** Velocity, Slide (MPE)
260
+ - **Destinations:** Filter, Attack, Hold, Decay, FX1, FX2
261
+ - **Amount slider** -> intensity of source-to-destination routing
262
+ - **Output:**
263
+ - **Volume** (-36 to +36 dB)
264
+ - **Pan** -> stereo position
265
+ - **Velocity to Volume** -> how much velocity affects level
266
+ - **Context Menu Options:** Enable Per-Note Pitch Bend, Envelope Follows Pitch, Convert to Simpler, Save as Default Pad
267
+ - **Presets:** Factory presets organized by percussion type
268
+ - **Reach for this when:** building custom drum kits from samples, you want playback effects (Punch, 8-Bit, FM, Sub Osc), you need MPE support on drum pads, quick sample browsing with similarity search
269
+ - **Don't use when:** you need multi-sample layering (use Simpler/Sampler in Drum Rack), you want pure synthesis (use DS drum synths)
270
+ - **Pairs well with:** Drum Buss (after the Drum Rack for glue), Saturator (per-pad grit), Auto Filter (per-pad movement)
271
+ - **vs Simpler:** Drum Sampler is streamlined for one-shots with built-in playback effects and similarity search. Simpler offers multi-mode playback (Classic/One-Shot/Slice), warping, and more sample manipulation. Use Drum Sampler for drums, Simpler for melodic sampling.
272
+ - **vs DS Sampler:** DS Sampler is the legacy M4L version with minimal controls (Start, Length, Tune, Loop, Shaper). Drum Sampler adds 9 playback effects, proper filter, AHD envelope, modulation matrix. Drum Sampler is the modern choice.
273
+
274
+ ---
275
+
276
+ ## Drum Processing
277
+
278
+ ---
279
+
280
+ ### Drum Buss
281
+
282
+ - **Type:** Native Audio Effect
283
+ - **Load via:** `find_and_load_device("Drum Buss")`
284
+ - **What it does:** Analog-style drum processor that adds body, character, and cohesion to drum groups. Combines distortion (3 types), mid-high transient shaping, and a resonant low-end enhancer in one device. Designed specifically for drum bus processing — does what would normally require 4-5 separate devices in a single, intuitive interface.
285
+ - **Signal flow:** Input -> Trim -> Fixed Compressor (optional) -> Drive Distortion (Soft/Medium/Hard) -> Crunch (mid-high sine distortion) -> Damp (LP filter) -> Transient Shaping (>100 Hz) -> Boom (resonant bass filter + decay) -> Dry/Wet -> Output Gain
286
+ - **Key parameters:**
287
+ - **Trim** -> reduces input level before processing -> use to prevent over-driving
288
+ - **Comp** (toggle) -> fixed compressor optimized for drums -> fast attack, medium release, moderate ratio, ample makeup gain -> ON for tighter, more balanced drums
289
+ - **Drive** -> distortion amount applied before the distortion type
290
+ - **Drive Type** (Soft / Medium / Hard):
291
+ - **Soft** -> waveshaping distortion -> gentle warmth, subtle harmonic addition, transparent at low Drive
292
+ - **Medium** -> limiting distortion -> moderate saturation with level control, good all-rounder
293
+ - **Hard** -> clipping distortion with bass boost -> aggressive, adds weight to low end, best for hard-hitting genres
294
+ - **Crunch** -> sine-shaped distortion on mid-high frequencies -> adds presence and bite where drums cut through mix; the "excitement" control
295
+ - **Damp** -> low-pass filter -> removes harsh high frequencies introduced by Drive and Crunch -> tame fizz while keeping warmth
296
+ - **Transients** (bipolar) -> shapes transients above 100 Hz:
297
+ - **Center (0)** -> no change
298
+ - **Positive** -> boosts attack AND sustain -> full, "punchy" sound with extended body
299
+ - **Negative** -> boosts attack, reduces sustain -> tight, crisp drums with less room/rattle
300
+ - **Boom Section:**
301
+ - **Boom** (knob) -> level of resonant bass filter -> 0% = dry low end, higher = dramatic sub reinforcement
302
+ - **Freq** -> center frequency of the bass enhancer (30-90 Hz) -> match to kick fundamental
303
+ - **Force to Note** (button) -> snaps Freq to nearest MIDI note -> ensures musical bass tuning
304
+ - **Decay** -> decay rate of low frequencies -> affects incoming signal when Boom=0%; affects both incoming and processed when Boom>0%
305
+ - **Boom Audition** (headphone icon) -> solos the bass enhancer output -> dial in Boom in isolation
306
+ - **Bass Meter** -> visual feedback showing Boom's effect
307
+ - **Dry/Wet** -> blend -> 100% for insert, 30-60% for parallel color
308
+ - **Output Gain** -> post-processing level compensation
309
+ - **Presets:** Punchy, Warm, Tight, Boom Box, Crunch Time, Subtle
310
+ - **Reach for this when:** processing drum buses/groups, you want one-device drum coloring, you need sub reinforcement (Boom), you want quick transient shaping without a dedicated transient designer
311
+ - **Don't use when:** you need precise multiband dynamics (use Multiband Dynamics), you want transparent processing (use Compressor), you need frequency-specific transient control (use Re-Enveloper)
312
+ - **Pairs well with:** Glue Compressor (before or after for bus cohesion), EQ Eight (surgical corrections), Limiter (peak control after Drum Buss)
313
+ - **vs Glue Compressor on drums:** Drum Buss adds color, saturation, transient shaping, and bass enhancement. Glue Compressor adds cohesion and leveling. Use both: Drum Buss first for character, Glue Compressor after for glue.
314
+
315
+ ---
316
+
317
+ ### Impulse
318
+
319
+ - **Type:** Native Instrument
320
+ - **Load via:** `find_and_load_device("Impulse")`
321
+ - **What it does:** Classic 8-slot drum sampler with per-slot processing. Each slot has independent Stretch, Saturate, Filter, Pan, Volume, and envelope controls. Simpler than Drum Rack but faster for quick sketches. Samples auto-map to C3-C4 on the keyboard.
322
+ - **Signal flow:** Per Slot: Sample -> Start Offset -> Time Stretch -> Filter -> Saturator -> Decay Envelope -> Pan -> Volume -> Global Output
323
+ - **Key parameters (per slot):**
324
+ - **Start** (0-100 ms offset) -> sample playback start position
325
+ - **Transp** (Transpose, +-48 semitones) -> pitch shift -> can be modulated by velocity or random value
326
+ - **Stretch** (-100% to +100%) -> time-stretch without pitch change -> negative = shorter, positive = longer
327
+ - **Mode A** -> optimized for low sounds (kicks, toms, bass)
328
+ - **Mode B** -> optimized for high sounds (hats, cymbals, snares)
329
+ - **Filter Section:**
330
+ - **Filter Type** -> multiple types for frequency shaping
331
+ - **Frequency** -> where the filter is applied in the spectrum
332
+ - **Resonance** -> boosts frequencies near cutoff point
333
+ - Filter Frequency accepts velocity or random modulation
334
+ - **Saturator:**
335
+ - **Drive** -> adds distortion and fatness -> extreme settings on low-pitched sounds = overdriven analog synth drum character
336
+ - **Envelope:**
337
+ - **Decay** (up to 10.0 s) -> fade time
338
+ - **Trigger Mode** -> sample decays with the note (one-shot behavior)
339
+ - **Gate Mode** -> waits for Note Off before beginning decay (hold-to-play)
340
+ - **Pan** -> stereo position -> modulated by velocity and random value
341
+ - **Volume** -> output level -> modulated by velocity only
342
+ - **Slot 8 Link** -> links Slot 8 with Slot 7 -> triggering one stops the other (built-in choke for open/closed hat)
343
+ - **Global controls:** Master Volume, master Transpose, global Time (scales all stretch and decay values)
344
+ - **MIDI mapping:** C3 = Slot 1 (leftmost), chromatically through C4 = Slot 8
345
+ - **Reach for this when:** quick drum sketching, 8 sounds or fewer, you want per-slot processing without the complexity of Drum Rack, live performance with velocity-sensitive processing
346
+ - **Don't use when:** you need more than 8 sounds, you need choke groups beyond Slot 7/8, you need send/return chains, you need macro control
347
+ - **vs Drum Rack:** Impulse is simpler (8 slots, fixed processing per slot). Drum Rack is infinitely extensible (128 pads, any devices, choke groups, sends/returns, macros). Use Impulse for sketches, Drum Rack for production.
348
+
349
+ ---
350
+
351
+ ## Max for Live Drum Tools
352
+
353
+ ---
354
+
355
+ ### AmenMachine (CLX_04)
356
+
357
+ - **Type:** M4L Instrument (User Library — CLX_04 collection)
358
+ - **Load via:** `find_and_load_device("AmenMachine")`
359
+ - **What it does:** Breakbeat slicer instrument designed for chopping and rearranging break loops, particularly the Amen break and similar breakbeats. Slices a loaded loop into segments and allows real-time rearrangement, stutter, and manipulation via MIDI triggering or internal sequencing.
360
+ - **Key features:**
361
+ - Automatic transient-based slicing of loaded breakbeat loops
362
+ - Real-time slice rearrangement and triggering via MIDI
363
+ - Stutter and repeat effects for glitch/drill-style patterns
364
+ - Pitch control per slice
365
+ - Designed for jungle, drum and bass, breakcore, and any genre using chopped breaks
366
+ - **Reach for this when:** you want to chop and rearrange breakbeats in real time, jungle/DnB production, glitch percussion
367
+ - **Pairs well with:** Drum Buss (grit and punch), Saturator (tape warmth), Beat Repeat (additional stuttering)
368
+
369
+ ---
370
+
371
+ ### trnr.Hatster
372
+
373
+ - **Type:** M4L Instrument (TRNR)
374
+ - **Load via:** `find_and_load_device("Hatster")`
375
+ - **What it does:** Hi-hat synthesizer inspired by modular synthesizers. Uses a noise oscillator core fed into a modeled Low-Pass Gate (LPG) filter/VCA that reacts uniquely to each incoming hit, especially with velocity variation. All parameters can be modulated by integrated sine-wave LFOs for evolving hi-hat patterns.
376
+ - **Key parameters:**
377
+ - **Noise Oscillator** -> core sound source
378
+ - **LPG Filter/VCA** -> modeled Vactrol-style filter/amplifier -> natural, fluid character with velocity-dependent response
379
+ - **Attack / Decay** -> shape the hit envelope
380
+ - **LFO Modulation** -> separate sine-wave LFOs on all parameters -> creates evolving, non-repetitive hat patterns
381
+ - **Velocity Sensitivity** -> LPG responds dynamically to velocity input -> softer hits = more muted/closed, harder hits = brighter/open
382
+ - **Pro version extras:** 3 distinct noise oscillators, tempo-synced LFOs, selectable LFO shapes, phase alignment control, linear/exponential/logarithmic envelope curves
383
+ - **Reach for this when:** you want modular-style hi-hats with natural velocity response and evolving LFO modulation
384
+ - **Pairs well with:** Step sequencers with velocity variation, Auto Pan (additional movement), Drum Buss
385
+
386
+ ---
387
+
388
+ ### trnr.Kickster
389
+
390
+ - **Type:** M4L Instrument (TRNR)
391
+ - **Load via:** `find_and_load_device("Kickster")`
392
+ - **What it does:** 4-operator FM synthesis kick drum synth with a uniquely shaped integrated envelope generator. Optimized for short, snappy kicks that leave room for other elements, but the tail can be extended for experimentation. The "boom" and "click" portions of the kick are independently controllable.
393
+ - **Key parameters:**
394
+ - **Boom controls** -> shape the body/sub portion of the kick
395
+ - **Click controls** -> shape the transient/attack portion
396
+ - **6 main controls** -> streamlined interface covering the essential sound-shaping parameters
397
+ - **Integrated envelope** -> unique compression-like shaping that makes the kick sound pre-processed
398
+ - **Reach for this when:** you need a synthesized techno/electronic kick with FM character, quick results with minimal controls
399
+ - **Pairs well with:** Drum Buss (additional punch), EQ Eight (surgical sub shaping), Saturator (harmonics)
400
+
401
+ ---
402
+
403
+ ### trnr.DmmG
404
+
405
+ - **Type:** M4L Audio Effect (TRNR)
406
+ - **Load via:** `find_and_load_device("DmmG")`
407
+ - **What it does:** Digital multi-mode gate audio effect. A logarithmic A/D envelope triggered by external MIDI opens the integrated VCA and VCF, letting you play an audio track like a subtractive synthesizer. Inspired by Vactrol filters/VCAs from modular synthesizers. Note: this is an audio effect, not an instrument — it processes existing audio.
408
+ - **Key parameters:**
409
+ - **Highpass / Lowpass Filters** -> multi-mode filtering
410
+ - **A/D Envelope** -> velocity-sensitive with logarithmic response
411
+ - **External MIDI trigger** -> selectable MIDI track to trigger the envelope
412
+ - **VCA** -> voltage-controlled amplifier gating
413
+ - **VCF** -> voltage-controlled filter
414
+ - **Pro version extras:** Bandpass and Notch filters, resonance/drive/frequency inversion controls, toggles to add/remove VCA and VCF from signal chain, full ADSR envelope
415
+ - **Reach for this when:** you want to rhythmically gate audio using MIDI triggering, create subtractive synth-like drum processing, creative gating effects
416
+ - **Pairs well with:** Long sustained audio sources, reverb tails, noise textures as input
417
+
418
+ ---
419
+
420
+ ### drumk 2 (K-Devices)
421
+
422
+ - **Type:** M4L Instrument (K-Devices)
423
+ - **Load via:** `find_and_load_device("drumk 2")`
424
+ - **What it does:** Grid-based sample manipulation instrument for beat-oriented sound design. Uses a multislider grid where each step has independent parameters and playback modes. Supports 2 simultaneous samples with crossfade, 8 snapshots per preset with gesture morphing, and step-sequenced effects.
425
+ - **Key parameters:**
426
+ - **Grid/Multislider System** -> per-step parameter editing for granular control over playback
427
+ - **Envelope** -> per-slice waveform shaping with Peak and Shape generators
428
+ - **XFade** -> interpolate amplitude between two loaded samples
429
+ - **Playback Modes** -> various modes per step for different behaviors
430
+ - **Randomization** -> random buttons, drunkwalk, walker mode, time variation probabilities
431
+ - **Snapshots** -> up to 8 per preset with gesture-based morphing (up to 8 gestures)
432
+ - **External Parameter Control** -> modulate up to 4 parameters in Live's GUI or third-party plugins
433
+ - **Sync** -> slices triggered in sync with Live transport or via MIDI notes
434
+ - **Reach for this when:** experimental/glitch percussion, generative drum patterns, sample mangling, granular beat design
435
+ - **Pairs well with:** Return effects (reverb/delay for processed slices), Drum Buss (cohesion), Auto Filter (movement)
436
+
437
+ ---
438
+
439
+ ### Drum Articulate (Max for Cats)
440
+
441
+ - **Type:** M4L MIDI Effect
442
+ - **Load via:** `find_and_load_device("Drum Articulate")`
443
+ - **What it does:** MIDI effect for programming sophisticated drum articulations. Creates drum rolls, flams, random triggers, and complex rhythmic embellishments. Can be placed on individual Drum Rack pads for per-pad articulation, or globally on a whole kit. Also works with synths and effects.
444
+ - **Key features:**
445
+ - **4 Triggers** -> each with freely adjustable delay time between triggers
446
+ - **Quantized switch** -> auto-quantize trigger timing to Live's master tempo
447
+ - **Flams** -> short delay between triggers creates natural flam articulation
448
+ - **Rolls** -> rapid repeated triggers for drum rolls
449
+ - **Random triggers** -> probabilistic triggering for humanized patterns
450
+ - **Per-pad or global** -> place on individual Drum Rack pad chains or on the whole track
451
+ - **Reach for this when:** you need realistic drum articulations (flams, rolls, drags), humanized pattern programming, rhythmic embellishments
452
+ - **Pairs well with:** Drum Rack (on individual pad chains), Velocity MIDI effect (dynamic variation), any drum instrument
453
+
454
+ ---
455
+
456
+ ## Drum Kit Guide by Genre/Character
457
+
458
+ > Complete catalog of the 139 drum kits available in this installation. Kits are grouped by sonic character and intended genre. All are Drum Rack presets loaded via `find_and_load_device("Kit Name")`.
459
+
460
+ ---
461
+
462
+ ### Classic Drum Machine Kits
463
+
464
+ > Sampled recreations of iconic hardware drum machines. These kits replicate the tonal controls of the original units.
465
+
466
+ #### Roland TR-505 Kits
467
+ - **Sound:** Budget digital PCM drum machine (1986). Thin, crispy, lo-fi digital samples. Cheap and cheerful character — thinner than 707/909.
468
+ - **Genre:** Early house, synth-pop, lo-fi electronic, industrial
469
+ - **Kits:** 505 Core Kit
470
+ - **Character:** Brittle digital, narrow frequency range, nostalgic lo-fi charm
471
+
472
+ #### Roland TR-606 Kits
473
+ - **Sound:** Analog companion to the TB-303 Bassline (1981). Delicate, thin analog voices — lighter and more polite than the 808/909. Crisp hi-hats, gentle kick, snappy snare.
474
+ - **Genre:** Acid house (paired with 303), minimal techno, lo-fi electronic
475
+ - **Kits:** 606 Core Kit
476
+ - **Character:** Light analog, paired historically with acid basslines, understated
477
+
478
+ #### Roland TR-707 Kits
479
+ - **Sound:** Digital PCM samples of real drums (1984). Famous for booming tom-toms. Cleaner and more "real" sounding than purely analog machines, but with a distinctly 80s digital sheen.
480
+ - **Genre:** Early Chicago house, Italo disco, synth-pop, freestyle
481
+ - **Kits:** 707 Core Kit
482
+ - **Character:** Digital realism with 80s character, booming toms, clean
483
+
484
+ #### Roland TR-808 Kits
485
+ - **Sound:** The most iconic drum machine ever (1980). Fully analog synthesis — deep, booming kick that doubles as bass, crisp handclap, sizzling hi-hats, cowbell. The kick's long decay makes it function as a bass instrument.
486
+ - **Genre:** Hip-hop (foundational), trap, electro, Miami bass, boom bap, R&B, Latin freestyle
487
+ - **Kits:** 808 Core Kit
488
+ - **Character:** Deep sub kick, punchy snare/clap, iconic cowbell, warm analog — THE hip-hop drum machine
489
+
490
+ #### Roland TR-909 Kits
491
+ - **Sound:** Hybrid analog/digital (1983). Analog kick/snare/toms with 6-bit sampled cymbals and hi-hats. The kick is punchier and tighter than the 808, with less sub. The digital cymbals have a distinctive crunchy sizzle.
492
+ - **Genre:** Techno (definitive), house, trance, acid, EBM, industrial
493
+ - **Kits:** 909 Core Kit
494
+ - **Character:** Punchy analog body + gritty digital cymbals, the techno standard
495
+
496
+ #### Roland CR-78 Kits
497
+ - **Sound:** First programmable drum machine (1978). Delicate, almost childlike analog voices. Kicks that pop, hi-hats that sizzle, snares that politely spit. Warm and textured but not aggressive.
498
+ - **Genre:** New wave, synth-pop, post-punk, art rock, ambient
499
+ - **Kits:** C78 Core Kit
500
+ - **Character:** Vintage, delicate, warm, unobtrusive — carries the beat without getting in the way
501
+
502
+ #### Oberheim DMX Kits
503
+ - **Sound:** 8-bit PCM samples of real drums, companded to ~12-bit quality (1981). Punchy, funky, warm bass drum, crunchy snares, boxy toms. Humanizing features (rolls, flams, timing variations).
504
+ - **Genre:** Hip-hop (early, foundational alongside 808), new wave, synth-pop, dancehall reggae, electro-funk
505
+ - **Kits:** DMX Core Kit
506
+ - **Character:** Punchy and funky, warm and raw, the other hip-hop drum machine (alongside 808)
507
+
508
+ #### LinnDrum / LM-1 ER Kits
509
+ - **Sound:** First drum machine with digitally sampled real drums (1980/1982). 8-bit samples with distinctive "sizzle" from aliasing artifacts above Nyquist frequency. Very punchy and prominent. Individual voice tuning.
510
+ - **Genre:** 80s pop (Prince, Michael Jackson), synth-pop, new wave, R&B, funk
511
+ - **Kits:** ER Core Kit (Electronic Rhythm), LD Core Kit (LinnDrum)
512
+ - **Character:** Punchy 8-bit real drum samples, 80s pop definition, the Prince drum machine
513
+
514
+ ---
515
+
516
+ ### Electronic / Techno Kits
517
+
518
+ > Designed and processed kits optimized for electronic music production.
519
+
520
+ | Kit Name | Character | Best For |
521
+ |---|---|---|
522
+ | AG Techno Kit | Aggressive, hard-hitting, processed | Peak-time techno, hard techno |
523
+ | Beastly Kit | Heavy, distorted, aggressive | Industrial techno, hard dance |
524
+ | Chicago Kit | Classic house elements, warm | Chicago house, deep house |
525
+ | Clockwork Kit | Precise, mechanical, tight | Minimal techno, tech house |
526
+ | Control Kit | Clean, controlled, versatile | Tech house, minimal |
527
+ | Controller Kit | Digital, precise, modern | Contemporary electronic |
528
+ | Dirty South Kit | Gritty, heavy, Southern character | Dirty south hip-hop/electronic |
529
+ | Diskette Kit | Lo-fi digital, crunchy | Lo-fi house, retro electronic |
530
+ | Dub System Kit | Spacious, delayed, sub-heavy | Dub techno, dub house |
531
+ | Dusty Kit | Aged, gritty, textured | Lo-fi, chill beats |
532
+ | Electric Kit | Bright, snappy, electronic | Electro, synth-pop |
533
+ | Execute Kit | Hard, punchy, aggressive | Hard techno, industrial |
534
+ | Gritter Kit | Gritty, distorted, rough | Industrial, noise-influenced |
535
+ | Headroom Kit | Clean, dynamic, spacious | House, techno, any electronic |
536
+ | Interface Kit | Clean, digital, precise | IDM, experimental electronic |
537
+ | Jackpot Kit | Fun, energetic, bright | Disco house, nu-disco |
538
+ | Kit-1 Analog Core | Pure analog synthesis | Analog-focused electronic |
539
+ | Kit-1 Dub Plates | Dub-influenced, spacious | Dub techno, dub |
540
+ | Kit-1 Elektro | Electro character, punchy | Electro, breakbeat |
541
+ | Kit-1 FM Kinetic | FM synthesis, metallic | IDM, experimental |
542
+ | Kit-1 Get Down | Funky, groovy | Disco, funk-influenced electronic |
543
+ | Kit-1 Kraft | Kraftwerk-inspired, minimal | Minimal electronic, synth-pop |
544
+ | Kit-1 Stripped | Minimal, clean, essential | Minimal techno/house |
545
+ | Kit-2 House | Classic house drums | House, deep house |
546
+ | Kit-2 Techno | Classic techno drums | Techno, tech house |
547
+ | Kit-3 Session | Live/electronic hybrid | Live electronic, crossover |
548
+ | Loose Kit | Relaxed timing feel, swing | Hip-hop, boom bap, neo-soul |
549
+ | Mainframe Kit | Digital, computational | IDM, glitch, experimental |
550
+ | Plastique Kit | Synthetic, plastic-like | Electro-pop, synth-pop |
551
+ | Probe Kit | Exploratory, unusual timbres | Experimental, sound design |
552
+ | Real Loud Kit | Maximized, compressed, loud | EDM, festival-style |
553
+ | Schematic Kit | Technical, precise, clean | Tech house, minimal |
554
+ | Servo Kit | Mechanical, robotic | Industrial, EBM |
555
+ | Sharp Kit | Bright, cutting, transient-focused | Any electronic needing presence |
556
+ | Surface Kit | Textured, layered | Ambient electronic, textural |
557
+ | Switches Kit | Glitchy, digital artifacts | Glitch, IDM |
558
+ | Synth Lab Kit | Synthesized, experimental | Sound design, experimental |
559
+ | Tandem Kit | Layered, paired sounds | Any electronic |
560
+ | Tangent Kit | Angular, unusual | Experimental, art electronic |
561
+ | Transit Kit | Movement, evolving | Progressive electronic |
562
+ | Warehouse Kit | Raw, spacious, reverberant | Warehouse techno, rave |
563
+ | Wire Kit | Metallic, thin, high-frequency | Industrial, noise, experimental |
564
+
565
+ ---
566
+
567
+ ### Hip-Hop / Boom Bap Kits
568
+
569
+ | Kit Name | Character | Best For |
570
+ |---|---|---|
571
+ | Boom Bap Kit | Classic SP-1200/MPC style, crunchy | 90s boom bap, golden era hip-hop |
572
+ | Heritage Kit | Vintage, warm, soulful samples | Sample-based hip-hop, neo-soul |
573
+ | Street Mind Kit | Gritty, urban, hard | East coast hip-hop, grime |
574
+ | Loose Kit | Swung, relaxed, humanized | Boom bap, lo-fi hip-hop |
575
+ | Dirty South Kit | Heavy, sub-focused, gritty | Southern hip-hop, crunk |
576
+ | Dusty Kit | Aged, vinyl-textured, lo-fi | Lo-fi hip-hop, chill beats |
577
+
578
+ ---
579
+
580
+ ### Acoustic / Live Kits
581
+
582
+ | Kit Name | Character | Best For |
583
+ |---|---|---|
584
+ | Dry Session Kit | Close-miked, tight, no room | Pop, rock, R&B, singer-songwriter |
585
+ | Gen Purpose Kit | Versatile, balanced, neutral | Any genre needing realistic drums |
586
+ | Plymouth Kit | Warm, mid-focused, vintage | Indie, folk-rock, singer-songwriter |
587
+ | Kit-3 Session | Acoustic/electronic hybrid | Live electronic, crossover |
588
+
589
+ ---
590
+
591
+ ### Experimental / Artist Kits
592
+
593
+ > Signature kits by guest artists and sound designers with distinctive sonic identities.
594
+
595
+ | Kit Name | Artist/Designer | Character | Best For |
596
+ |---|---|---|---|
597
+ | Epistrophe Kit | Ivo Ivanov | Field recordings, found sounds, concrete | Musique concrete, experimental, ambient |
598
+ | Minimal Berlin Drums | Bobinger | Ultra-minimal, clinical, Berlin aesthetic | Berlin minimal techno, microhouse |
599
+ | Sinner Rack | Piezo | Distorted, harsh, uncompromising | Industrial, noise, experimental |
600
+
601
+ ---
602
+
603
+ ### MPE-Enabled Kits
604
+
605
+ > Drum Racks with MPE (MIDI Polyphonic Expression) support. Respond to per-note pressure, slide, and pitch bend for expressive drum performance.
606
+
607
+ | Kit Name | Character | Best For |
608
+ |---|---|---|
609
+ | MPE Analog Kit | Analog synth drums with MPE response | Expressive performance, Push 3 |
610
+ | MPE Meld Kit | Meld synth-based drums with MPE | Textural, evolving drum sounds |
611
+ | MPE Synth Lab Kit | Synthesized drums with full MPE control | Sound design, experimental performance |
612
+
613
+ ---
614
+
615
+ ### User-Created Kits
616
+
617
+ > Custom kits created by the user. Sonic character varies — inspect contents in Drum Rack to understand what is loaded.
618
+
619
+ | Kit Name | Notes |
620
+ |---|---|
621
+ | clan kit | User custom |
622
+ | ioi kit | User custom |
623
+ | kok kit | User custom |
624
+ | non kit | User custom |
625
+ | ooo kit | User custom |
626
+ | zzon kit | User custom |
627
+
628
+ ---
629
+
630
+ ## Quick Decision Matrix
631
+
632
+ ### "I need a kick drum"
633
+
634
+ | Situation | Device | Why |
635
+ |---|---|---|
636
+ | Deep 808 sub kick | DS Kick (long Decay, high Env) | Sine-based, sub-focused |
637
+ | Punchy techno kick | trnr.Kickster | FM synthesis, pre-shaped envelope |
638
+ | Sampled acoustic kick | Drum Sampler + kick sample | Full sample control with Punch effect |
639
+ | Quick electronic kick | DS Kick (short Decay, Click ON) | Fast, no fuss |
640
+ | Layered production kick | Drum Rack (multiple chains on one pad) | Sub + body + click layers |
641
+
642
+ ### "I need hi-hats"
643
+
644
+ | Situation | Device | Why |
645
+ |---|---|---|
646
+ | Classic electronic hats | DS HH (2 instances, choke group) | Quick, chokeable open/closed pair |
647
+ | Evolving modular-style hats | trnr.Hatster | LPG + LFO modulation |
648
+ | Sampled acoustic/processed hats | Drum Sampler + hat samples | Sample-based with effects |
649
+ | Glitchy hat patterns | drumk 2 with hat sample | Grid-based manipulation |
650
+
651
+ ### "I need a snare"
652
+
653
+ | Situation | Device | Why |
654
+ |---|---|---|
655
+ | Electronic noise snare | DS Snare (high Tone) | Noise-dominated synthesis |
656
+ | Acoustic body snare | DS Snare (low Tone, tune the body) | Pitched oscillator focus |
657
+ | Sampled snare with processing | Drum Sampler + 8-Bit or Punch effect | Sample + built-in coloring |
658
+ | Layered snare with flam | Drum Articulate MIDI FX -> DS Snare | Articulation control |
659
+
660
+ ### "I need to process my drum bus"
661
+
662
+ | Situation | Device | Why |
663
+ |---|---|---|
664
+ | Quick color and punch | Drum Buss | All-in-one: drive, transients, boom |
665
+ | SSL-style bus glue | Glue Compressor | Musical cohesion |
666
+ | Sub reinforcement only | Drum Buss (Boom section, Drive off) | Resonant bass enhancer |
667
+ | Transparent leveling | Compressor (RMS mode, gentle ratio) | Clinical dynamics |
668
+ | Transient emphasis + saturation | Drum Buss (Transients positive, Crunch up) | Combined processing |
669
+
670
+ ### "I need percussion"
671
+
672
+ | Situation | Device | Why |
673
+ |---|---|---|
674
+ | Cowbell / clave | DS Clang | Two-tone metallic synth with Clave mode |
675
+ | FM metallic percussion | DS FM | DX7-style tuned percussion |
676
+ | Tom fills | DS Tom | Tunable pitched toms |
677
+ | Breakbeat chops | AmenMachine | Slice and rearrange breaks |
678
+ | Complex articulations | Drum Articulate -> any drum | Flams, rolls, random triggers |
679
+
680
+ ### "Which drum machine kit do I pick?"
681
+
682
+ | Genre | First Choice Kit | Runner-Up |
683
+ |---|---|---|
684
+ | Hip-hop / Trap | 808 Core Kit | Boom Bap Kit |
685
+ | Techno | 909 Core Kit | AG Techno Kit |
686
+ | House | Chicago Kit | Kit-2 House |
687
+ | Minimal | Clockwork Kit | Minimal Berlin Drums |
688
+ | Lo-fi / Chill | Dusty Kit | Loose Kit |
689
+ | Synth-pop / New Wave | C78 Core Kit | 707 Core Kit |
690
+ | Industrial | Beastly Kit | Execute Kit |
691
+ | DnB / Jungle | AmenMachine + 909 hats | Warehouse Kit |
692
+ | Experimental | Epistrophe Kit | Probe Kit |
693
+ | Electro | Kit-1 Elektro | DMX Core Kit |
694
+ | Pop / Acoustic | Dry Session Kit | Gen Purpose Kit |
695
+ | Dub | Dub System Kit | Kit-1 Dub Plates |
696
+ | 80s Pop | ER Core Kit / LD Core Kit | 707 Core Kit |
697
+
698
+ ---
699
+
700
+ ## LivePilot Integration Notes
701
+
702
+ ### Loading Drums
703
+ ```
704
+ # Load a complete drum kit
705
+ find_and_load_device("808 Core Kit")
706
+
707
+ # Load a DS synth onto a specific Drum Rack pad
708
+ # First load Drum Rack, then load DS device into a pad chain
709
+ find_and_load_device("Drum Rack")
710
+ find_and_load_device("DS Kick") # loads into selected pad
711
+
712
+ # Load Drum Buss on the drum group bus
713
+ find_and_load_device("Drum Buss")
714
+ ```
715
+
716
+ ### Programming Drums
717
+ ```
718
+ # Standard drum note mapping (GM-compatible)
719
+ # C1 (36) = Kick
720
+ # D1 (38) = Snare
721
+ # E1 (40) = Low Tom
722
+ # F1 (41) = Mid Tom
723
+ # F#1 (42) = Closed HH
724
+ # A1 (45) = High Tom
725
+ # A#1 (46) = Open HH
726
+ # C#2 (49) = Crash
727
+ # D#2 (51) = Ride
728
+ # D#1 (39) = Clap / Rimshot
729
+
730
+ # Add a kick pattern (quarter notes in 4/4, 1 bar)
731
+ add_notes(track=0, clip=0, notes=[
732
+ {"pitch": 36, "start_time": 0.0, "duration": 0.25, "velocity": 100},
733
+ {"pitch": 36, "start_time": 1.0, "duration": 0.25, "velocity": 100},
734
+ {"pitch": 36, "start_time": 2.0, "duration": 0.25, "velocity": 100},
735
+ {"pitch": 36, "start_time": 3.0, "duration": 0.25, "velocity": 100}
736
+ ])
737
+ ```
738
+
739
+ ### Setting Device Parameters
740
+ ```
741
+ # Drum Buss example: punchy drums with sub boost
742
+ set_device_parameter(track=0, device=1, parameter="Drive", value=0.4)
743
+ set_device_parameter(track=0, device=1, parameter="Crunch", value=0.3)
744
+ set_device_parameter(track=0, device=1, parameter="Transients", value=0.5)
745
+ set_device_parameter(track=0, device=1, parameter="Boom", value=0.6)
746
+ set_device_parameter(track=0, device=1, parameter="Freq", value=60)
747
+
748
+ # DS Kick: 808-style sub kick
749
+ set_device_parameter(track=0, device=0, parameter="Pitch", value=48)
750
+ set_device_parameter(track=0, device=0, parameter="Env", value=0.7)
751
+ set_device_parameter(track=0, device=0, parameter="Decay", value=0.8)
752
+ set_device_parameter(track=0, device=0, parameter="Drive", value=0.2)
753
+ ```