Audio Editors (STE, ETE, MTE)

Configurable Actions in the Clipboard

NEW since version 8.5.1871.0!

You can enhance the right-click menu of the audio clipboard by adding actions. Configuring these actions requires usage of Digas Admin or DPE Admin.

Why you want to do this: To launch an external program, e.g. for additional processing of the audio file.

Configuration

  • In the applications main settings key (i.e. MultiTrack|Settings or EasyTrack|Settings or SingleTrack|Settings), create the subkey ClipboardActions.

  • In the new key ClipboardActions, create a subkey for each action you want to add. The name of the subkey doesn’t matter, but only alphanumeric characters are allowed. Choose a name that tells what the action is about.

  • In the subkey for the action, create the following string entries:

    • Config (obligatory): The value of this entry is the command line of the tool you want to launch. The sequence {FILE} (curly braces and all upper case) is later replaced by the path and name of the audio file, and {TITLE} is replaced by the title of the audio.

    • Label (optional): The name under which this action appears in the menu. Defaults to the name of the key.

    • Wait (optional): Whether MTE should wait for the action to finish (1=yes, 0=no). Defaults to 0.

    • Success (optional): If Wait=1, then the editor monitors the tool’s exit code. The codes from this parameter count as “success.” All other codes generate an error message. Separate codes by commas or vertical bars. Defaults to 0.

    • Timeout (optional): If Wait=1, this is the number of seconds to wait before the program gives up.

    • DisplayIndex (optional): A positive number. Actions appear in the menu in order of these numbers.

    • Enabled (optional): Whether the action should be visible on the menu (1=yes, 0=no). Defaults to 1.

    • ActionRight (optional): A list of user action rights which are required to see this action. Separate rights by commas or vertical bars. By default no specific rights are required.

With this configuration, configured actions appear in the pop-up menu when you right-click an audio take in the clipboard above the clip color selection.

Actions are removed from the menu if multiple clipboard items are selected, or if the selected item is not a take.

Using a Sub Menu

When configuring many actions, you have the option to put them in a submenu. To do this, add the string parameter SubmenuName to the ClipboardActions key. The value is the desired name of the submenu. This action is always dsplayed, regardless of how many clipboard items and what type of clipboard items are selected.

The “Refresh” Action

Configuration entries for clipboard actions are read when the program starts up. While you are adding or editing entries, you may want to quickly activate new or changed entries without restarting the program. For this purpose, create a subkey in ClipboardActions, and in this subkey add the string value Action with value Refresh. You can add the optional entries Label, DisplayIndex, Enabled, and ActionRight, which have the same meaning as described above.

The “Refresh” action should be disabled or deleted before this configuration goes productive because it may confuse non-admin users. A better option is to configure it in the LOCAL or USER registry only.