Files
Cagire/docs/getting-started/navigation.md

1.9 KiB

Navigation

Press ? on any view to see its keybindings. The most important shortcuts are always displayed in the footer bar. Press Esc to close the keybindings panel. These shortcuts work on every view:

Key Action
Space Toggle play / stop
q Quit
s Save project
l Load project
? Show keybindings for view

Views

Cagire's interface is organized as a 3x2 grid of six views. Jump to any view with its F-key or Ctrl+Arrow keys:

F1 Dict       F2 Patterns     F3 Options
F4 Help       F5 Sequencer    F6 Engine
Key View Description
F1 Dict Forth dictionary — learn about the language
F2 Patterns Manage your current session / project
F3 Options Configuration settings for the application
F4 Help Help and tutorials — learn about the tool
F5 Sequencer The main view, where you edit sequences and play music
F6 Engine Configuration settings for the audio engine

Use Ctrl+Arrow keys to move between adjacent views. A minimap will briefly appear to show your position in the grid. You can also click on the view name at the bottom left or in the top left corner of the header bar to open the switch view panel.

  • Ctrl+Left / Ctrl+Right — move horizontally (wraps around)
  • Ctrl+Up / Ctrl+Down — move vertically (does not wrap)

Secrets

There is a hidden seventh view: the Periodic Script. Press F11 to open it. The periodic script is a free-running Forth script evaluated at every step, independent of any pattern. It is useful for drones, global effects, control logic, and experimentation. See the Periodic Script tutorial for details.