livepilot 1.9.23 → 1.10.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 (191) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/AGENTS.md +3 -3
  3. package/CHANGELOG.md +119 -0
  4. package/CONTRIBUTING.md +1 -1
  5. package/README.md +144 -13
  6. package/bin/livepilot.js +87 -0
  7. package/installer/codex.js +147 -0
  8. package/livepilot/.Codex-plugin/plugin.json +2 -2
  9. package/livepilot/.claude-plugin/plugin.json +2 -2
  10. package/livepilot/skills/livepilot-core/SKILL.md +21 -4
  11. package/livepilot/skills/livepilot-core/references/device-knowledge/00-index.md +34 -0
  12. package/livepilot/skills/livepilot-core/references/device-knowledge/automation-as-music.md +204 -0
  13. package/livepilot/skills/livepilot-core/references/device-knowledge/chains-genre.md +173 -0
  14. package/livepilot/skills/livepilot-core/references/device-knowledge/creative-thinking.md +211 -0
  15. package/livepilot/skills/livepilot-core/references/device-knowledge/effects-distortion.md +188 -0
  16. package/livepilot/skills/livepilot-core/references/device-knowledge/effects-space.md +162 -0
  17. package/livepilot/skills/livepilot-core/references/device-knowledge/effects-spectral.md +229 -0
  18. package/livepilot/skills/livepilot-core/references/device-knowledge/instruments-synths.md +243 -0
  19. package/livepilot/skills/livepilot-core/references/overview.md +13 -9
  20. package/livepilot/skills/livepilot-core/references/sample-manipulation.md +724 -0
  21. package/livepilot/skills/livepilot-core/references/sound-design-deep.md +140 -0
  22. package/livepilot/skills/livepilot-devices/SKILL.md +16 -2
  23. package/livepilot/skills/livepilot-evaluation/references/capability-modes.md +1 -1
  24. package/livepilot/skills/livepilot-release/SKILL.md +19 -5
  25. package/livepilot/skills/livepilot-sample-engine/SKILL.md +104 -0
  26. package/livepilot/skills/livepilot-sample-engine/references/sample-critics.md +87 -0
  27. package/livepilot/skills/livepilot-sample-engine/references/sample-philosophy.md +51 -0
  28. package/livepilot/skills/livepilot-sample-engine/references/sample-techniques.md +131 -0
  29. package/livepilot/skills/livepilot-sound-design-engine/SKILL.md +45 -0
  30. package/livepilot/skills/livepilot-wonder/SKILL.md +15 -0
  31. package/livepilot.mcpb +0 -0
  32. package/m4l_device/livepilot_bridge.js +1 -1
  33. package/manifest.json +2 -2
  34. package/mcp_server/__init__.py +1 -1
  35. package/mcp_server/atlas/__init__.py +357 -0
  36. package/mcp_server/atlas/device_atlas.json +44067 -0
  37. package/mcp_server/atlas/enrichments/__init__.py +111 -0
  38. package/mcp_server/atlas/enrichments/audio_effects/auto_filter.yaml +162 -0
  39. package/mcp_server/atlas/enrichments/audio_effects/beat_repeat.yaml +183 -0
  40. package/mcp_server/atlas/enrichments/audio_effects/channel_eq.yaml +126 -0
  41. package/mcp_server/atlas/enrichments/audio_effects/chorus_ensemble.yaml +149 -0
  42. package/mcp_server/atlas/enrichments/audio_effects/color_limiter.yaml +109 -0
  43. package/mcp_server/atlas/enrichments/audio_effects/compressor.yaml +159 -0
  44. package/mcp_server/atlas/enrichments/audio_effects/convolution_reverb.yaml +143 -0
  45. package/mcp_server/atlas/enrichments/audio_effects/convolution_reverb_pro.yaml +178 -0
  46. package/mcp_server/atlas/enrichments/audio_effects/delay.yaml +151 -0
  47. package/mcp_server/atlas/enrichments/audio_effects/drum_buss.yaml +142 -0
  48. package/mcp_server/atlas/enrichments/audio_effects/dynamic_tube.yaml +147 -0
  49. package/mcp_server/atlas/enrichments/audio_effects/echo.yaml +167 -0
  50. package/mcp_server/atlas/enrichments/audio_effects/eq_eight.yaml +148 -0
  51. package/mcp_server/atlas/enrichments/audio_effects/eq_three.yaml +121 -0
  52. package/mcp_server/atlas/enrichments/audio_effects/erosion.yaml +103 -0
  53. package/mcp_server/atlas/enrichments/audio_effects/filter_delay.yaml +173 -0
  54. package/mcp_server/atlas/enrichments/audio_effects/gate.yaml +130 -0
  55. package/mcp_server/atlas/enrichments/audio_effects/gated_delay.yaml +133 -0
  56. package/mcp_server/atlas/enrichments/audio_effects/glue_compressor.yaml +142 -0
  57. package/mcp_server/atlas/enrichments/audio_effects/grain_delay.yaml +141 -0
  58. package/mcp_server/atlas/enrichments/audio_effects/hybrid_reverb.yaml +160 -0
  59. package/mcp_server/atlas/enrichments/audio_effects/limiter.yaml +97 -0
  60. package/mcp_server/atlas/enrichments/audio_effects/multiband_dynamics.yaml +174 -0
  61. package/mcp_server/atlas/enrichments/audio_effects/overdrive.yaml +119 -0
  62. package/mcp_server/atlas/enrichments/audio_effects/pedal.yaml +145 -0
  63. package/mcp_server/atlas/enrichments/audio_effects/phaser_flanger.yaml +161 -0
  64. package/mcp_server/atlas/enrichments/audio_effects/redux.yaml +114 -0
  65. package/mcp_server/atlas/enrichments/audio_effects/reverb.yaml +190 -0
  66. package/mcp_server/atlas/enrichments/audio_effects/roar.yaml +159 -0
  67. package/mcp_server/atlas/enrichments/audio_effects/saturator.yaml +146 -0
  68. package/mcp_server/atlas/enrichments/audio_effects/shifter.yaml +154 -0
  69. package/mcp_server/atlas/enrichments/audio_effects/spectral_resonator.yaml +141 -0
  70. package/mcp_server/atlas/enrichments/audio_effects/spectral_time.yaml +164 -0
  71. package/mcp_server/atlas/enrichments/audio_effects/vector_delay.yaml +140 -0
  72. package/mcp_server/atlas/enrichments/audio_effects/vinyl_distortion.yaml +141 -0
  73. package/mcp_server/atlas/enrichments/instruments/analog.yaml +222 -0
  74. package/mcp_server/atlas/enrichments/instruments/bass.yaml +202 -0
  75. package/mcp_server/atlas/enrichments/instruments/collision.yaml +150 -0
  76. package/mcp_server/atlas/enrichments/instruments/drift.yaml +167 -0
  77. package/mcp_server/atlas/enrichments/instruments/electric.yaml +137 -0
  78. package/mcp_server/atlas/enrichments/instruments/emit.yaml +163 -0
  79. package/mcp_server/atlas/enrichments/instruments/meld.yaml +164 -0
  80. package/mcp_server/atlas/enrichments/instruments/operator.yaml +197 -0
  81. package/mcp_server/atlas/enrichments/instruments/poli.yaml +192 -0
  82. package/mcp_server/atlas/enrichments/instruments/sampler.yaml +218 -0
  83. package/mcp_server/atlas/enrichments/instruments/simpler.yaml +217 -0
  84. package/mcp_server/atlas/enrichments/instruments/tension.yaml +156 -0
  85. package/mcp_server/atlas/enrichments/instruments/tree_tone.yaml +162 -0
  86. package/mcp_server/atlas/enrichments/instruments/vector_fm.yaml +165 -0
  87. package/mcp_server/atlas/enrichments/instruments/vector_grain.yaml +166 -0
  88. package/mcp_server/atlas/enrichments/instruments/wavetable.yaml +162 -0
  89. package/mcp_server/atlas/enrichments/midi_effects/arpeggiator.yaml +156 -0
  90. package/mcp_server/atlas/enrichments/midi_effects/bouncy_notes.yaml +93 -0
  91. package/mcp_server/atlas/enrichments/midi_effects/chord.yaml +147 -0
  92. package/mcp_server/atlas/enrichments/midi_effects/melodic_steps.yaml +97 -0
  93. package/mcp_server/atlas/enrichments/midi_effects/note_echo.yaml +108 -0
  94. package/mcp_server/atlas/enrichments/midi_effects/note_length.yaml +97 -0
  95. package/mcp_server/atlas/enrichments/midi_effects/pitch.yaml +76 -0
  96. package/mcp_server/atlas/enrichments/midi_effects/random.yaml +117 -0
  97. package/mcp_server/atlas/enrichments/midi_effects/rhythmic_steps.yaml +103 -0
  98. package/mcp_server/atlas/enrichments/midi_effects/scale.yaml +83 -0
  99. package/mcp_server/atlas/enrichments/midi_effects/step_arp.yaml +112 -0
  100. package/mcp_server/atlas/enrichments/midi_effects/velocity.yaml +119 -0
  101. package/mcp_server/atlas/enrichments/utility/amp.yaml +159 -0
  102. package/mcp_server/atlas/enrichments/utility/cabinet.yaml +109 -0
  103. package/mcp_server/atlas/enrichments/utility/corpus.yaml +150 -0
  104. package/mcp_server/atlas/enrichments/utility/resonators.yaml +131 -0
  105. package/mcp_server/atlas/enrichments/utility/spectrum.yaml +63 -0
  106. package/mcp_server/atlas/enrichments/utility/tuner.yaml +51 -0
  107. package/mcp_server/atlas/enrichments/utility/utility.yaml +136 -0
  108. package/mcp_server/atlas/enrichments/utility/vocoder.yaml +160 -0
  109. package/mcp_server/atlas/scanner.py +236 -0
  110. package/mcp_server/atlas/tools.py +224 -0
  111. package/mcp_server/composer/__init__.py +1 -0
  112. package/mcp_server/composer/engine.py +452 -0
  113. package/mcp_server/composer/layer_planner.py +427 -0
  114. package/mcp_server/composer/prompt_parser.py +329 -0
  115. package/mcp_server/composer/tools.py +201 -0
  116. package/mcp_server/connection.py +53 -8
  117. package/mcp_server/corpus/__init__.py +377 -0
  118. package/mcp_server/device_forge/__init__.py +1 -0
  119. package/mcp_server/device_forge/builder.py +377 -0
  120. package/mcp_server/device_forge/models.py +142 -0
  121. package/mcp_server/device_forge/templates.py +483 -0
  122. package/mcp_server/device_forge/tools.py +162 -0
  123. package/mcp_server/hook_hunter/analyzer.py +23 -0
  124. package/mcp_server/hook_hunter/models.py +1 -0
  125. package/mcp_server/hook_hunter/tools.py +4 -2
  126. package/mcp_server/m4l_bridge.py +1 -0
  127. package/mcp_server/memory/taste_graph.py +68 -1
  128. package/mcp_server/memory/tools.py +15 -4
  129. package/mcp_server/musical_intelligence/detectors.py +14 -1
  130. package/mcp_server/musical_intelligence/tools.py +11 -8
  131. package/mcp_server/persistence/__init__.py +1 -0
  132. package/mcp_server/persistence/base_store.py +82 -0
  133. package/mcp_server/persistence/project_store.py +106 -0
  134. package/mcp_server/persistence/taste_store.py +122 -0
  135. package/mcp_server/preview_studio/models.py +1 -0
  136. package/mcp_server/preview_studio/tools.py +56 -13
  137. package/mcp_server/runtime/capability.py +66 -0
  138. package/mcp_server/runtime/capability_probe.py +137 -0
  139. package/mcp_server/runtime/execution_router.py +143 -0
  140. package/mcp_server/runtime/live_version.py +102 -0
  141. package/mcp_server/runtime/remote_commands.py +87 -0
  142. package/mcp_server/runtime/tools.py +18 -4
  143. package/mcp_server/sample_engine/__init__.py +1 -0
  144. package/mcp_server/sample_engine/analyzer.py +216 -0
  145. package/mcp_server/sample_engine/critics.py +390 -0
  146. package/mcp_server/sample_engine/models.py +193 -0
  147. package/mcp_server/sample_engine/moves.py +127 -0
  148. package/mcp_server/sample_engine/planner.py +186 -0
  149. package/mcp_server/sample_engine/sources.py +540 -0
  150. package/mcp_server/sample_engine/techniques.py +908 -0
  151. package/mcp_server/sample_engine/tools.py +442 -0
  152. package/mcp_server/semantic_moves/__init__.py +3 -0
  153. package/mcp_server/semantic_moves/device_creation_moves.py +237 -0
  154. package/mcp_server/semantic_moves/mix_moves.py +41 -41
  155. package/mcp_server/semantic_moves/performance_moves.py +13 -13
  156. package/mcp_server/semantic_moves/sample_compilers.py +372 -0
  157. package/mcp_server/semantic_moves/sound_design_moves.py +15 -15
  158. package/mcp_server/semantic_moves/tools.py +18 -17
  159. package/mcp_server/semantic_moves/transition_moves.py +16 -16
  160. package/mcp_server/server.py +51 -0
  161. package/mcp_server/services/__init__.py +1 -0
  162. package/mcp_server/services/motif_service.py +67 -0
  163. package/mcp_server/session_continuity/tracker.py +29 -1
  164. package/mcp_server/song_brain/builder.py +28 -1
  165. package/mcp_server/song_brain/models.py +4 -0
  166. package/mcp_server/song_brain/tools.py +20 -2
  167. package/mcp_server/sound_design/critics.py +89 -1
  168. package/mcp_server/splice_client/__init__.py +1 -0
  169. package/mcp_server/splice_client/client.py +347 -0
  170. package/mcp_server/splice_client/models.py +96 -0
  171. package/mcp_server/splice_client/protos/__init__.py +1 -0
  172. package/mcp_server/splice_client/protos/app_pb2.py +319 -0
  173. package/mcp_server/splice_client/protos/app_pb2.pyi +1153 -0
  174. package/mcp_server/splice_client/protos/app_pb2_grpc.py +1946 -0
  175. package/mcp_server/tools/arrangement.py +69 -0
  176. package/mcp_server/tools/automation.py +15 -2
  177. package/mcp_server/tools/devices.py +117 -6
  178. package/mcp_server/tools/notes.py +37 -4
  179. package/mcp_server/wonder_mode/diagnosis.py +5 -0
  180. package/mcp_server/wonder_mode/engine.py +85 -1
  181. package/mcp_server/wonder_mode/tools.py +6 -1
  182. package/package.json +12 -2
  183. package/remote_script/LivePilot/__init__.py +8 -1
  184. package/remote_script/LivePilot/arrangement.py +114 -0
  185. package/remote_script/LivePilot/browser.py +56 -1
  186. package/remote_script/LivePilot/devices.py +236 -6
  187. package/remote_script/LivePilot/mixing.py +8 -3
  188. package/remote_script/LivePilot/server.py +5 -1
  189. package/remote_script/LivePilot/transport.py +3 -0
  190. package/remote_script/LivePilot/version_detect.py +78 -0
  191. package/scripts/sync_metadata.py +132 -0
@@ -0,0 +1,178 @@
1
+ id: convolution_reverb_pro
2
+ name: Convolution Reverb Pro
3
+ sonic_description: >
4
+ Extended convolution reverb with advanced controls beyond the standard version. Adds
5
+ per-channel EQ, modulation, position control within the IR, and more flexible decay
6
+ shaping. Provides the realism of impulse responses with deeper sound design options
7
+ for detailed space emulation and creative IR manipulation.
8
+ effect_type: reverb
9
+ character_tags: [realistic, detailed, professional, flexible, immersive]
10
+ use_cases: [detailed_space_emulation, professional_reverb, ir_sound_design, film_scoring, mastering_reverb]
11
+ genre_affinity:
12
+ primary: [all]
13
+ secondary: []
14
+ complexity: advanced
15
+ signal_type: audio
16
+ introduced_in: "10.0"
17
+ m4l_device: true
18
+
19
+ key_parameters:
20
+ - name: "IR"
21
+ description: "Impulse response file — the recorded space character"
22
+ type: file
23
+ sweet_spots:
24
+ room: "Studio or Room IR"
25
+ hall: "Concert Hall IR"
26
+ creative: "Experimental IR"
27
+
28
+ - name: "Size"
29
+ description: "Scales the impulse response duration"
30
+ range: [10.0, 400.0]
31
+ unit: "%"
32
+ type: float
33
+ sweet_spots:
34
+ small: 50.0
35
+ natural: 100.0
36
+ large: 200.0
37
+
38
+ - name: "Pre Delay"
39
+ description: "Delay before the reverb onset"
40
+ range: [0.0, 500.0]
41
+ unit: ms
42
+ type: float
43
+ sweet_spots:
44
+ intimate: 0.0
45
+ separated: 25.0
46
+ distant: 60.0
47
+
48
+ - name: "Decay"
49
+ description: "Adjusts the decay envelope of the IR"
50
+ range: [0.1, 10.0]
51
+ unit: s
52
+ type: float
53
+ sweet_spots:
54
+ short: 0.5
55
+ medium: 2.0
56
+ long: 5.0
57
+
58
+ - name: "Position"
59
+ description: "Starting point within the IR — skip early reflections or start mid-tail"
60
+ range: [0.0, 100.0]
61
+ unit: "%"
62
+ type: float
63
+ sweet_spots:
64
+ start: 0.0
65
+ skip_early: 20.0
66
+ mid_tail: 50.0
67
+
68
+ - name: "Mod Rate"
69
+ description: "Modulation speed applied to the convolution"
70
+ range: [0.01, 10.0]
71
+ unit: Hz
72
+ type: float
73
+ sweet_spots:
74
+ slow: 0.2
75
+ moderate: 1.0
76
+ fast: 4.0
77
+
78
+ - name: "Mod Depth"
79
+ description: "Depth of modulation — adds movement to static IRs"
80
+ range: [0.0, 100.0]
81
+ unit: "%"
82
+ type: float
83
+ sweet_spots:
84
+ off: 0.0
85
+ subtle: 15.0
86
+ moderate: 40.0
87
+
88
+ - name: "EQ Low"
89
+ description: "Low-frequency gain on the reverb"
90
+ range: [-15.0, 15.0]
91
+ unit: dB
92
+ type: float
93
+ sweet_spots:
94
+ cut: -6.0
95
+ flat: 0.0
96
+
97
+ - name: "EQ Mid"
98
+ description: "Mid-frequency gain on the reverb"
99
+ range: [-15.0, 15.0]
100
+ unit: dB
101
+ type: float
102
+ sweet_spots:
103
+ flat: 0.0
104
+ scoop: -3.0
105
+
106
+ - name: "EQ High"
107
+ description: "High-frequency gain on the reverb"
108
+ range: [-15.0, 15.0]
109
+ unit: dB
110
+ type: float
111
+ sweet_spots:
112
+ dark: -6.0
113
+ flat: 0.0
114
+ air: 3.0
115
+
116
+ - name: "Dry/Wet"
117
+ description: "Mix between dry and convolved signal"
118
+ range: [0.0, 100.0]
119
+ unit: "%"
120
+ type: float
121
+ sweet_spots:
122
+ subtle: 15.0
123
+ moderate: 30.0
124
+ heavy: 50.0
125
+ return_track: 100.0
126
+
127
+ pairs_well_with:
128
+ - device: "EQ Eight"
129
+ reason: "Detailed post-reverb EQ for precise tonal shaping"
130
+ - device: "Compressor"
131
+ reason: "Dynamic control of the reverb tail"
132
+ - device: "Hybrid Reverb"
133
+ reason: "Layer convolution Pro with Hybrid for complex multi-space effects"
134
+ - device: "Utility"
135
+ reason: "Width and level control on the reverb output"
136
+
137
+ starter_recipes:
138
+ - name: "Detailed Space Emulation"
139
+ description: "High-fidelity room emulation with modulation for liveliness"
140
+ genre: all
141
+ params:
142
+ Size: 100.0
143
+ "Pre Delay": 15.0
144
+ Decay: 2.0
145
+ "Mod Rate": 0.5
146
+ "Mod Depth": 10.0
147
+ "EQ Low": -3.0
148
+ "Dry/Wet": 25.0
149
+
150
+ - name: "Cinematic Hall"
151
+ description: "Large, detailed hall reverb for orchestral and film scoring"
152
+ genre: cinematic
153
+ params:
154
+ Size: 180.0
155
+ "Pre Delay": 30.0
156
+ Decay: 4.0
157
+ "Mod Rate": 0.3
158
+ "Mod Depth": 15.0
159
+ "EQ High": 2.0
160
+ "Dry/Wet": 30.0
161
+
162
+ - name: "Creative IR Manipulation"
163
+ description: "Use Position and Size to reshape an IR into something new"
164
+ genre: experimental
165
+ params:
166
+ Position: 30.0
167
+ Size: 250.0
168
+ Decay: 6.0
169
+ "Mod Rate": 1.5
170
+ "Mod Depth": 40.0
171
+ "Dry/Wet": 40.0
172
+
173
+ gotchas:
174
+ - "This is a Max for Live device — requires Suite or M4L license"
175
+ - "More CPU and memory intensive than the standard Convolution Reverb"
176
+ - "Position parameter is unique — skipping into the IR tail removes early reflections for drone-like textures"
177
+ - "Modulation on a convolution reverb can sound unnatural at high depths — use subtly for liveness"
178
+ - "Custom IR loading supports WAV/AIFF — experiment with non-reverb recordings as IRs for wild results"
@@ -0,0 +1,151 @@
1
+ id: delay
2
+ name: Delay
3
+ sonic_description: >
4
+ Clean stereo delay with independent left and right times, feedback control, and a built-in
5
+ filter on the feedback path. From tight slapback to spacious ping-pong echoes, it provides
6
+ transparent repetitions without added coloration.
7
+ effect_type: delay
8
+ character_tags: [clean, spacious, rhythmic, transparent, versatile]
9
+ use_cases: [stereo_delay, slapback, ping_pong, dub_delay, rhythmic_echo, depth]
10
+ genre_affinity:
11
+ primary: [all]
12
+ secondary: []
13
+ complexity: beginner
14
+ signal_type: audio
15
+ introduced_in: "1.0"
16
+
17
+ key_parameters:
18
+ - name: "Time Left"
19
+ description: "Delay time for left channel — sync to tempo or set in ms"
20
+ range: [1.0, 3000.0]
21
+ unit: ms
22
+ type: float
23
+ sweet_spots:
24
+ slapback: 80.0
25
+ quarter: 500.0
26
+ dotted_eighth: 375.0
27
+
28
+ - name: "Time Right"
29
+ description: "Delay time for right channel"
30
+ range: [1.0, 3000.0]
31
+ unit: ms
32
+ type: float
33
+ sweet_spots:
34
+ slapback: 80.0
35
+ quarter: 500.0
36
+ dotted_eighth: 375.0
37
+
38
+ - name: "Sync"
39
+ description: "Sync delay times to song tempo"
40
+ type: toggle
41
+ range: [0, 1]
42
+ sweet_spots:
43
+ synced: 1
44
+
45
+ - name: "Sync Left"
46
+ description: "Tempo-synced division for left channel"
47
+ range: ["1/16", "1/8T", "1/8", "3/16", "1/4T", "1/4", "3/8", "1/2", "1"]
48
+ type: enum
49
+ sweet_spots:
50
+ eighth: "1/8"
51
+ dotted_eighth: "3/16"
52
+ quarter: "1/4"
53
+
54
+ - name: "Sync Right"
55
+ description: "Tempo-synced division for right channel"
56
+ range: ["1/16", "1/8T", "1/8", "3/16", "1/4T", "1/4", "3/8", "1/2", "1"]
57
+ type: enum
58
+ sweet_spots:
59
+ eighth: "1/8"
60
+ dotted_eighth: "3/16"
61
+ quarter: "1/4"
62
+
63
+ - name: "Feedback"
64
+ description: "Amount of delayed signal fed back into the input — controls number of repeats"
65
+ range: [0.0, 100.0]
66
+ unit: "%"
67
+ type: float
68
+ sweet_spots:
69
+ single: 0.0
70
+ few_taps: 30.0
71
+ dub: 60.0
72
+ runaway: 90.0
73
+
74
+ - name: "Filter"
75
+ description: "Filter on the feedback path — darkens repeats over time"
76
+ type: toggle
77
+ range: [0, 1]
78
+
79
+ - name: "Filter Freq"
80
+ description: "Feedback filter frequency"
81
+ range: [20.0, 20000.0]
82
+ unit: Hz
83
+ type: float
84
+ sweet_spots:
85
+ dark: 2000.0
86
+ warm: 4000.0
87
+
88
+ - name: "Ping Pong"
89
+ description: "Alternates echoes between left and right channels"
90
+ type: toggle
91
+ range: [0, 1]
92
+
93
+ - name: "Dry/Wet"
94
+ description: "Mix between dry and delayed signal"
95
+ range: [0.0, 100.0]
96
+ unit: "%"
97
+ type: float
98
+ sweet_spots:
99
+ subtle: 15.0
100
+ moderate: 25.0
101
+ wet: 50.0
102
+ return_track: 100.0
103
+
104
+ pairs_well_with:
105
+ - device: "EQ Eight"
106
+ reason: "Cut low frequencies before delay to prevent muddy echoes"
107
+ - device: "Reverb"
108
+ reason: "Delay into reverb creates depth and spaciousness"
109
+ - device: "Auto Filter"
110
+ reason: "Filter the delayed signal for evolving echo textures"
111
+ - device: "Compressor"
112
+ reason: "Control dynamics of the delayed signal on return tracks"
113
+
114
+ starter_recipes:
115
+ - name: "Stereo Ping-Pong"
116
+ description: "Classic bouncing delay between left and right"
117
+ genre: all
118
+ params:
119
+ "Sync Left": "1/8"
120
+ "Sync Right": "1/8"
121
+ Feedback: 35.0
122
+ "Ping Pong": 1
123
+ "Dry/Wet": 25.0
124
+
125
+ - name: "Slapback"
126
+ description: "Short single repeat for rockabilly or vocal doubling effect"
127
+ genre: rock
128
+ params:
129
+ "Time Left": 80.0
130
+ "Time Right": 80.0
131
+ Feedback: 0.0
132
+ Sync: 0
133
+ "Dry/Wet": 20.0
134
+
135
+ - name: "Dub Delay"
136
+ description: "Warm, filtered echoes with high feedback for dub music"
137
+ genre: dub
138
+ params:
139
+ "Sync Left": "3/16"
140
+ "Sync Right": "1/4"
141
+ Feedback: 55.0
142
+ Filter: 1
143
+ "Filter Freq": 3000.0
144
+ "Dry/Wet": 30.0
145
+
146
+ gotchas:
147
+ - "Feedback above 90% can cause runaway self-oscillation — be ready to reduce it quickly"
148
+ - "On return tracks, set Dry/Wet to 100% — the send level controls the blend"
149
+ - "Sync mode overrides ms values — make sure the right mode is active"
150
+ - "Ping-pong with different L/R times creates polyrhythmic echo patterns"
151
+ - "Dotted eighth (3/16) is the classic U2/Edge guitar delay feel"
@@ -0,0 +1,142 @@
1
+ id: drum_buss
2
+ name: Drum Buss
3
+ sonic_description: >
4
+ All-in-one drum processing combining drive, crunch distortion, a transient shaper, and
5
+ a tunable low-end resonance enhancer (Boom). Designed specifically for drum bus treatment,
6
+ it adds punch, grit, and low-end weight in one device with minimal fuss.
7
+ effect_type: dynamics
8
+ character_tags: [punchy, warm, gritty, fat, aggressive]
9
+ use_cases: [drum_bus, drum_processing, lo_fi_drums, boom_enhancement, transient_shaping]
10
+ genre_affinity:
11
+ primary: [hip_hop, electronic, house, techno]
12
+ secondary: [rock, pop, trap]
13
+ complexity: beginner
14
+ signal_type: audio
15
+ introduced_in: "10.0"
16
+
17
+ key_parameters:
18
+ - name: "Drive"
19
+ description: "Amount of saturation/distortion applied to the drums"
20
+ range: [0.0, 100.0]
21
+ unit: "%"
22
+ type: float
23
+ sweet_spots:
24
+ subtle_warmth: 20.0
25
+ moderate: 40.0
26
+ crunchy: 70.0
27
+ destroyed: 100.0
28
+
29
+ - name: "Crunch"
30
+ description: "Additional distortion stage with more aggressive character"
31
+ range: [0.0, 100.0]
32
+ unit: "%"
33
+ type: float
34
+ sweet_spots:
35
+ off: 0.0
36
+ edge: 30.0
37
+ heavy: 60.0
38
+
39
+ - name: "Boom"
40
+ description: "Low-frequency resonance enhancer — adds sub weight and boom"
41
+ range: [0.0, 100.0]
42
+ unit: "%"
43
+ type: float
44
+ sweet_spots:
45
+ subtle: 20.0
46
+ heavy: 50.0
47
+ massive: 80.0
48
+
49
+ - name: "Boom Freq"
50
+ description: "Frequency of the low-end resonance enhancer"
51
+ range: [20.0, 200.0]
52
+ unit: Hz
53
+ type: float
54
+ sweet_spots:
55
+ sub: 40.0
56
+ kick_body: 60.0
57
+ low_thump: 100.0
58
+
59
+ - name: "Boom Decay"
60
+ description: "How long the low-end resonance rings out"
61
+ range: [0.0, 100.0]
62
+ unit: "%"
63
+ type: float
64
+ sweet_spots:
65
+ tight: 20.0
66
+ moderate: 50.0
67
+ long: 80.0
68
+
69
+ - name: "Transients"
70
+ description: "Transient shaper — positive emphasizes attack, negative softens"
71
+ range: [-100.0, 100.0]
72
+ unit: "%"
73
+ type: float
74
+ sweet_spots:
75
+ soften: -30.0
76
+ neutral: 0.0
77
+ punchy: 40.0
78
+ aggressive: 80.0
79
+
80
+ - name: "Trim"
81
+ description: "Output level control"
82
+ range: [-inf, 6.0]
83
+ unit: dB
84
+ type: float
85
+ sweet_spots:
86
+ compensate: 0.0
87
+
88
+ - name: "Dry/Wet"
89
+ description: "Mix between dry and processed signal"
90
+ range: [0.0, 100.0]
91
+ unit: "%"
92
+ type: float
93
+ sweet_spots:
94
+ full: 100.0
95
+ blend: 60.0
96
+
97
+ pairs_well_with:
98
+ - device: "Glue Compressor"
99
+ reason: "Glue before Drum Buss for cohesion, or after for controlled saturation"
100
+ - device: "EQ Eight"
101
+ reason: "Sculpt the frequency balance after Drum Buss processing"
102
+ - device: "Gate"
103
+ reason: "Tighten drums before adding Drum Buss character"
104
+
105
+ starter_recipes:
106
+ - name: "Punchy Drums"
107
+ description: "Tight, punchy drum bus with added attack and subtle warmth"
108
+ genre: all
109
+ params:
110
+ Drive: 25.0
111
+ Crunch: 10.0
112
+ Boom: 30.0
113
+ "Boom Freq": 60.0
114
+ Transients: 40.0
115
+
116
+ - name: "Boom-Heavy Hip-Hop"
117
+ description: "Massive low-end weight with sub resonance for hip-hop/trap"
118
+ genre: hip_hop
119
+ params:
120
+ Drive: 20.0
121
+ Crunch: 0.0
122
+ Boom: 65.0
123
+ "Boom Freq": 45.0
124
+ "Boom Decay": 60.0
125
+ Transients: 20.0
126
+
127
+ - name: "Crispy Electronic"
128
+ description: "Aggressive, crunchy electronic drums with distortion edge"
129
+ genre: techno
130
+ params:
131
+ Drive: 60.0
132
+ Crunch: 50.0
133
+ Boom: 15.0
134
+ "Boom Freq": 80.0
135
+ Transients: 60.0
136
+
137
+ gotchas:
138
+ - "Boom can add a lot of sub energy — check on full-range monitors or with a spectrum analyzer"
139
+ - "Boom Freq should be tuned to the kick fundamental to avoid conflicting resonances"
140
+ - "Drive and Crunch together can get very loud — watch Trim level"
141
+ - "Transients at extreme positive values can clip downstream — leave headroom"
142
+ - "Best on a drum group/bus rather than individual drum tracks"
@@ -0,0 +1,147 @@
1
+ id: dynamic_tube
2
+ name: Dynamic Tube
3
+ sonic_description: >
4
+ Tube amplifier saturation with an envelope follower that dynamically controls the
5
+ distortion intensity based on input level. Responds to playing dynamics like a real
6
+ tube amp — plays louder to drive harder, softer to stay clean. The Bias parameter
7
+ shifts the operating point of the virtual tube for different harmonic flavors.
8
+ effect_type: distortion
9
+ character_tags: [warm, dynamic, tube, responsive, musical]
10
+ use_cases: [tube_warmth, dynamic_crunch, tape_like_saturation, bass_drive, amp_feel]
11
+ genre_affinity:
12
+ primary: [rock, blues, jazz]
13
+ secondary: [pop, indie, electronic, lo_fi]
14
+ complexity: intermediate
15
+ signal_type: audio
16
+ introduced_in: "5.0"
17
+
18
+ key_parameters:
19
+ - name: "Drive"
20
+ description: "Amount of tube saturation — how hard the virtual tube is pushed"
21
+ range: [0.0, 100.0]
22
+ unit: "%"
23
+ type: float
24
+ sweet_spots:
25
+ subtle: 15.0
26
+ warm: 35.0
27
+ driven: 60.0
28
+ hot: 85.0
29
+
30
+ - name: "Bias"
31
+ description: "Operating point of the tube — changes harmonic content and clipping character"
32
+ range: [-1.0, 1.0]
33
+ type: float
34
+ sweet_spots:
35
+ cold: -0.5
36
+ neutral: 0.0
37
+ warm: 0.3
38
+ hot: 0.7
39
+
40
+ - name: "Tone"
41
+ description: "Brightness of the tube distortion"
42
+ range: [0.0, 100.0]
43
+ unit: "%"
44
+ type: float
45
+ sweet_spots:
46
+ dark: 20.0
47
+ warm: 40.0
48
+ bright: 70.0
49
+
50
+ - name: "Envelope"
51
+ description: "How much the input level dynamically affects the drive amount"
52
+ range: [0.0, 100.0]
53
+ unit: "%"
54
+ type: float
55
+ sweet_spots:
56
+ static: 0.0
57
+ responsive: 30.0
58
+ dynamic: 60.0
59
+ highly_dynamic: 90.0
60
+
61
+ - name: "Attack"
62
+ description: "Envelope follower attack — how fast the dynamic drive responds"
63
+ range: [0.1, 100.0]
64
+ unit: ms
65
+ type: float
66
+ sweet_spots:
67
+ fast: 2.0
68
+ medium: 15.0
69
+ slow: 50.0
70
+
71
+ - name: "Release"
72
+ description: "Envelope follower release — how fast the dynamic drive releases"
73
+ range: [1.0, 1000.0]
74
+ unit: ms
75
+ type: float
76
+ sweet_spots:
77
+ fast: 20.0
78
+ medium: 100.0
79
+ slow: 500.0
80
+
81
+ - name: "Output"
82
+ description: "Output level compensation"
83
+ range: [-inf, 0.0]
84
+ unit: dB
85
+ type: float
86
+ sweet_spots:
87
+ compensate: -4.0
88
+
89
+ - name: "Dry/Wet"
90
+ description: "Mix between clean and tube-saturated signal"
91
+ range: [0.0, 100.0]
92
+ unit: "%"
93
+ type: float
94
+ sweet_spots:
95
+ full: 100.0
96
+ parallel: 50.0
97
+ subtle: 30.0
98
+
99
+ pairs_well_with:
100
+ - device: "EQ Eight"
101
+ reason: "Shape tone before tube saturation for controlled harmonic content"
102
+ - device: "Compressor"
103
+ reason: "Level the dynamics before for more consistent saturation"
104
+ - device: "Reverb"
105
+ reason: "Room reverb after tube drive for amp-in-room feel"
106
+ - device: "Cabinet"
107
+ reason: "Speaker cabinet emulation after tube for guitar amp simulation"
108
+
109
+ starter_recipes:
110
+ - name: "Tube Warmth"
111
+ description: "Subtle tube coloring for warmth on any source"
112
+ genre: all
113
+ params:
114
+ Drive: 25.0
115
+ Bias: 0.2
116
+ Tone: 45.0
117
+ Envelope: 20.0
118
+ "Dry/Wet": 100.0
119
+
120
+ - name: "Dynamic Crunch"
121
+ description: "Responsive drive that reacts to playing intensity"
122
+ genre: rock
123
+ params:
124
+ Drive: 50.0
125
+ Bias: 0.0
126
+ Tone: 55.0
127
+ Envelope: 60.0
128
+ Attack: 5.0
129
+ Release: 80.0
130
+ "Dry/Wet": 100.0
131
+
132
+ - name: "Tape-Like Saturation"
133
+ description: "Warm, compressed saturation that mimics analog tape"
134
+ genre: lo_fi
135
+ params:
136
+ Drive: 40.0
137
+ Bias: 0.4
138
+ Tone: 35.0
139
+ Envelope: 10.0
140
+ "Dry/Wet": 70.0
141
+
142
+ gotchas:
143
+ - "Bias parameter is subtle but important — positive values add even harmonics (warmer), negative adds odd harmonics (edgier)"
144
+ - "Envelope at 0% makes the saturation static — increase for dynamic, responsive drive"
145
+ - "Different from Saturator in that it explicitly models tube nonlinearity, not generic waveshaping"
146
+ - "Hot Bias values can cause DC offset — use sparingly or compensate with a high-pass filter"
147
+ - "Works well as a gentle always-on warming effect at low Drive + moderate Bias"