Configuration

chordgen reads its config from ~/.config/chordgen/config.yaml, created by chordgen setup. The full schema (with every option's default) is generated from the pydantic config model, see Schema.

For non-trivial setups (custom layouts, key codes, priority tiers), my dotfiles are a useful reference.

Top-level keys

• gen — chord generation: vocabulary file, keyboard model, alt-generator categories, and assignment options. See gen.
• output — which output formats to emit and per-format options (key codes, key positions, chord timeouts, ...). See Output formats.
• learn — learn-mode TUI knobs (daily quotas, leech / mastery thresholds, slow grading). See learn.
• drill — drill-mode TUI knobs (mode, count, timer). See drill.
• theme — Textual theme used by the learn and drill TUIs. Updated automatically when you change the theme via the in-app command palette (Ctrl+P).