Skip to main content
The Sample Editor opens a large interactive waveform on top of the timeline so the audio fills the screen while every editor control sits in a single bar at the bottom. It is the only place where transient markers, slice settings, and the source-level BPM grid are edited.

Opening the Editor

FromAction
InspectorClick the waveform preview in the Source section
Command PaletteRun Edit Sample… (⌥X on a sample track)
The sheet locks input to the timeline behind it. Press Done (or Return) to close. The window can be resized from its minimum (1280 × 540) upward to any size your display allows.

Layout

The waveform fills the body of the sheet. A single bar at the bottom holds the controls for the currently selected mode. Both the waveform and the controls are tinted with the colour of the track that owns the sample. A segment picker on the left of the bar switches between three modes:
ModePurpose
SlicesTransient detection, slice decay, slice trigger mode
TempoSource BPM, stretch mode, target BPM, pitch and formant, beat-grid origin
StemsGenerate per-stem layers from the sample and balance their volumes in place
Press ⌘1 to switch to Slices and ⌘2 to switch to Tempo from the keyboard.

Waveform Interactions

The waveform reacts to the same gestures in both modes — only the click target differs.
GestureAction
Drag empty areaPan horizontally and zoom (drag down = zoom in) around the click point
Scroll wheelZoom, anchored at the pointer
Trackpad pinchZoom, anchored at the pointer
Trackpad horizontal swipePan horizontally
/ Step the selection through slices; the view auto-scrolls to keep the selected slice on screen
⌘← / ⌘→Nudge the selected marker (or the Tempo grid offset) by 1 ms
⌘⌥← / ⌘⌥→Fine-nudge the same target by a single sample
⌥← / ⌥→Zoom out / in, anchored at the selected slice (Slices mode) or the downbeat (Tempo mode)
⌥↑Reset zoom to 1×
The right hand never leaves the arrow cluster: step from marker to marker with the bare arrows, hold to shove the selected marker, add for sample-accurate alignment. Letter keys play the slices of the sample for audition (same layout as Musical Typing for audio slices).

Slices Mode

Transient Source

A picker selects how transient markers are produced:
ModeBehaviour
AutoAn on-device detector places markers automatically. A sensitivity slider in the bar filters the candidate set — turn it up for more markers, down for fewer. Switching back to Auto re-applies the detection.
ManualThe current marker positions are pinned. The bar shows a Clear button that removes every marker on the source. Auto-detection no longer overwrites the markers in this mode.
BeatMarkers are evenly spaced on a beat grid derived from the source BPM. A division picker chooses the spacing (2 Bars, 1 Bar, 1/2, 1/4, 1/8, 1/16).

Editing Markers (Slices Mode)

ActionInput
Add markerDouble-click on the waveform
Remove markerDouble-click on a marker, or press Backspace with the marker selected
Move markerDrag a marker — the model updates on release
Nudge selected marker⌘← / ⌘→ (1 ms), or ⌘⌥← / ⌘⌥→ for a single-sample step
Drop marker at the playheadReturn while a slice is auditioning or Space-preview is running
Toggle full-source previewSpace (starts at the selected slice; press again to stop)
The selected slice is the one whose start marker the -arrow nudge moves. Selection is set with the bare / arrows, by clicking a marker, or by playing a slice with its letter key.

Sample Operations (Slices Mode)

A chip in the top-right corner of the waveform offers two non-destructive operations on the source sample. Both write back into the sample’s parameters — the original audio file is not modified, and pressing the same button again removes the effect.
OperationDescription
NormalizeLifts the sample’s peak to 0 dBFS. Off by default.
Trim SilenceDetects leading and trailing silence and excludes it from playback. Only available when Time Stretch is set to None, since stretched buffers don’t share trim semantics.

Slice Playback Controls

ControlDescription
DecayEnvelope decay applied to every slice
TriggerOne-Shot plays the slice in full; Hold plays only while the key is held
These mirror the same controls on the Inspector.

Tempo Mode

Tempo mode shows a beat grid overlaid on the waveform. The grid is derived from the source’s effective BPM and uses the bar/beat lines to give the user a visual reference for aligning the audio.

Source BPM and Stretch Settings

The toolbar exposes the same source-level fields as the Inspector, packed into a single row:
ControlDescription
BPMThe source’s effective BPM, with a stepper for overrides
StretchTime-stretch mode (Off / Slice / Complex / Repitch)
Target BPMProject-relative target tempo (when a stretch mode is active)
PitchPitch slider (Repitch and Complex modes)
FormantFormant slider (Complex mode only)
See Time Stretching for the full description of each mode.

Aligning the Beat Grid

When the first downbeat of the audio doesn’t sit at the start of the file, the grid can be moved without changing the BPM:
ActionInput
Drag the gridClick any beat line and drag — the offset updates live
Stretch the grid-click a beat line and drag — the downbeat stays anchored, the BPM updates so the grid spacing matches the drag
Nudge offset⌘← / ⌘→ (1 ms), or ⌘⌥← / ⌘⌥→ for a single-sample step
Reset offsetThe Reset button on the offset chip (bottom-right corner of the waveform)
The current offset is shown in seconds in the chip. The offset is persisted on the source and re-applied the next time the editor is opened.

Stems Mode

Stems mode replaces the single waveform with a stack of stem lanes — one row per stem (vocals, drums, bass, other for Song Stems; kick, snare, cymbals, toms for Drum Elements). Each lane has its own volume, mute, and solo controls so you can rebalance the parts inside one sample without splitting the clip across multiple tracks. Three states the user can land in:
StateWhat you see
Model not installedA Download Model call to action that hands off to the model-download sheet
Model installed, no stems yetA Generate Stems call to action — uses the algorithm chosen in the toolbar picker
Stems presentThe lane stack
The toolbar picker on the right of the bar selects the algorithm (Song Stems / Drum Elements). A compact Re-generate action sits beside it. While a bake runs, the body of the editor swaps to a progress view; once the bundle lands on the source, the lanes appear automatically. This is an in-place alternative to splitting a clip into separate stem tracks — both flows use the same models, but stems mode keeps everything on one track and one sample. Use stems mode when you want to mix the layers as a single instrument; use the track-split flow when you want to arrange them independently.

Shortcuts

These keys are specific to the Sample Editor sheet. The slice-audition letter keys follow the Musical Typing layout.
ActionShortcut
Switch to Slices / Tempo mode⌘1 / ⌘2
Step through slices /
Nudge marker or grid offset 1 ms⌘← / ⌘→
Fine-nudge by a single sample⌘⌥← / ⌘⌥→
Zoom out / in⌥← / ⌥→
Reset zoom to 1×⌥↑
Drop marker at playhead (while auditioning)Return
Toggle full-source previewSpace
Remove selected markerBackspace
Close editor (otherwise)Return
Last modified on June 10, 2026