Skip to content

apple_notes

This directory provides voice control integration for the macOS Apple Notes application. It maps natural language voice commands to native application shortcuts and overrides global editing commands to ensure that generic Talon operations behave correctly within Apple Notes.

The implementation consists of two main files:

  • apple_notes.talon defines application-specific voice commands. These are active only when the Notes application is in focus on macOS. It provides spoken commands for:

    • Note Management: "new note", "duplicate note", "new folder", and "print note".
    • Navigation & UI: "toggle folders", "show main", "list view", "gallery view", and "find all".
    • Formatting & Styles: Quick styling for headings ("apply title", "apply heading", "apply subheading"), body text, and lists ("apply bullet", "apply checklist").
    • Editing Operations: Custom behavior for adding line breaks, inserting tables, creating links, and adjusting font sizes.

  • apple_notes.py overrides Talon's standard editing actions specifically for Apple Notes. By matching the app: notes context, it remaps standard editing behaviors (like zooming and adjusting indentation) to the specific key combinations that Apple Notes expects:

    • edit.zoom_in() is bound to shift-cmd->
    • edit.zoom_out() is bound to shift-cmd-<
    • edit.zoom_reset() is bound to shift-cmd-0
    • edit.indent_less() is bound to cmd-[

How They Work Together

Together, these files ensure a seamless, hands-free experience when using Apple Notes. The .py file ensures that generic, system-wide Talon commands (such as zooming in or out) map to the correct macOS shortcuts, while the .talon file exposes the specialized, high-level features of Apple Notes—such as creating checklists or toggling the folder sidebar—directly to your voice.