> 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/streamdeck/configuration.md).

# Configuration

For the latest configuration options please check [Action Editor](/nobe-omniscope/action-editor.md)

***

StreamDeck support needs to be enabled in the Options / Preferences window first:

<figure><img src="/files/VD1cP82M8Q8ve2kR0LJo" alt=""><figcaption><p>Enable StreamDeck support in Preferences</p></figcaption></figure>

There are two parts to the StreamDeck setup:

1. Configure the shared OmniScope connection once with the **OmniScope Connection** action in Stream Deck.
2. Configure the per-button **channel** on each **Nobe OmniScope** action.

To configure the shared connection, drag the **OmniScope Connection** action onto any key, enter the OmniScope IP / Host and Port, then click **Save Shared Connection**.

<figure><img src="/files/BMMrDJ4SmnxnIOKj5A1X" alt=""><figcaption><p>Use the OmniScope Connection action to set the shared IP / Host and Port for all OmniScope actions</p></figcaption></figure>

{% hint style="info" %}
You only need to configure the IP / Host and Port once. Regular **Nobe OmniScope** actions only need the **channel** value.
{% endhint %}

If OmniScope runs on the same machine as Stream Deck, you can leave the host blank to use the local config / defaults.

Once the connection is configured, we can access the StreamDeck submenu in various places in OmniScope to create and manage mappings.

<figure><img src="/files/PjfflwiD4dw2vur3UE0J" alt=""><figcaption><p>StreamDeck mapping in the Action Editor</p></figcaption></figure>

### Stream Deck+ Dials

Stream Deck+ dials (rotary encoders) are configured the same way as buttons — assign a **channel** number to each **Nobe OmniScope** dial action in the Stream Deck app. Many actions respond to dial rotation and press with additional behaviour such as continuous zoom, cycling through layouts, or adjusting blend amounts. See [Available Actions → Stream Deck+ Dial Support](/nobe-omniscope/streamdeck/available-actions.md#stream-deck-dial-support) for the full list.

All the existing StreamDeck mappings can be seen in Options / StreamDeck Mappings… menu:

![](/files/-MG3PLha1-ClVeuH6nuA)

<figure><img src="/files/sC5Ikc7qq7tyfyxlAsEd" alt=""><figcaption><p>StreamDeck Mappings window</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.timeinpixels.com/nobe-omniscope/streamdeck/configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
