SampleStash Help

Audio file librarian for music producers on macOS. Catalog, preview, tag, and convert your entire sample collection.

Getting Started

Adding Folders

On first launch, SampleStash prompts you to add a folder. You can also use File → Add Folder to Library… (⌘O) at any time.

SampleStash scans recursively — it finds every audio and instrument file in all subfolders. Supported formats:

Audio FilesInstrument Files
WAV, AIFF, MP3, FLAC, M4A, AAC, CAFSF2, DLS, EXS24, SFZ, DecentSampler

Browsing Your Library

Switch between Grid view (waveform thumbnails) and List view (sortable columns) using the ⊞/☰ toggle in the toolbar.

Use the format jump bar on the right edge to filter by format. Click a format to show only those files; click again to clear the filter.

Sidebar

The sidebar organizes your library by:

Preview & Playback

Press Space to play/stop the selected file. SampleStash plays audio files directly and can preview soundbank instrument files.

Tip: Enable View → Auto-Play on Select to hear each file as you arrow through the list.

Searching

The search field (⌘F) searches by filename, path, tags, and format. Press Escape to clear the search and stop playback.

Tagging & Organizing

Tags

Right-click any file(s) → Tag Selection… to add comma-separated tags. Tags appear in the sidebar under TAGS for quick filtering.

Favorites & Ratings

Right-click → Toggle Favorite to mark files. Favorites appear in the SMART → Favorites sidebar section.

Color Labels

Right-click → Color Label to assign a color. Files show a color bar on the left edge of their grid tile.

Smart Playlists

Use File → New Smart Playlist… (⇧⌘N) to create a playlist that automatically includes files matching a rule (e.g., bpm >= 120 AND category == 'loop').

Exporting & Converting

Select one or more files, then use File → Export Selection As… (⇧⌘E) to convert between formats:

Instrument Export

Right-click an instrument file → Export As… to convert between SF2, DLS, SFZ, EXS24, and DecentSampler formats.

Extract Samples

Right-click a soundbank → Extract Samples… to pull all embedded audio samples out as individual WAV files.

Soundbank Editor

Double-click any SF2, DLS, EXS24, or SFZ file to open the built-in soundbank editor. Edit instruments, zones, sample mappings, envelopes, and filters — then save in any format.

BPM Detection

SampleStash automatically detects BPM for rhythmic content during scanning. To re-detect or batch-detect:

Keyboard Shortcuts

Play / StopSpace
Search⌘F
Stop + Clear SearchEscape
Select All⌘A
Export Selection⇧⌘E
Info Panel⌘I
Add Folder⌘O
New Smart Playlist⇧⌘N
Rescan All⇧⌘R
Delete from LibraryDelete
Zoom Grid⌘+scroll
Show Shortcuts⌘/

Drag & Drop

Drag files from SampleStash directly into your DAW (Logic, Ableton, GarageBand, etc.). Files are dragged as standard file references.

Resetting / Starting Fresh

Use File → Clear Library… to remove all cataloged files and start fresh. Your audio files on disk are never touched.

Clear Library only forgets what SampleStash has cataloged — it never deletes, moves, or modifies your audio files.

Full reset (Terminal)

For a complete "fresh install" reset, quit SampleStash and run:

rm -rf ~/Library/Application\ Support/SampleStash
rm -rf ~/Library/Caches/SampleStash
defaults delete com.sonicamigos.samplestash
rm -rf ~/Library/Containers/com.sonicamigos.samplestash
killall cfprefsd

System Requirements