Files
Cagire/docs/getting-started/options.md
Raphaël Forment 2d8abe4af9
Some checks failed
Deploy Website / deploy (push) Failing after 4m50s
Feat: documentation
2026-02-16 23:19:06 +01:00

1.9 KiB
Raw Blame History

Options

The Options page (F3) gathers all configuration settings in one place: display, synchronization and MIDI. Navigate options with Up/Down or Tab, change values with Left/Right. All changes are saved automatically.

Display

Option Values Description
Theme (cycle) Color scheme for the entire interface
Hue rotation 0360° Shift theme colors by a hue angle (±5° per step)
Refresh rate 60 / 30 / 15 fps Lower values reduce CPU usage
Runtime highlight on / off Highlight executed code spans during playback
Show scope on / off Oscilloscope on the engine page
Show spectrum on / off Spectrum analyzer on the engine page
Completion on / off Word completion popup in the editor
Show preview on / off Step script preview on the sequencer grid

Cagire uses Ableton Link to synchronize tempo with other applications on the same network. Three settings control the connection:

  • Enabled — Turn Link on or off. When enabled, Cagire listens for peers and shares its tempo.
  • Start/Stop sync — When on, pressing play or stop in one app affects all peers.
  • Quantum — The beat subdivision used for phase alignment.

Below these settings, a read-only session display shows the current tempo, beat position, and phase. The status line at the top shows the connection state: disabled, listening, or connected with peer count.

MIDI

Four output slots and four input slots let you connect to MIDI devices. Cycle through available devices with Left/Right. Each slot can hold one device, and the same device cannot be assigned to multiple slots.

Onboarding

At the bottom, you can reset the onboarding guides if you dismissed them earlier and want to see them again.

Keybindings

Key Action
Up / Down / Tab Navigate options
Left / Right Change value