Skip to content

talon_debug_window

This directory contains voice commands and application definitions designed to streamline working with the Talon Debug Window, a feature currently available in the Talon beta.

The primary goal of these files is to make it easy to inspect, search, and filter Talon's internal states, active actions, settings, tags, and captures using voice commands when the debug window is active.

How It Works

The functionality is split between detecting the debug window and defining the voice commands that apply to it:

  • Application Detection: talon_debug_window.py defines the talon_debug_window application scope. It targets the Talon Debug interface on both macOS (by checking for the com.talonvoice.Talon bundle and "Talon Debug" window title) and Windows (by checking for the talon.exe process and "Talon Debug" window title).
  • Voice Commands: talon_debug_window.talon activates only when the debug window is focused. It provides short, specific voice commands for dictating complex programming structures directly into the debug window's search/filter box.

Key Features and Commands

When the search box in the Talon Debug window is focused, you can use these specialized commands to instantly input different types of Talon registry items:

  • Tags: Say tag <user.talon_tags> to quickly search for active tags.
  • Actions: Say action <user.talon_actions> to search for registered actions.
  • Keys and Modifiers: Use key <user.keys> over or key <user.modifiers> over to input key combinations.
  • Settings, Captures, Lists, and Apps: Use commands like set <user.talon_settings> or application <user.talon_apps> to inspect settings and application definitions.

Important Configuration Notes

  • Populating Lists: The .talon file mentions the user.talon_populate_lists tag. Enabling this tag activates comprehensive lists of all registered actions, scopes, and modes.
  • Performance Considerations:
    • Do not enable this tag if you are using the Dragon speech recognition engine, as it will make the interface unusable.
    • If you are using the Conformer engine, enabling this tag may introduce noticeable latency depending on your CPU capabilities.