@hraness/dawg 0.6.0 → 0.6.1

package/src/commands/expression.ts

@@ -8,6 +8,7 @@
  *   glide <ms>|off <target>                  portamento into each note
  *   glide <ms>|0|off [legato|mono|poly]      the track's glide (`glide mono`)
  *   pedal <beat>-<beat>…|bars [<bar>-<bar>]|down|half|up <beat>|off
+ *   pedal soft|sost <same forms>             una corda and sostenuto (0.6.1)
  *   velcurve linear|soft|hard|fixed [<v>]
  *   humanize <ms> [<vel%> [<len%>]] [seed <n>]|on|off|reseed|seed <n>
  *   humanize <ms> [<vel%> [<len%>]]|exact|off <target>   per-note amounts
@@ -32,6 +33,7 @@ import {
   normalizeBend,
   normalizeHumanize,
   normalizePedal,
+  SOSTENUTO_STATES,
   normalizeTrackGlide,
   normalizeVelocityCurve,
   normalizeVibrato,
@@ -53,6 +55,7 @@ import {
   type Note,
   type Track,
 } from "../../core/score.ts";
+import { softPedalNote } from "../../core/keys.ts";
 import { barStartTick, loopTicksOf } from "../../core/tempo.ts";
 
 export type NoteTarget =
@@ -73,11 +76,15 @@ export type ExpressionCommand =
   | { type: "vibrato"; vibrato: NoteVibrato | null; target: NoteTarget }
   | { type: "note-glide"; glide: number | null; target: NoteTarget }
   | { type: "track-glide"; time?: number | null; mode?: GlideMode }
-  | { type: "pedal-spans"; spans: readonly { from: number; to: number }[] }
-  | { type: "pedal-bars"; from?: number; to?: number }
-  | { type: "pedal-list" }
-  | { type: "pedal-event"; state: PedalState; beat: number }
-  | { type: "pedal-off" }
+  | {
+      type: "pedal-spans";
+      spans: readonly { from: number; to: number }[];
+      lane?: PedalLane;
+    }
+  | { type: "pedal-bars"; from?: number; to?: number; lane?: PedalLane }
+  | { type: "pedal-list"; lane?: PedalLane }
+  | { type: "pedal-event"; state: PedalState; beat: number; lane?: PedalLane }
+  | { type: "pedal-off"; lane?: PedalLane }
   | { type: "velcurve"; curve: VelocityCurveName; fixed?: number }
   | {
       type: "humanize";
@@ -299,7 +306,31 @@ function nearWord(text: string, word: string): boolean {
   return previous[word.length]! <= 2;
 }
 
+/**
+ * Which pedal a `pedal` command edits (0.6.1): absent is the sustain
+ * pedal, `soft` the una corda (Track.softPedal), `sost` the sostenuto.
+ */
+export type PedalLane = "soft" | "sost";
+
+const PEDAL_LANES: Readonly<Record<string, PedalLane>> = {
+  soft: "soft",
+  unacorda: "soft",
+  sost: "sost",
+  sostenuto: "sost",
+};
+
 function parsePedal(words: string[]): ExpressionCommand | undefined {
+  const lane = words[0] ? PEDAL_LANES[words[0]] : undefined;
+  if (lane) {
+    const command = parsePedalLane(words.slice(1));
+    return command && command.type.startsWith("pedal-")
+      ? ({ ...command, lane } as ExpressionCommand)
+      : undefined;
+  }
+  return parsePedalLane(words);
+}
+
+function parsePedalLane(words: string[]): ExpressionCommand | undefined {
   const [first, ...rest] = words;
   if (!first) return { type: "pedal-list" };
   if (OFF.test(first) && rest.length === 0) return { type: "pedal-off" };
@@ -564,6 +595,16 @@ export function describePerformance(score: TrackScore, track: Track): string {
   const parts = [
     `glide ${track.glide ? `${ms(track.glide.time)} ${track.glide.mode}` : "off"}`,
     `pedal ${track.pedal ? `${track.pedal.length} event${track.pedal.length === 1 ? "" : "s"}` : "off"}`,
+    ...(track.softPedal
+      ? [
+          `soft ${track.softPedal.length} event${track.softPedal.length === 1 ? "" : "s"}`,
+        ]
+      : []),
+    ...(track.sostenuto
+      ? [
+          `sost ${track.sostenuto.length} event${track.sostenuto.length === 1 ? "" : "s"}`,
+        ]
+      : []),
     `velcurve ${track.velocityCurve ? `${track.velocityCurve.curve}${track.velocityCurve.fixed !== undefined ? ` ${track.velocityCurve.fixed}` : ""}` : "linear"}`,
     `humanize ${describeHumanize(track.humanize)}`,
   ];
@@ -680,10 +721,24 @@ function mergePedal(
   current: readonly PedalEvent[] | undefined,
   added: readonly PedalEvent[],
   maxTick: number,
+  label?: string,
+  states?: readonly PedalState[],
 ): readonly PedalEvent[] | undefined {
   const byTick = new Map((current ?? []).map((event) => [event.tick, event]));
   for (const event of added) byTick.set(event.tick, event);
-  return normalizePedal([...byTick.values()], maxTick);
+  return normalizePedal([...byTick.values()], maxTick, label, states);
+}
+
+/** The Track field, message label and allowed states of a pedal lane. */
+function pedalLaneOf(lane: PedalLane | undefined): {
+  field: "pedal" | "softPedal" | "sostenuto";
+  label: string;
+  states?: readonly PedalState[];
+} {
+  if (lane === "soft") return { field: "softPedal", label: "soft pedal" };
+  if (lane === "sost")
+    return { field: "sostenuto", label: "sostenuto", states: SOSTENUTO_STATES };
+  return { field: "pedal", label: "pedal" };
 }
 
 /** Apply `command` to the focused track `trackId`. */
@@ -771,11 +826,12 @@ export function applyExpressionCommand(
       );
     }
     case "pedal-list": {
-      const events = track.pedal ?? [];
+      const { field, label } = pedalLaneOf(command.lane);
+      const events = track[field] ?? [];
       if (events.length === 0)
         return {
           ok: true,
-          message: `pedal · none on ${trackId} · pedal bars to add`,
+          message: `${label} · none on ${trackId} · ${command.lane ? `pedal ${command.lane} 0-4` : "pedal bars"} to add`,
         };
       const shown = events
         .slice(0, 12)
@@ -784,24 +840,45 @@ export function applyExpressionCommand(
             `${Math.round((event.tick / score.ticksPerBeat) * 1000) / 1000} ${event.state}`,
         );
       if (events.length > 12) shown.push(`+${events.length - 12} more`);
-      return { ok: true, message: `pedal · ${shown.join(" · ")} · ${trackId}` };
+      return {
+        ok: true,
+        message: `${label} · ${shown.join(" · ")} · ${trackId}`,
+      };
+    }
+    case "pedal-off": {
+      const { field, label } = pedalLaneOf(command.lane);
+      return track[field]
+        ? trackResult(
+            score,
+            track,
+            { [field]: null },
+            `${label} · off · ${trackId}`,
+          )
+        : { ok: true, message: `${label} · already off · ${trackId}` };
     }
-    case "pedal-off":
-      return track.pedal
-        ? trackResult(score, track, { pedal: null }, `pedal · off · ${trackId}`)
-        : { ok: true, message: `pedal · already off · ${trackId}` };
     case "pedal-spans":
     case "pedal-bars":
     case "pedal-event": {
+      const { field, label, states } = pedalLaneOf(command.lane);
       let added: PedalEvent[];
       if (command.type === "pedal-bars") {
         const from = command.from ?? 1;
         if (from > score.bars)
           return {
             ok: false,
-            message: `pedal · the loop has ${score.bars} bar${score.bars === 1 ? "" : "s"}`,
+            message: `${label} · the loop has ${score.bars} bar${score.bars === 1 ? "" : "s"}`,
           };
-        added = barPedal(score, from, command.to ?? score.bars);
+        const to = Math.min(command.to ?? score.bars, score.bars);
+        // Soft and sostenuto hold through the bars (no re-pedalling).
+        added = command.lane
+          ? [
+              { tick: barStartTick(score, from - 1), state: "down" },
+              {
+                tick: Math.min(barStartTick(score, to), maxTick),
+                state: "up",
+              },
+            ]
+          : barPedal(score, from, to);
       } else if (command.type === "pedal-event") {
         added = [
           { tick: Math.round(command.beat * tpb), state: command.state },
@@ -815,7 +892,7 @@ export function applyExpressionCommand(
       if (added.some((event) => event.tick > maxTick))
         return {
           ok: false,
-          message: `pedal · beats run 0..${maxTick / tpb} in this loop`,
+          message: `${label} · beats run 0..${maxTick / tpb} in this loop`,
         };
       let pedal: readonly PedalEvent[] | undefined;
       try {
@@ -825,11 +902,11 @@ export function applyExpressionCommand(
           command.type === "pedal-bars" &&
           command.from === undefined &&
           command.to === undefined
-            ? normalizePedal(added, maxTick)
-            : mergePedal(track.pedal, added, maxTick);
+            ? normalizePedal(added, maxTick, field, states)
+            : mergePedal(track[field], added, maxTick, field, states);
       } catch (error) {
         if (error instanceof ExpressionValidationError)
-          return { ok: false, message: `pedal · ${error.message}` };
+          return { ok: false, message: `${label} · ${error.message}` };
         throw error;
       }
       const downs = (pedal ?? []).filter((event) => event.state === "down");
@@ -840,11 +917,15 @@ export function applyExpressionCommand(
           : []),
         ...(halves.length > 0 ? [`${halves.length} half`] : []),
       ].join(", ");
+      // Una corda is stored anyway (an instrument change may follow), but
+      // say when nothing will sound different.
+      const silent =
+        field === "softPedal" && pedal ? softPedalNote(track) : undefined;
       return trackResult(
         score,
         track,
-        { pedal: pedal ?? null },
-        `pedal · ${pedal?.length ?? 0} event${pedal?.length === 1 ? "" : "s"} (${held}) · ${trackId}`,
+        { [field]: pedal ?? null },
+        `${label} · ${pedal?.length ?? 0} event${pedal?.length === 1 ? "" : "s"} (${held}) · ${trackId}${silent ? ` · no effect: ${silent}` : ""}`,
       );
     }
     case "velcurve": {
@@ -933,7 +1014,7 @@ export const EXPRESSION_USAGE = Object.freeze({
   glide:
     "glide <ms>|<s>s|off [legato|mono|poly] (track) · glide <ms>|off <target> (notes) · glide 60 mono · SDK glide: 0.06 (s)",
   pedal:
-    "pedal <beat>-<beat>…|bars [<bar>-<bar>]|down|half|up <beat>|off · pedal 0-3.5 4-7.5 · pedal bars",
+    "pedal [soft|sost] <beat>-<beat>…|bars [<bar>-<bar>]|down|half|up <beat>|off · pedal 0-3.5 4-7.5 · pedal bars · pedal soft 0-8 (una corda) · pedal sost 0-4 (holds keys down at 0)",
   velcurve:
     "velcurve linear|soft|hard|fixed [<v 0..1>] · velcurve soft · velcurve fixed 0.8",
   humanize:

package/src/commands/fx.ts

@@ -4,11 +4,12 @@
  *   fx                                   list the focused track's effects
  *   fx <effect> on|off|reset             enable with defaults, remove, reset
  *   fx <effect> preset <name>            load a named preset (FX_PRESETS)
+ *   fx <effect>                          turn it on (same as `on`)
  *   fx <effect> <param> <value>          set one parameter (enables it)
  *   fx <effect> <number>                 set its first parameter (`fx orbit 2`)
  *   fx <effect> <param> <value> <param> <value>…   several at once
  *   fx reverb ir <impulse>|off           convolution reverb (Strudel `ir`):
- *                                        room|hall|plate, a pack sound or a
+ *                                        room|hall|plate|reverse|gate|spring, a pack sound or a
  *                                        project file; `fx ir hall` too
  *
  * Effects are every `FX_CHAIN` stage except pan (see core/fx.ts), plus
@@ -147,6 +148,8 @@ export function parseFxCommand(prompt: string): FxCommand | undefined {
   if (effect === "reverb" && irWord(words[2]) && words.length === 4)
     return irCommand(words[3]!);
   const rest = words.slice(2).map((word) => word.toLowerCase());
+  // `fx wobble`, `fx double`: a bare effect name turns it on.
+  if (rest.length === 0) return { type: "fx-on", effect };
   if (rest.length === 1 && (rest[0] === "on" || rest[0] === "off"))
     return { type: rest[0] === "on" ? "fx-on" : "fx-off", effect };
   if (rest.length === 1 && rest[0] === "reset")

package/src/commands/granular.ts

@@ -160,7 +160,9 @@ export function parseGranularCommand(
     const name = rest[index]!;
     const spec = GRANULAR_PARAMS[name];
     if (!spec) return undefined;
-    const word = rest[index + 1]!;
+    // Dotted note values as the rest of dawg writes them: `1/8.` is `1/8d`.
+    const word =
+      name === "sync" ? rest[index + 1]!.replace(/\.$/, "d") : rest[index + 1]!;
     if ((word === "off" || word === "unset") && spec.kind !== "boolean") {
       values[name] = null;
       continue;
@@ -170,7 +172,10 @@ export function parseGranularCommand(
         ? noteNumber(word)
         : parseParamValue(spec, word);
     if (value === undefined) return undefined;
-    values[name] = value;
+    // 0.6.1 switches: off removes the field, so on-then-off leaves the
+    // score (and its sha256) as it was.
+    values[name] =
+      value === false && (name === "mono" || name === "pedal") ? null : value;
   }
   return { type: "grain-set", values };
 }

package/src/commands/help.ts

@@ -4,6 +4,7 @@
  * app commands take a slash (bare aliases keep working but are listed once,
  * in their canonical form).
  */
+import { GUITAR_TUNING_NAMES } from "../../core/chords.ts";
 import { EXPRESSION_USAGE } from "./expression.ts";
 
 export type HelpGroup = "music" | "session" | "window" | "keys";
@@ -72,10 +73,30 @@ export const HELP_SECTIONS: readonly HelpSection[] = [
         summary:
           "plucked strings · string sitar · string buzz 0.8 · string ring 6",
       },
+      {
+        command: "bowed [<preset>] | <param> <value> | presets",
+        summary:
+          "bowed strings · bowed violin · bowed cellos · bowed pressure 0.7 · bowed sord 1",
+      },
       {
         command: "rig <preset> | reset",
         summary:
-          "guitar rig · rig crunch · rig metal · rig funk · rig lists them",
+          "guitar rig · rig crunch · rig metal · rig shoegaze · rig lists them",
+      },
+      {
+        command:
+          "guitar tune <name|notes> | capo | hand | ring | position | reset",
+        summary: "guitar fretting · guitar tune dadgad · guitar capo 2",
+      },
+      {
+        command: "strum [chords] [pattern] [strokes D-DU-UDU] [speed 22ms]",
+        summary:
+          "strummed guitar chords · strum G D Em C folk · strum I V vi IV · strum alone strums the track's chords",
+      },
+      {
+        command: "fx wobble|bloom|swell|double [param value]",
+        summary:
+          "shoegaze · fx wobble depth 30 · fx double · fx reverb ir builtin:reverse",
       },
       {
         command: "track jangle|punk|funk|ragged|gtr-lead|gtr-metal|bachata",
@@ -94,12 +115,33 @@ export const HELP_SECTIONS: readonly HelpSection[] = [
         command: "keys <param> <value> | preset <name> | reset",
         summary: "piano params · keys hardness 0.3 decay 1.5 · keys lists them",
       },
+      {
+        command: "epiano|wurli|clav [preset <name>] | <param> <value>",
+        summary:
+          "electric keys · suitcase dyno funkclav · epiano vibe 0.6 · clav pickup bridge",
+      },
+      {
+        command:
+          "tonewheel [<drawbars>] | combo [<registers>] [<voice>] | pipe [<stops>] [<row> <value> …]",
+        summary:
+          "organs · tonewheel 888800008 perc 3rd · gospel · combo 08880 flute · pipe plenum · keys perc 3rd",
+      },
+      {
+        command: "rotary slow|fast|stop [at <beat>]",
+        summary:
+          "organ rotary speaker speed · rotary fast at 16 writes the keys-rotary lane",
+      },
       {
         command:
           "modal <preset> | <param> <value> | mallet <name> | reset | off",
         summary:
           "mallets and bells · modal vibes · modal hardness 0.8 · modal presets",
       },
+      {
+        command: "wind <preset> | <param> <value> | mute <name> | reset | off",
+        summary:
+          "winds and brass · wind flute · wind sax · wind players 4 · wind presets",
+      },
       {
         command: "art <articulation>|off [target]",
         summary:
@@ -122,6 +164,11 @@ export const HELP_SECTIONS: readonly HelpSection[] = [
         command: "pedal <beat>-<beat>... | bars | down|half|up <beat> | off",
         summary: "sustain pedal · pedal 0-3.5 4-7.5 · pedal bars",
       },
+      {
+        command: "pedal soft|sost <beat>-<beat>... | bars | off",
+        summary:
+          "piano una corda and sostenuto · pedal soft 0-8 · pedal sost 0-4",
+      },
       {
         command: "velcurve linear|soft|hard|fixed [<v>]",
         summary: "how velocity maps to level · velcurve fixed 0.6 (0..1)",
@@ -242,6 +289,20 @@ export const HELP_SECTIONS: readonly HelpSection[] = [
         summary: "repeats pace accent prob swing …",
       },
       { command: "grid <voice> <x.X.>", summary: "explicit steps · X accent" },
+      {
+        command: "shift <semitones> [formant keep|follow|<n>] [<voice>]",
+        summary:
+          "a sample's pitch without changing its length · shift 0 clears",
+      },
+      {
+        command: "fade [in|out] <seconds> [<voice>]",
+        summary: "a sample's fade in and out (Strudel fadeInTime/fadeTime)",
+      },
+      {
+        command:
+          "resample <track>|orbit <n>|master [section <name>|bars a-b] [grain]",
+        summary: "render to a pinned WAV on a new sampler (or granular) track",
+      },
       { command: "undo", summary: "step back · Ctrl-Z" },
       { command: "redo", summary: "step forward · Ctrl-Y" },
     ],
@@ -603,7 +664,7 @@ export const USAGE: Readonly<Record<string, string>> = {
   click: "/click on|off|<volume> · /click 50%",
   "count-in": "/count-in 0|1|2",
   chords:
-    "/chords auto|manual|off · voicing <n> · spread · bass · perform · rate · octaves · sevenths · preset · style",
+    "/chords auto|manual|off · voicing <n> · spread · bass · perform · rate · octaves · sevenths · preset · style · strokes · speed",
   key: "key <tonic> <mode> | none · key A minor",
   scale: "scale [<tonic>] <name> | list · scale D hijaz",
   tuning:
@@ -635,14 +696,14 @@ export const USAGE: Readonly<Record<string, string>> = {
   bars: "bars takes 1…256 · bars 8",
   extend: "extend <count> bars · extend 4 bars",
   instrument:
-    "instrument <name> · sine piano pluck bass saw square triangle wavetable kit · pianos: grand upright felt honkytonk prepared · synth: sawtooth supersaw pulse white pink z_square…",
+    "instrument <name> · sine piano pluck bass saw square triangle wavetable kit · pianos: grand upright felt honkytonk prepared · electric: epiano suitcase dyno wurli clav funkclav · synth: sawtooth supersaw pulse white pink z_square…",
   volume: "volume takes 0…1 · volume 0.8",
   vol: "volume takes 0…1 · volume 0.8",
   pan: "pan takes -1…1 · pan -0.5",
   wt: "wt <table> | wt <0..1> | wt list · wt basic · wt wt_digital:2",
   wavetable: "wt <table> | wt <0..1> | wt list · wt basic · wt wt_digital:2",
   grain:
-    "grain <preset> | <param> <value> | on [voice V] | src synth:<name>|voice V | reset | off | presets · grain cloud · grain pitch 12",
+    "grain <preset> | <param> <value> | on [voice V] | src synth:<name>|voice V | reset | off | presets · sync 1/64…1/1 (t triplet, d or . dotted) · grain cloud · grain pitch 12 · grain sync 1/8.",
   granular:
     "grain <preset> | <param> <value> | on [voice V] | src synth:<name>|voice V | reset | off | presets · grain cloud",
   warpmode: "warpmode none|asym|bendp|bendm|bendmp|sync|quant",
@@ -665,11 +726,17 @@ export const USAGE: Readonly<Record<string, string>> = {
   export: "/export <file> · /export loop.track.json",
   import: "/import <file> · /import loop.track.json",
   sample:
-    "/sample <path> [as <voice>] · /sample set <voice> <control> <value>… · /sample set brk fit on clip 1",
+    "/sample <path> [as <voice>] · /sample set <voice> <control> <value>… · /sample set brk fit on clip 1 · /sample set soft vel 0-63 rr a",
   samples: "/sample · lists the focused track's voices",
   fitmode:
     "/fitmode [repitch|beats|tones|auto|off] [<voice>] · /fitmode beats · /fitmode auto brk",
   len: "/len <beats> [<voice>] · /len 16 · /len off",
+  shift:
+    "shift <semitones> [formant keep|follow|<n>] [<voice>] · shift 7 formant keep · shift 0",
+  fade: "fade [in|out] <seconds> [<voice>] · fade out 0.5 · fade in 0.05 · fade off",
+  resample:
+    "resample <track>|orbit <n>|master [section <name>|bars a-b] [post] [grain] [as <id>] · resample lead · resample drums bars 1-2 grain · resample master section chorus",
+  bounce: "resample <track>|orbit <n>|master [section <name>|bars a-b] [grain]",
   view: "/view focus | all",
   transcript: "/transcript",
   log: "/transcript",
@@ -685,16 +752,32 @@ export const USAGE: Readonly<Record<string, string>> = {
   synth: "synth <param> <value> | preset <name> · synth lpf 1200",
   string:
     "string <preset> | preset <name> | <param> <value> | presets | reset | off · string koto",
-  rig: "rig clean|crunch|punk|ragged|lead|metal|fuzz|octave|funk|wah|bachata|spring|bassdrive|reese|jangle|alt | reset",
+  bowed:
+    "bowed [violin|viola|cello|contrabass|fiddle|erhu|kamancheh|violins|violas|cellos|contrabasses|pizz|trem] | <param> <value> | presets · bowed violin · bowed pressure 0.7",
+  rig: "rig clean|crunch|punk|ragged|lead|metal|fuzz|octave|funk|wah|bachata|spring|bassdrive|reese|jangle|alt|shoegaze|glide|dreampop|swell|ebow | reset",
+  guitar: `guitar tune ${GUITAR_TUNING_NAMES.join("|")} | E A D G B E · capo 0..12 · hand 3..6 · ring 0..1 · position · reset`,
+  strum:
+    "strum G D Em C [folk|pop|punk|…] [strokes D-DU-UDU] [speed 22ms] [each 4] [at 0] · strum alone strums the track's chords",
   stomp:
     "stomp fuzz|face|od|rat|octave | gain <0-10> tone <0-1> level <dB> | off",
   head: "head clean|chime|crunch|lead|high|solid|bass | gain bass mid treble presence master <0-10> | gate <dB> | off",
   cab: "cab 1x12|2x12|4x12|1x10|open|8x10|1x15|di | mic <0-1> | off",
-  keys: "keys <param> <value> | preset <name> | reset | presets · keys hardness 0.3 · keys stretch 0",
+  keys: "keys <param> <value> | preset <name> | reset | presets · keys hardness 0.3 · keys stretch 0 · keys sym 0.5 (sympathetic bloom under the sustain pedal)",
   piano:
     "piano [grand|ballad|upright|felt|lofi|honkytonk|prepared] · piano ballad",
+  epiano:
+    "epiano [preset epiano|suitcase|dyno] | bark bell tone vibe vibehz decay release <value> · epiano vibe 0.6 · rhodes",
+  wurli:
+    "wurli [preset wurli] | bark bell tone trem decay release <value> · wurli trem 0.5",
+  clav: "clav [preset clav|funkclav] | pickup neck|bridge|both|out | mute tone decay release <value> · clav pickup bridge",
+  tonewheel:
+    "tonewheel [<9 drawbar digits>] | hammond | b3 | gospel | jazzorgan · tonewheel 888800008",
+  combo: "combo [<5 register digits>] | farfisa | vox · combo 08880",
+  pipe: "pipe [plenum|flutes|cornet|reeds|strings|full | <stop> …] | church · pipe principal8,octave4",
+  rotary: "rotary slow|fast|stop [at <beat>] · rotary fast · rotary fast at 16",
   modal:
-    "modal <preset> | <body> | <param> <value> | mallet <name> | reset | off | presets · modal vibes · modal saron · modal ring 3",
+    "modal <preset> | <body> | <param> <value> | mallet <name> | pair <track> | gamelan | reset | off | presets · modal vibes · modal gangsa · modal ring 3",
+  wind: "wind <preset> | <param> <value> | mute <name> | reset | off | presets · wind flute · wind trumpet mute harmon · wind players 4",
   pack: "/pack list | info <name> | use <pack>/<sound> | add <url>",
   kit: "/kit [name] · /kit syn909",
   euclid: "/euclid [voice] · euclid hat 7 16",