SAMMI Bridge

SAMMI Bridge is the bridge.html file in your SAMMI/bridge folder. Bridge connects to your SAMMI to receive and send messages from extensions.


Latest Version #

You can automatically update your Bridge to the latest version by going to SAMMI Core-Settings-Check for Updates (or by right clicking on SAMMI tray icon and selecting Check for Updates).
In the Update menu, you can see whether you’re on the latest Bridge version and update it if you wish. All your extensions will be automatically transferred over if you update your Bridge this way.

If you want to get another clean copy of a Bridge (for example if you want to experiment with creating extensions), you can find the latest version at our Github repository.

How to run Bridge #

  • As a dock in OBS
    This is the simplest and most effective way. You can create a dock by clicking on View-Docks-Custom Browser Docks and fill in the path to the file. Click on apply and place the dock wherever it suits you in OBS. You will need to keep the dock open at all times.

    Bridge Dock in OBS
    Bridge Dock in OBS
  • As a browser source in OBS.
    This is highly discouraged as it is easy to lose track of it and accidentally get two Bridges running at the same time.
  • In your browser (such as Chrome) outside of OBS. This might be needed for some extensions or debugging purposes.

Connection Settings #

In your SAMMI Core-Settings menu, check Allow SAMMI Deck and Bridge to allow Bridge to connect.
In your Bridge-status tab, you can modify your connection settings.
Default IP address for SAMMI is and default port is 9425. Make sure this matches what’s in SAMMI Core-Settings.
You must fill out the password if you decided to use one in SAMMI Core-Settings menu.
Note that you only need to do this once, as your Bridge will remember the previous settings and will attempt to auto connect next time.

Bridge Connection Settings
Bridge Connection Settings

Connection Status #

You can see whether you’re connected to SAMMI and Twitch Pubsub within your Bridge. Green text ‘Connected’ or a green dot means the connection is alive.

Tabs #

Bridge has a few default tabs. A new tab is created every time you install a new extension.

  • Status
    • Bridge Connection - change connection settings to your SAMMI
    • Appearance - disable or enable tab appearance
    • Message Logging - intended for debugging purposes. Logs all messages for SAMMI and Twitch Pubsub. Will remember the state even after you close and reopen Bridge. Don’t forget to turn it off once you’re done debugging.
  • Twitch Triggers - test all your Twitch button triggers by pressing the test buttons. They simulate how Twitch sends all its events.