RTI Bridge — Support

Setup, installation, and troubleshooting for the RTI Bridge Stream Deck plugin and its companion RTI XP driver.

Installation

RTI Bridge has two halves that get installed by different people, on different computers:

HalfWhatWho installs itWhere
.rtidriver RTI XP processor driver Your RTI integrator Integration Designer, on the RTI processor
.streamDeckPlugin Stream Deck plugin You (the end user) The PC or Mac that has your Stream Deck plugged in

Both halves are required. The plugin connects to the driver over your local network.

Part 1 — RTI driver (your integrator does this)

If you have an RTI integrator who manages your project file, send them the .rtidriver and a link to this page. Their part:

1
Open the project

In Integration Designer, open the project file for your RTI processor.

2
Add the driver

Add the Elgato Stream Deck Bridge driver to the project (drag the .rtidriver file onto the workspace).

3
Configure slot counts

Open the driver's Properties, go to the Slot Counts category, and set how many of each you want:

  • Number of Command Slots — fire-and-forget macros (1 to 20)
  • Number of Value Slots — set/increment integer values like volume (1 to 10)
  • Number of State Slots — feedback to display on Stream Deck buttons (1 to 20)
4
Wire each slot
  • Command N — set Display Name (e.g. "Cinema On") and pick the Macro from the dropdown.
  • Value N — set Display Name (e.g. "Master Volume"), pick a Function (must take one integer parameter), set Min/Max bounds.
  • State N — set Display Name and pick ONE of the three sysvar pickers (boolean, integer, or string) depending on the type.
5
Network & licence

Network category: the default port is 12520. Leave unless there's a conflict.

Licence category: paste the licence key from your purchase confirmation email. Leave blank for a 30-day free trial.

6
Send to processor

Send the project to the processor and verify the driver loads — the SystemVariable ConnectionStatus should read Listening on port 12520.

7
Note the IP

Note the IP address of the RTI processor — you'll need it for Part 2.

If you bought this without an integrator, you'll need someone with Integration Designer access to do this part. The driver only adds new capabilities — it doesn't change any existing macro or button behaviour.

Part 2 — Stream Deck plugin (you do this)

Install the Stream Deck app first — if you haven't already, install Elgato's Stream Deck app from elgato.com/downloads. Plug your Stream Deck into your PC or Mac via USB. Confirm the buttons light up and you can drop simple actions onto them.

Install the RTI Bridge plugin

  1. Download the .streamDeckPlugin file from your purchase confirmation email or your account page on shpdrivers.services/store.
  2. Double-click it. The Stream Deck app prompts: "Install RTI Bridge plugin?" — click Install.
  3. The plugin appears in the Stream Deck app's right-hand action list under the RTI Bridge category.

Connect the plugin to your RTI processor

  1. Drag any RTI Bridge action onto a Stream Deck key. Click that key to open its settings.
  2. At the top of the action settings panel, fill in:
    • RTI Processor IP — the IP your integrator gave you (e.g. 192.168.1.10)
    • TCP Port — leave at 12520 unless your integrator changed it
  3. Within a couple of seconds, the connection status indicator should turn green: "Connected to RTI driver".

Note: the licence key is configured in the RTI driver's IDesign settings, not in the plugin. Your integrator pastes it on the RTI processor side. The plugin doesn't need to know it.

Adding Buttons

The plugin provides three action types in Stream Deck's right-hand action list:

ActionWhat it does
RTI Command Press to fire a macro. Optional long-press fires a second macro (doubles your button count). Optional state binding flips the icon and/or shows live data on the title.
RTI Value Press to set, increment, or decrement an integer value (volume, dimmer level, setpoint).
RTI State Display Read-only key that shows live state from RTI (current volume, source name, on/off indicator).

Drag any of them onto a Stream Deck key, click the key, and pick a slot from the dropdown. The dropdown contents come live from the RTI driver — if you don't see the slot you expect, ask your integrator to double-check the driver config and click Refresh List in the action settings.

State binding (icon swaps with sysvar)

An RTI Command can swap its icon based on a boolean sysvar (e.g. yellow lightbulb when ON, grey when OFF). Configure:

  1. An RTI State slot in IDesign pointing at the bool sysvar.
  2. On the Stream Deck button, in Feedback (optional) → Icon State Slot, pick that state slot.
  3. Click each of the two state thumbnails (○ ○) under the button preview to assign different icons for OFF and ON.

Title formatting

The Format field on State Display and RTI Command actions supports several placeholders for integer values:

FormatExample valueOutput
%d-405-405
%d/10-405-40.5
%d/10 dB-405-40.5 dB
%d/100235023.50
%.2d/10-405-40.50 (forced 2 decimals)
%d%%7575%
Vol %d/10 dB-405Vol -40.5 dB

For boolean sysvars, set the ON Label and OFF Label fields. The button title shows whichever applies.

Troubleshooting

"Not connected — check IP/port above"

The plugin can't reach the RTI processor. Check:

  1. The IP address matches your RTI processor (verify with your integrator).
  2. Your computer is on the same network as the processor.
  3. The TCP port (default 12520) isn't blocked by a firewall.
  4. The Stream Deck Bridge driver is loaded in your IDesign project.
"Connection refused — driver not running or wrong port"

The processor is reachable but nothing is listening on the configured port. Have your integrator check:

  • The driver shows up in IDesign with no errors.
  • The processor's TraceView shows [StreamDeck] TCPServer listening on port 12520.
  • The driver wasn't disabled in the project.
"Driver not responding — RTI processor may be overloaded"

The TCP connection succeeds but the driver doesn't respond to the handshake within 8 seconds. Common causes:

  • The RTI processor is running many drivers and is CPU-bound.
  • Another process is holding the driver in a stuck state.

Have your integrator reset the driver in IDesign (right-click → Reset Driver, or untick + retick Enabled). If it persists, a full processor reboot usually clears it.

"Connected — but driver licence expired"

You've passed the 30-day free trial without entering a licence key. Buy a licence from shpdrivers.services/store and have your integrator paste it into the driver's Licence Key field in IDesign, then resend the project to the processor. The plugin reconnects automatically.

"(no commands configured in driver)" appears in the dropdown

The driver isn't reporting any slots. Three possibilities:

  1. Plugin isn't connected — check the connection status indicator above the dropdowns.
  2. Your integrator hasn't filled in any slots — they need to set Number of Command Slots > 0 and pick a macro for each.
  3. Wrong IP or port — verify what you entered against what your integrator gave you.
Button title shows "Slot 3" instead of the friendly name

The integrator filled in the macro/sysvar but not the Display Name. Ask them to set a friendly name on each slot and re-send the project.

Buttons fire but nothing happens on the AV system

That's an RTI-side issue (the macro you picked isn't doing what you expected). Test the same macro from your existing RTI remote or touch panel — if it doesn't work there either, the issue is in the macro itself. If it works elsewhere but not from Stream Deck, contact us via the email below.

State icon doesn't swap when the sysvar changes

The state slot needs to be configured with a boolean sysvar in IDesign. If you picked an integer sysvar, the icon won't swap (but the title will display the integer value).

Also: if you have BOTH the bool and int picker filled in for the same State slot in IDesign, the driver picks the integer. The plugin then uses the integer value, not bool, so the icon stays in state 0. Have your integrator clear the picker fields they didn't intend to use.

Plugin worked yesterday, doesn't work today after RTI changes

If your integrator changed slot counts or added/removed slots, the plugin's catalog needs to refresh. Either:

  • Open any RTI Bridge action's settings panel — the catalog auto-refreshes when the PI opens.
  • Click the Refresh List button in the action settings.
  • Restart the Stream Deck app (right-click tray icon → Quit, then reopen).

FAQ

Do I need to be technical to install this?

The plugin install is one click. The setup of the RTI side requires Integration Designer access — your AV integrator handles that. If you don't have an integrator, you'll need someone with IDesign access.

Why is the plugin free but the driver paid?

The plugin is shareable infrastructure — anyone with an RTI system can use it. The driver is the work product (custom RTI code, support, ongoing updates) so it's licensed per processor. Trial is 30 days.

Will my integrator know how to set this up?

Any RTI-certified integrator can install the driver and wire up macros — it follows standard IDesign conventions. Send them the link to shpdrivers.services/store.

Can I use multiple Stream Decks?

Yes. Each Stream Deck plugged into the same PC will pull from the same global IP/port settings, so multiple Stream Decks see the same RTI macros and variables.

Does this work with Stream Deck +, XL, MK.2?

Yes — any keypad-based Stream Deck. Stream Deck + dial actions are not currently supported (planned for a future release).

How many buttons can a Stream Deck Mini control?

A Mini has 6 keys, but with long-press support each Command button can fire two different macros (short tap vs. hold). That's effectively 12 commands per Mini page. Stream Deck pages also let you swap between multiple sets of buttons — pick one of your 6 to be a "page navigator" and you can have dozens of buttons.

What about latency?

All commands fire over local LAN — typical round-trip is well under 100ms. State changes from the RTI processor reach the button within the same window.

Does the plugin send any data to the cloud?

No. The plugin connects directly to your RTI processor on your local network. No telemetry, no analytics, no third-party services. See the privacy policy for details.

Contact & Support

For licence questions, bug reports, or feature requests:

When emailing about licence issues, include your RTI processor's MAC address — find it in the driver's MacAddress SystemVariable in IDesign.