Files
Cagire/docs/getting-started/banks_patterns.md
Raphaël Forment 35370a6f2c
All checks were successful
Deploy Website / deploy (push) Has been skipped
Feat: better user feedback on patterns page
2026-03-04 23:41:11 +01:00

72 lines
2.6 KiB
Markdown

# Banks & Patterns
Cagire organizes all your patterns and data following a strict hierarchy:
- **Projects** contain **Banks**.
- **Banks** contain **Patterns**.
- **Patterns** contain **Steps**.
If strict organization isn't your style, don't worry, you can ignore banks entirely and just work in a single pattern. You can also escape the strict metric using sub-step timing and randomness.
## Structure
```
Project
└── 32 Banks
└── 32 Patterns (per bank)
└── 1024 Steps (per pattern)
```
A single project gives you 32 banks, each holding 32 patterns. You get 1024 patterns in each project, ~1.048.000 steps. This means that you can create a staggering amount of music. Don't hesitate to create copies, variations, and explore the pattern system thoroughly. The more you add, the more surprising it becomes.
## Patterns
Each pattern is an independent sequence of steps with its own properties:
| Property | Description | Default |
|----------|-------------|---------|
| Length | Steps before the pattern loops (`1`-`1024`) | `16` |
| Speed | Playback rate (`1/8x` to `8x`) | `1x` |
| Quantization | When the pattern launches | `Bar` |
| Sync Mode | Reset or Phase-Lock on re-trigger | `Reset` |
| Follow Up | What happens when the pattern finishes an iteration | `Loop` |
Press `e` in the patterns view to edit these settings. After editing properties, you will have to hit the `c` key to _launch_ these changes. More about that later!
### Follow Up
The follow-up action determines what happens when a pattern reaches the end of its steps:
- **Loop** — the pattern repeats indefinitely. This is the default behavior.
- **Stop** — the pattern plays once and stops.
- **Chain** — the pattern plays once, then starts another pattern. Use `Left`/`Right` to set the target bank and pattern in the edit view.
## Patterns View
Access the patterns view with `F2` (or `Ctrl+Up` from the sequencer). The view shows all banks and patterns in a grid. Indicators show pattern state:
- `>` Currently playing
- `+` Armed to play
- `-` Armed to stop
- `M` Muted
- `S` Soloed
It is quite essential for you to understand the arm / launch system in order to use patterns. Please read the next section carefully!
### Keybindings
| Key | Action |
|-----|--------|
| `Arrows` | Navigate banks and patterns |
| `Enter` | Select and return to sequencer |
| `p` | Arm pattern to play/stop |
| `c` | Launch armed changes |
| `m` / `x` | Arm mute / solo toggle |
| `e` | Edit pattern properties |
| `r` | Rename bank or pattern |
| `Ctrl+c` / `Ctrl+v` | Copy / Paste |
| `Delete` | Reset to empty pattern |
| `Esc` | Cancel armed changes |