Skip to content

adobe

This directory contains the Talon configuration and script files to enable voice-control integration for Adobe Acrobat Reader DC and Adobe Acrobat DC on Windows.

The configuration is split into three main files that work together to define the application, enable general-purpose Talon tags, and map those tags to application-specific hotkeys.

How the Files Work Together

The integration is modularized into definition, activation, and implementation steps:

  1. Application Definition: adobe_acrobat_reader_dc.py defines how Talon identifies the application. It maps the identifier adobe_acrobat_reader_dc to running instances of either acrobat.exe or acrord32.exe on Windows.
  2. Tag Activation: adobe_acrobat_reader_dc.talon matches when the defined application is active. It enables the standard Talon tags user.tabs and user.pages. This allows general voice commands for page and tab navigation to become active.
  3. Action Implementation: adobe_acrobat_reader_dc_win.py overrides Talon's standard action behaviors specifically for Windows when Adobe Acrobat is focused. It maps the standard actions enabled by the tags to Adobe Acrobat's keyboard shortcuts.

Detailed Component Breakdown

Application Definition

The adobe_acrobat_reader_dc.py file uses Talon's Module API to declare a new application context. It uses regular expressions to match the executables for both the standard and reader versions of Adobe Acrobat on Windows:

  • Executables matched: acrobat.exe (Adobe Acrobat Pro/Standard) and acrord32.exe (Adobe Acrobat Reader).

Voice Command Behavior

The adobe_acrobat_reader_dc.talon file links the application context to Talon's system-wide behaviors by activating two tag groups:

  • user.tabs: Enables tab navigation commands (e.g., switching to the next or previous tab).
  • user.pages: Enables document-focused page navigation commands (e.g., jumping to a page, scrolling, or rotating).

Action Implementations

The adobe_acrobat_reader_dc_win.py file contains the specific keyboard shortcuts that translate Talon commands into Acrobat interactions:

  • Tab Navigation (app actions): Maps standard tab commands to ctrl-tab (next tab) and ctrl-shift-tab (previous tab).
  • Zooming (edit actions): Maps zooming actions to Adobe's default zoom hotkeys (ctrl-0 for zoom in, ctrl-1 for zoom out, and ctrl-2 for reset).
  • Page Navigation (user actions): Implements complex interactions for navigating documents, including:
    • Jumping to a specific page number (page_jump) by automating the Go To Page dialog (ctrl-shift-n), typing the page number, and pressing enter.
    • Retrieving the current page number (page_current).
    • Navigating to next/previous pages (ctrl-pagedown / ctrl-pageup) or skipping to the end (end).
    • Rotating pages left (shift-ctrl-1) and right (shift-ctrl-0).