Skip to content

mac

This directory contains the macOS-specific keyboard mapping configuration files for the Talon voice control system. These files customize how spoken voice commands translate into keypresses specifically when running on a Mac operating system, overriding or supplementing generic platform-agnostic definitions.

These configuration files define two primary types of keys:

Key Mappings and Functionality

Both files use Talon's list declaration format, targeting the os: mac environment. This restriction ensures that these specific key mappings are only loaded and active when the user is operating on macOS.

Modifier Keys

The modifier_key.talon-list file defines the user.modifier_key list. It ensures that standard Mac modifier keys can be spoken in multiple intuitive ways:

  • Command Key: Registered under both "command" and "super" (standard cross-platform terminology) to trigger the cmd modifier.
  • Option Key: Registered under both "option" and "alt" to trigger the alt modifier.
  • Function Key: Registered under both "function" and "globe" (matching the icon on modern Apple keyboards) to trigger the fn modifier.
  • Control and Shift: Mapped conventionally to ctrl and shift.

Special Keys

The special_key.talon-list file defines the user.special_key list for navigation and system keys. Key configurations of note include:

  • Deletion: Maps "wipe" and "delete" to standard Mac backspace. To delete forward (standard PC "delete" behavior), the spoken phrase "forward delete" maps to the delete key.
  • Enter/Return: Separates the main keyboard "return" key (mapped to "return") from the "enter" key located on the numeric keypad (mapped to "page down" / "keypad_enter").
  • Navigation: Standard mappings for "home", "end", "page up" (pageup), "page down" (pagedown), "tab", and "space".

How They Work Together

When Talon parses voice commands that require key combinations (e.g., saying "control option shift command delete"), it resolves the spoken modifiers and special keys by looking up the current OS context. On macOS, Talon loads these specific .talon-list files to populate the user.modifier_key and user.special_key lists.

By having platform-specific files, the core Talon voice engine can remain clean and modular, allowing users to use consistent spoken commands (like "command" or "option") across different physical keyboard layouts and operating systems.