Skip to content

orion

This directory integrates the Orion Browser (a privacy-focused macOS web browser developed by Kagi) with the Talon voice control system. It defines how Talon recognizes the application and implements both standard browser actions and custom voice commands.

Application Definition and Actions

The core application logic is implemented in orion.py.

  • Application Matching: It registers the application identifier com.kagi.kagimacOS under macOS, associating it with the name orion.
  • Standard Browser Implementations: It implements specialized keyboard shortcuts for standard web browser commands, overriding default Talon behaviors to match Orion's interface:
    • Hard Reload: cmd-alt-r
    • Clear Cache: cmd-alt-e
    • Show Downloads: cmd-alt-l
    • Show Extensions: cmd-shift-x
    • Open Address in New Tab: cmd-enter
  • Custom Action: It defines a new module action, user.overview_tabs(), which sends the macOS keyboard shortcut cmd-shift-\ to trigger Orion's native tab overview layout.

Voice Commands and Tags

The voice interface is configured in orion.talon.

When Orion is the active application, this file:

  • Activates the global browser and user.tabs tags, inherited from the broader community configuration. This ensures that generic, cross-browser commands (like navigating back and forth, opening tabs, or switching tabs) automatically work in Orion.

  • Declares a specific voice command to trigger the custom tab overview:

  • "tab overview [open | close]" -> executes user.overview_tabs()