Skip to main content
The Sample Library keeps a central, searchable index of every audio file in the folders you’ve added. The index powers two workflows that share the same keyboard-first entry point:
  • Fast name search through the Command Palette — find a sample and load it onto a track without leaving the keyboard.
  • Smart Search (optional) — an on-device audio model sorts your library by how close each sample sounds to the one you’re working with, so you can audition alternatives by vibe, not filename.
The payoff: while playback is running, you can step through samples with the arrow keys and hear each candidate in place on the current track, with zero drop-outs and no change to your clip layout.

​
Indexed folders

Manage the library under Gridshift → Settings → Samples. Each row shows the folder’s sample count and the time of the last scan.

​
Supported formats

​
Content-hash identification

Every file is identified by a content hash, not by its path. That means: A file-system watcher keeps the index live. New files appear shortly after you drop them into an indexed folder, without a manual rescan.
Because identification is content-based, you can reorganize your sample folders freely. Projects that reference a moved sample pick it up automatically the next time Gridshift sees the file.

​
Cross-device sync

With iCloud enabled, the annotations you make on samples sync across your Macs:
  • Ratings, colors, and tags
  • Detected BPM and key
  • Transient markers
Because samples are identified by content, these annotations follow the file rather than its location — rate a sample on one Mac and it’s rated on every other Mac that has the same file indexed, even if you’ve organized your folders differently there. The list of indexed folders is per-Mac, since file paths don’t translate across machines. Add folders once on each Mac you use.

​
Sample search via Command Palette

Open the picker with ⌥S while a sample track is selected. Step through results with ↑ / ↓, commit with Return, or cancel and revert with Escape. The list re-ranks as you type. Ranking combines several signals: Typing stays smooth even on libraries with tens of thousands of samples.

​
Filter tokens

Combine a query with : tokens to narrow the list: Categories are inferred heuristically from filename and parent-folder tokens. A file under .../Kicks/808/deep.wav picks up drums and kick automatically.
Tokens stack. kick :short :mono returns only short, mono kicks.
Smart Search extends filename matching with acoustic similarity. Instead of relying on how files are named, Gridshift compares how they actually sound — using an on-device audio model. Smart Search is opt-in. Toggle it under Settings → Samples → Smart Search:
1

Switch on Smart sample search

2

Gridshift downloads the model on first enable (around 170 MB)

3

A one-time indexing pass runs over your library in the background; Settings shows the progress

All processing runs on-device — no audio leaves your Mac.

​
How you use it

Smart Search activates automatically once enabled. The sample picker picks the right mode based on what you do:
For drum replacement: open the picker on a snare track with nothing typed. Gridshift orders your library so the snares closest in character sit at the top — step through with ↑ / ↓ to audition alternatives quickly.

​
Turn it off

Switching the toggle off returns the picker to pure name-based search. If you re-enable Smart Search later, it picks up where it left off without re-downloading the model or re-indexing your library.

​
Swap samples during playback

The picker is designed for live, performative sample replacement. Clips keep their positions; only the underlying audio changes.

​
Workflow

1

Select a sample track in the sidebar

2

Press ⌥S to open the picker

3

Step through results with ↑ / ↓

Each step:
  • Swaps the sample on the track immediately and audibly during playback.
  • Leaves clip offsets, lengths, and positions untouched.
  • Plays a full-length audition of the highlighted sample — except when playback is already running and the track has audio clips, where the clip-level preview is enough on its own.
4

Press Return to commit the current candidate

5

Press Escape to cancel and restore the original sample

Stepping through candidates is designed to feel instant — you can cycle dozens of samples per second without playback stuttering. Gridshift only creates a fresh waveform when you commit with Return; preview steps reuse the existing track in place.

​
Edge cases

​
Change a sample without preview

When you already know which file you want, two non-performative paths are also available: Both create a fresh sound source immediately, with waveform and transients generated up front — no preview / commit loop.

​
Shortcuts

The keys that drive the sample picker. The Global Shortcuts reference has the complete grid of track and file operations.
Last modified on July 11, 2026