Documentation Index
Fetch the complete documentation index at: https://docs.gridshift.studio/llms.txt
Use this file to discover all available pages before exploring further.
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
| From | Action |
|---|
| Inspector | Click the waveform preview in the Source section |
| Command Palette | Run Edit Sample… (⌥X on a sample track) |
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 two modes:
| Mode | Purpose |
|---|
| Slices | Transient detection, slice decay, slice trigger mode |
| Tempo | Source BPM, stretch mode, target BPM, pitch and formant, beat-grid origin |
| Gesture | Action |
|---|
| Drag empty area | Pan horizontally and zoom (drag down = zoom in) around the click point |
| Scroll wheel | Zoom, anchored at the pointer |
| Trackpad pinch | Zoom, anchored at the pointer |
| Trackpad horizontal swipe | Pan horizontally |
← / → | Step through slices; the view auto-scrolls to keep the selected slice on screen |
⌥← / ⌥→ | Zoom out / in, anchored at the selected slice (Slices mode) or the downbeat (Tempo mode) |
⌥↑ | Reset zoom to 1× |
Slices Mode
Transient Source
A picker selects how transient markers are produced:
| Mode | Behaviour |
|---|
| Auto | An 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. |
| Manual | The 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. |
| Beat | Markers 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)
| Action | Input |
|---|
| Add marker | Double-click on the waveform |
| Remove marker | Double-click on a marker |
| Move marker | Drag a marker — the model updates on release |
| Nudge selected marker by 5 ms | , (left) / . (right) |
Slice Playback Controls
| Control | Description |
|---|
| Decay | Envelope decay applied to every slice |
| Trigger | One-Shot plays the slice in full; Hold plays only while the key is held |
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:
| Control | Description |
|---|
| BPM | The source’s effective BPM, with a stepper for overrides |
| Stretch | Time-stretch mode (Off / Slice / Complex / Repitch) |
| Target BPM | Project-relative target tempo (when a stretch mode is active) |
| Pitch | Pitch slider (Repitch and Complex modes) |
| Formant | Formant slider (Complex mode only) |
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:
| Action | Input |
|---|
| Drag the grid | Click 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 by 5 ms | , (left) / . (right) |
| Reset offset | The Reset button on the offset chip (bottom-right corner of the waveform) |
