Files
Cagire/docs/getting-started/samples.md
2026-02-16 23:19:06 +01:00

43 lines
1.5 KiB
Markdown

# 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:
```forth
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 |