Actions Add-on

EarTrumpet includes a powerful built-in add-on called "Actions," which provides a rich automation system for managing your audio. You can create custom rules that perform specific actions when certain events occur.

To access the Actions settings, right-click the EarTrumpet icon, go to Settings, and select the Actions category.

Core Concepts

A rule in the Actions system is composed of three parts:

  1. Triggers (When): An event that initiates the rule. A rule can have multiple triggers (e.g., a hotkey is pressed OR a specific application starts).
  2. Conditions (Advanced Filter): An optional set of criteria that must all be true for the actions to be executed. This allows for more complex logic.
  3. Actions (Do): The task to be performed when the triggers and conditions are met.

Available Triggers

  • Application Event: Triggers when an app is added, removed, starts/stops playing sound, or is muted/unmuted.
  • Device Event: Triggers when an audio device is added, removed, or becomes/ceases to be the default.
  • Hotkey: Triggers when a specific keyboard shortcut is pressed.
  • Process: Triggers when a specific process (e.g., notepad.exe) starts or stops.
  • EarTrumpet Event: Triggers when EarTrumpet itself starts or shuts down.
  • Context Menu: Adds an item to the EarTrumpet right-click menu that will trigger this rule.

Available Conditions

  • Default Device: Checks if a specific device is (or is not) the current default playback device.
  • Process: Checks if a specific process is (or is not) currently running.
  • Variable: Checks if a local variable (which you can set with an action) is true or false.

Available Actions

  • Set App Mute/Volume: Mutes, unmutes, or sets the volume for a specific application (or all applications).
  • Set Device Mute/Volume: Mutes, unmutes, or sets the volume for a specific audio device.
  • Set Default Device: Changes the system's default playback device.
  • Set Variable: Sets a local boolean (true/false) variable. This is useful for creating stateful rules, such as a "Gaming Mode" that can be toggled on or off.

Example Rule

Here's an example of a rule you could create:

  • WHEN: Hotkey Ctrl+Alt+G is typed.
  • DO:
    1. Set variable isInGameMode to true.
    2. Set default device to Headphones.
    3. Set volume of Discord to 50%.