atril

The community/apps/atril directory contains files to enable Talon voice control for the Atril document viewer application on Linux.

The primary file is atril.py, which defines the application context and implements custom user actions. It declares an application named "atril" that matches when running on Linux and the app name is "Atril". It then defines a context that will activate when the "atril" application is active. This context contains implementations for user.page_current, user.page_next, user.page_previous, user.page_jump, and user.page_final actions, which are used to navigate pages in a document. These actions generally rely on keyboard shortcuts like ctrl-l to focus the page number input, ctrl-pagedown for next page, ctrl-pageup for previous page, etc.

The file atril.talon sets the user.pages tag whenever Atril is the active application. This tag is used to enable the user to say things like "page next" and "page jump 5".