# Remote connection

It is possible to have your StreamDeck connected to your main grading machine and still control OmniScope installed on a different computer.

```mermaid
flowchart LR
    subgraph A["StreamDeck machine"]
        SD["Stream Deck app + OmniScope plugin"]
    end

    subgraph B["OmniScope machine"]
        OM["Nobe OmniScope"]
        ST["StreamDeck support enabled"]
    end

    SD -->|"TCP port 4475"| OM
    ST --> OM
```

Please follow the steps below:

1. Install the latest version of the Nobe OmniScope StreamDeck plugin on the StreamDeck machine.
2. On the machine running OmniScope, enable **StreamDeck support** in **Settings / Preferences**.
3. Make sure the OmniScope machine is reachable from the StreamDeck machine over the network and that the selected port is allowed by the firewall.
4. In the Stream Deck app, add the **OmniScope Connection** action to any key.
5. Enter the IP address or hostname of the machine running OmniScope.
6. Enter the OmniScope port. The default port is `4475`.
7. Click **Save Shared Connection**.
8. Add regular **Nobe OmniScope** actions and set the desired **channel** on each tile.

{% hint style="info" %}
The IP / Host and Port are now configured directly in the Stream Deck plugin UI. You no longer need to edit `config*.json` files for remote connection.
{% endhint %}

## Which machine gets which value?

* **StreamDeck machine**: install the plugin and configure the **OmniScope Connection** action.
* **OmniScope machine**: run OmniScope with StreamDeck support enabled and make sure it listens on the same port.
* **IP / Host field**: enter the address of the **OmniScope machine**.
* **Port field**: enter the port that OmniScope is listening on, usually `4475`.

## Notes

* The shared connection only needs to be configured once per machine.
* Regular **Nobe OmniScope** actions only store the **channel**.
* If Stream Deck and OmniScope run on the same machine, you can leave the host blank to use the local config / defaults.