# 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 |
