Skip to main content
k2k audio logo k2k audio

Back to Utility
Documentation tree

Trimmer

Trimmer crops a region of the input by start/end markers and optionally shapes its amplitude with a built-in ADSR envelope — handy for previewing slices before…

Parameters

[Parameters not yet documented — likely declared in source outside register_animatable(). Add an override in _overrides/ if needed.]

Additional controls

Start Ms — Trim start position in milliseconds. Defines where the output begins relative to the input. Drag the start marker on the waveform display, or type the value directly. Auto-clamps so it always stays at least 1 ms before end_ms.

End Ms — Trim end position in milliseconds. Defines where the output ends. Drag the end marker on the waveform display, or type the value directly. Auto-initializes to the input’s full duration on first connection. Auto-clamps so it always stays at least 1 ms after start_ms.

Envelope Enabled — When on, applies an ADSR envelope to the trimmed region (shaping its amplitude). When off, the trim is rectangular — abrupt start/end which can click on percussive material. Leave on by default; turn off only when you’re chaining into something that will window the result itself.

Attack Ms — ADSR attack time in milliseconds. How long the envelope takes to ramp from 0 to peak at the start of the trimmed region. Exponential curve. 1–10 ms = sharp attack (preserves transients); 50–200 ms = soft swell.

Decay Ms — ADSR decay time in milliseconds. How long after attack peaks before reaching the sustain_level. Exponential curve. Set short for plucky envelopes, long for slow settling.

Sustain Level — Sustain amplitude, 0.0–1.0. The level the envelope holds at after attack+decay, until release begins. 1.0 = no decay drop (attack rises straight to the held level); 0.0 = full decay to silence (no sustain).

Sustain Hold Ms — How long to hold at sustain_level before release begins, in ms. 0 = release starts immediately after decay (typical AD-only or AR feel). Larger values give classic ADSR with audible sustain.

Release Ms — ADSR release time in milliseconds. How long the envelope takes to fall from sustain_level back to 0 at the end of the trimmed region. Exponential curve. Use to fade out smoothly and avoid clicks on percussive sources.

About Trimmer

Trimmer crops a region of the input by start/end markers and optionally shapes its amplitude with a built-in ADSR envelope — handy for previewing slices before committing to a Slicer, prepping one-shots from a longer recording, or carving custom envelope shapes onto looped material. The waveform display shows the current trim region; drag the markers directly, or type values for sample-accuracy. The ADSR widget below shows the envelope shape over the trimmed duration (so the curve always fits the region, not the original). If the ADSR sum exceeds the trimmed length, all four phases scale down proportionally to fit. Operates in spectral domain (no STFT round trip). Compare with Slicer for marker-based multi-region cutting, and Gain for envelope-via-modulation rather than built-in ADSR.


Generated 2026-05-05 from K2K_Dev@96730bdc by scripts/gen_lexique.py. Edit _intros/ or _overrides/, not this file.