Skip to content

talon_helpers

The community/plugin/talon_helpers directory contains files that provide actions for debugging and interacting with Talon.

  • talon_helpers.talon defines the voice commands that trigger the actions in talon_helpers.py and create_app_context.py.

    • It includes commands for checking for updates, opening debug windows and logs, and copying application context information to the clipboard.
    • It also provides commands for simulating phrases, debugging actions, lists, tags, modes, and scopes. These commands are useful for understanding the current state of Talon.
    • Finally, there are commands to help create new application contexts.

  • talon_helpers.py provides python implementations of the actions called in talon_helpers.talon.

    • It includes actions for adding context information to the clipboard for use in .talon and .py files, tailored for macOS, Windows, and Linux.
    • It has actions to simulate a phrase and dump the result to the log, find an action, and dump the contents of a list to the console.
    • There are debugging actions to output active tags, modes, and scopes, including the ability to copy lists to the clipboard, as well as output settings.
    • It has actions that return active context information, including the application name, executable, bundle, title, and hostname.
    • Finally, there are actions that provide various debugging information for the current application, including versions, window info, and pretty printing.

  • create_app_context.py has actions to create new application context files for the current application.

    • The talon_create_app_context action will generate a new directory in the community/apps directory with a .talon and .py file for the current application.
    • It creates default context files that include the application name, platform, and other information used to define application contexts in Talon.
    • The talon_create_windows_app_context, talon_create_linux_app_context, and talon_create_mac_app_context actions create context files that include explicit platform information.

These files work together to provide a suite of useful tools for Talon users to debug and understand their Talon configuration, and quickly generate new application contexts.