Skip to content

win

This directory contains platform-specific key configuration files for Windows and Linux operating systems within the Talon voice control system. These files define mappings between spoken words (voice commands) and physical keyboard inputs, establishing a foundational layout for keyboard-based navigation and shortcuts.

By isolating these definitions here, Talon can dynamically load the appropriate keyboard configurations based on the host operating system, ensuring consistent behavior even when switching between different environments.

Keyboard Mapping Lists

The directory contains two essential .talon-list configuration files:

  • modifier_key.talon-list: Defines the spoken vocabulary for keyboard modifiers (user.modifier_key) such as Alt, Control, Shift, and Super (the Windows key). Notably, this file includes cross-platform aliases; it maps macOS terminology like "command" and "option" to "ctrl" and "alt" respectively, allowing users with macOS muscle memory to use the same voice commands seamlessly on Windows or Linux.
  • special_key.talon-list: Defines the spoken vocabulary for specialized navigation and editing keys (user.special_key). It includes mappings for navigation (e.g., home, end, page up), system controls (e.g., escape, print screen, menu key), and editing actions. It also supports multiple spoken phrases for the same action, such as mapping both "wipe" and "delete" to the backspace key, while reserving "forward delete" for the standard delete key.

How They Work Together

Talon uses these files to populate its internal registry of spoken symbols. When a user speaks a command that involves keyboard manipulation (for example, triggering a shortcut like "control shift home"), Talon performs the following sequence:

  1. Context Matching: Talon detects that the operating system is Windows or Linux and activates the lists defined in this directory.
  2. Lookup: The speech recognition engine matches "control" and "shift" against the modifiers in modifier_key.talon-list, and "home" against the keys in special_key.talon-list.
  3. Execution: Talon translates these spoken tokens into their respective OS-level key codes (ctrl, shift, and home) and dispatches the keystrokes to the active application.