protonmail

This directory provides voice control integration for ProtonMail within the Talon voice recognition system.

It contains a single configuration file, protonmail.talon, which maps spoken natural language commands to ProtonMail's native web-based keyboard shortcuts.

Activation Context

The commands defined in this directory are context-aware. They only activate when: * The active application is a web browser (indicated by the tag: browser requirement). * The active window title matches the pattern /ProtonMail/ (indicated by the win.title requirement).

This ensures that the ProtonMail voice commands do not conflict with general browser navigation or other web applications.

How it Works

The protonmail.talon file coordinates several functional areas of the ProtonMail interface:

General Application & Composer Controls

These commands manage global application actions and email composition: * Interface Management: Commands like "open help" (?), "search" (/), and "open command palette" (shift-space) activate built-in ProtonMail overlay menus. * Composing Mail: Allows you to start a new email ("new message" -> c), save a draft ("save message" -> ctrl-s), or send ("send message" -> ctrl-enter).

Users can quickly switch folders using "go to" or "jump to" prefix commands. These trigger sequential keystrokes (such as g followed by i for the Inbox) to navigate the web mail client: * Inbox: "go to inbox" / "jump to inbox" * Drafts: "go to draft" / "jump to draft" * Sent: "go to sent" / "jump to sent" * Starred, Archive, Spam, and Trash: Equivalent sequential commands.

Threadlist and Message Actions

Once inside a folder, you can navigate and act on message threads using keyboard-mapped voice commands: * Navigation: Move up and down the list using "next message" and "previous message", or read newer/older messages using the j and k shortcuts. * Selection: "select all" and "deselect all" handle bulk actions. * Thread Actions: "mark as read", "mark as unread", "star message", and folder-routing commands ("move to archive", "move to trash", etc.) allow rapid mailbox triage. * Replying & Forwarding: Standard actions like reply, reply all, and forward are mapped to their respective capitalized hotkeys (e.g., shift-r, shift-a, shift-f).

Contacts Management

The file also provides commands for managing contacts within the ProtonMail Contacts interface, allowing you to traverse contact lists using vertical arrow key equivalents, delete contacts, or save modified contact details (ctrl-s).