Purpose

Sampler loads a WAV file or a folder of WAV samples and plays them as a polyphonic, velocity-mapped note instrument. Point it at a single WAV for a simple pitched instrument, or at a folder of note-named and velocity-layered WAV files for a full multisample instrument. Automatic note and velocity parsing from filenames handles most sample library conventions.

TouchDesigner Use

Set Samplepath to a WAV file or a folder containing WAV files. Set Rootnote if the samples are not named with note information. Wire note_voices_f32_v1 from MIDI Note or any note-voice source into the voices input. Choose classic (gate-controlled), one_shot (fire and forget), or loop mode. Wire the stereo audio output to Device Out or a mixer.

Inputs And Outputs

• Input 0: voices — note_voices_f32_v1 (required). Gate, pitch, velocity, and aftertouch per voice.
• Output 0: out — stereo audio (PCM f32).

Main Controls

• Samplepath — Path to a WAV file or folder. Folders are scanned recursively for WAV files (up to 768 samples). Samples are auto-mapped by note and velocity parsed from filenames.
• Mode — Playback mode: classic (plays while gate is held, releases on gate off), one_shot (plays to end regardless of gate), loop (loops between Start and End while gate is held).
• Rootnote — Fallback root note for samples without note information in their filename. Default 60 (C4).
• Gain — Master output level.
• Tone — Brightness filter (LP cutoff).
• Attack / Release — Amplitude envelope attack and release times.
• Declick — Edge de-click fade length in milliseconds at sample start/end boundaries.
• Start / End — Sample region as a fraction of the file length (0-1).
• Startjitter — Random offset added to the start position on each trigger for natural variation.
• Velgain — Velocity gain multiplier.
• Punch — Transient emphasis using a differentiator on note attack.
• Lowcut — High-pass filter cutoff in Hz (0 = off, up to 240 Hz).
• Drive — Saturation amount.
• Width — Stereo pan spread across notes.
• Room — Built-in multi-tap delay room ambience.
• Velocitycurve — Velocity response curve exponent (0.25-4.0). Lower = more compressed, higher = more dynamic.
• Transpose — Semitone transpose (-24 to +24).
• Maxvoices — Maximum simultaneous voices (1-64).
• Monomode — When on, each new note releases all previous voices.
• Reverse — Play samples in reverse.
• Reload — Pulse to force a reload from disk.
• Limiter — Output safety limiter.

Notes

• Sample loading happens on a background thread; the audio thread is never blocked.
• Filename parsing recognizes note names (C4, Fs3, Bb2), MIDI note numbers, and velocity indicators (v1-v16, pp, mf, ff, etc.).
• Auxiliary samples with names starting with “pedal”, “harm”, or “rel” followed by a digit are automatically excluded from the keymap.
• Cubic interpolation is used for pitch-shifted playback.
• Multi-voice polyphony auto-trims gain by the square root of active voices to prevent summing overload.

Parameters

This operator does not expose user parameters in the extracted schema.

Catalog metadata

Roles

• transform
• instrument
• sampler
• generator

Tags

• sample
• multisample
• wav
• velocity
• note_voices
• stereo
• loop
• one_shot

Search groups

• midi
• control
• audio
• music
• instrument
• sampler