Skip to content

dolphin

This directory provides Talon voice command integration and configuration for Dolphin, the default file manager for the KDE Plasma desktop environment on Linux.

It contains two primary files that work together to map Talon's standardized user actions (for tabs, navigation, and file management) to Dolphin's specific keyboard shortcuts.

How It Works

The configuration is divided into two parts: a Python file that defines the application context and implements system-level actions, and a .talon file that maps voice commands and activates appropriate feature tags.

  • dolphin.py:

    • Application Definition: Declares the apps.dolphin identifier, targeting the application name dolphin on the linux operating system.
    • Context Action Implementation: Implements the UserActions class for Dolphin. It overrides standard Talon actions to use Dolphin's specific hotkeys:
      • Tabs: Navigates to a specific tab using alt-{number} (via user.tabs).
      • Navigation: Handles back (alt-left) and forward (alt-right) navigation.
      • File Management: Supports opening a parent directory (alt-up), showing properties of the selected item (alt-enter), changing directories via the path bar (ctrl-l), creating a new folder (ctrl-shift-n), and opening a terminal in the current directory (alt-shift-f4).

  • dolphin.talon:

    • Context Scope: Activates only when Dolphin is the active application.
    • Tags: Enables the standard user.tabs, user.file_manager, and user.navigation tags. This activates all generic Talon commands associated with these concepts, which are then handled by the implementations in dolphin.py.
    • Specific Commands: Defines explicit voice commands unique to or commonly used in this context, such as refresh it / reload it (sends f5) and file rename (sends f2).