Skip to content

find

This directory implements a standardized, generic "find" (search) interface for Talon Voice. It establishes a reusable tag structure, allowing various application-specific contexts to easily opt-in to a unified set of voice commands for searching text.

How It Works

The directory relies on Talon's tag-activation model. By defining a generic tag and associating a set of voice commands with it, individual application configurations can simply activate this tag to instantly inherit standard search commands. These commands map directly to Talon's built-in, abstract edit actions (such as edit.find()), which applications can override as needed.

Key Files

find.py

This Python script initializes the Talon module and defines the user.find tag:

mod.tag("find", desc="Tag for enabling generic find commands")

Defining this tag creates a standard configuration contract. Any application context that declares tag: user.find will enable the commands defined in the accompanying .talon file.

find.talon

This file contains the voice command definitions that become active when the user.find tag is enabled. It uses the "hunt" vocabulary as a distinct, easily recognizable voice trigger for search operations:

  • "hunt this": Triggers edit.find() to open the search dialog or highlight the current selection.
  • "hunt this paste" / "hunt this pace": Opens the find interface and automatically pastes the current clipboard contents.
  • "hunt this <user.text>": Initiates a search directly with the dictated text.
  • "hunt next" / "hunt previous": Navigates through search results using edit.find_next() and edit.find_previous().