> For the complete documentation index, see [llms.txt](https://docs.timeinpixels.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.timeinpixels.com/nobe-omniscope/action-editor.md).

# Action Editor

Configuration manager for keyboard shortcuts and StreamDeck actions

The Action Editor provides a centralized interface for configuring keyboard shortcuts and StreamDeck panel mappings. It is designed for professionals in demanding workflows where quick, efficient actions are essential.

<figure><img src="https://565437294-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MFqn5MuayPgQPMZ9pwf%2Fuploads%2Fgit-blob-04f441ccd799c71d22e57683071e71872bcd7ed4%2F2024-01_action_editor.jpeg?alt=media" alt=""><figcaption><p>Action Editor</p></figcaption></figure>

## Action Categories

The Action Editor organizes actions into intuitive categories:

* **General Actions** — Straightforward actions that don't require additional parameters, ideal for quick and routine tasks.
* **Input Device Actions** — Assign specific devices to desired input slots, essential in multi-device environments.
* **Layout Actions** — The **Load Layout** action accepts two parameters: layout index or name, making it easy to switch between different layouts.
* **Input Slot Actions** — Assign actions to specific input slots, ensuring accurate responses from the intended device. Particularly useful in complex multi-input setups.
* **Scope Actions** — Each action is linked to a unique scope identifier, visible in the Action Editor. This allows precise control over multiple scopes.
* **Timeline Navigation Actions** — Direct actions for **Go to Frame** and **Go to Time**, enabling precise timeline jumps from shortcuts, Stream Deck, and integrations.
* **Input Settings Actions** — Expose source settings directly through the Action Editor and integrations.

## User-Friendly Features

* **Preview of Scope Index** — View the scope index by pressing **Alt+Shift** (or **Opt+Shift** on macOS), even when the Action Editor is closed. This aids in fast scope identification.
* **Action Filtering** — Narrow down actions for a specific scope using the search box. For example, typing **`idx:3`** filters actions exclusively for scope index 3.

<figure><img src="https://565437294-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MFqn5MuayPgQPMZ9pwf%2Fuploads%2Fgit-blob-740c92ad6f944da3517157640919034bea52741c%2F2024-01_action_editor_filtering_scopes.jpeg?alt=media" alt=""><figcaption><p>Filtering actions by scope index</p></figcaption></figure>

* **Clearing the mappings** — Use the "3 dots" menu to reset existing mappings and start from scratch:

<figure><img src="https://565437294-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MFqn5MuayPgQPMZ9pwf%2Fuploads%2Fgit-blob-8af00d892db040e917a88d56ddbbd7f3331d7a06%2F2024-01_action_editor_hamburger.jpeg?alt=media" alt=""><figcaption><p>Reset mappings menu</p></figcaption></figure>

## Assigning Keyboard Shortcuts and StreamDeck Actions

* **Keyboard Shortcuts** — Click the action name to record a new shortcut. OmniScope will notify you if the chosen shortcut is already in use, preventing conflicts.

<figure><img src="https://565437294-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MFqn5MuayPgQPMZ9pwf%2Fuploads%2Fgit-blob-23d60631ea6cdd0209349e037bd229aa17e7235b%2F2024-01_action_editor_recording.jpeg?alt=media" alt=""><figcaption><p>Recording a keyboard shortcut</p></figcaption></figure>

* **StreamDeck Actions** — Two columns in the editor, **StreamDeck** and **Per Layout**, provide flexibility in mapping. Global mappings apply across all layouts, while Per Layout mappings are specific to the current layout and override global mappings when active.

<figure><img src="https://565437294-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MFqn5MuayPgQPMZ9pwf%2Fuploads%2Fgit-blob-8717d438d19a79a16f95b8a73beadd8195fefa3f%2F2024-01_action_editor_override.jpeg?alt=media" alt=""><figcaption><p>StreamDeck global and per-layout mappings</p></figcaption></figure>

* **Keyboard shortcuts** are automatically displayed in the macOS menus:

<figure><img src="https://565437294-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MFqn5MuayPgQPMZ9pwf%2Fuploads%2Fgit-blob-e6f2ee71a0a3ac6a8b06a6f8cf216211be9fbd9f%2F2024-01_action_editor_key_shortcuts.jpeg?alt=media" alt=""><figcaption><p>Shortcuts in macOS menus</p></figcaption></figure>

## Application Protocol

OmniScope supports invoking actions programmatically using the custom URI scheme **`omniscope://`**. This enables workflow automation and integration with scripts, macros, or third-party applications.

Format: **`omniscope://action?id=ActionID&param=ActionParam`**

The **ActionID** can be found by hovering over the action in the editor:

<figure><img src="https://565437294-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MFqn5MuayPgQPMZ9pwf%2Fuploads%2Fgit-blob-f4a73193203f6b01685fe1fbb7af766e2b27a264%2F2024-01_action_editor_tooltip.jpeg?alt=media" alt=""><figcaption><p>Action ID tooltip</p></figcaption></figure>