Cagire/docs/getting-started/samples.md

The Sample Browser

Press Tab on the sequencer grid to open the sample browser. It appears as a side panel showing a tree of all your sample directories and files. Press Tab again to close it. Before using the browser, you need to register at least one sample directory on the Engine page (F6). Cagire indexes audio files (wav, mp3, ogg, flac, aac, m4a) from all registered paths.

Browsing

The browser displays folders and files in a tree structure.

• Up / Down — Move through the list
• Right — Expand a folder or play a file
• Left — Collapse a folder
• Enter — Play the selected file
• PageUp / PageDown — Scroll quickly

When you play a sample, it sounds immediately. This makes it easy to audition sounds before writing them into a script.

Search

Press / to activate the search filter. Type to narrow results by name. Press Esc to clear the filter and see everything again.

Using Samples in Scripts

Sample folder names become words you can use in your Forth scripts. If you have a folder called kick, you can write:

kick sound .

See the Samples section in the Audio Engine documentation for details on how sample playback works.

Keybindings

Key	Action
Tab	Open / close browser
Up / Down	Navigate
Right	Expand folder / play file
Left	Collapse folder
Enter	Play file
PageUp / PageDown	Fast scroll
/	Search
Esc	Clear search / close