Twitch Extension

Introduction #

The official SAMMI Twitch Extension puts a panel on your Twitch channel that lets your viewers trigger your SAMMI buttons themselves.

You decide which buttons exist, what they are called, what they look like and how much Power each one requires. When a viewer presses one, SAMMI receives a trigger and runs whatever you built behind it - a sound, an overlay, a scene change, a whole automation chain.

Viewers can only press the buttons you configured. They cannot type anything, create their own buttons or send any other data to your SAMMI.

Requirements #

• SAMMI with a linked Twitch account
• SAMMI Bridge, connected to SAMMI
• The extension installed and activated on your Twitch channel

Bits unlocks are only available to channels that are eligible for Bits. Everything else works without them.

Connect SAMMI to the extension #

The extension talks to SAMMI through the SAMMI Bridge. There are two ways to open that connection.

Automatically (recommended)

1. In SAMMI open Settings - Connections.
2. Under Twitch Extension, turn Auto Connect on.
3. Save and close.

From now on the Bridge connects on its own whenever it starts.

Manually

1. Open the SAMMI Bridge.
2. On the Settings tab, find Twitch Extension WebSocket.
3. Press Toggle Connection. The status switches to Connected.

If SAMMI is not connected when a viewer presses a button, the redemption fails, the viewer is told so, and their Power is given back automatically.

What Power is #

Power is the value viewers use to press your buttons. It only exists inside the extension.

• Every viewer starts with 500 Power on your channel, free of charge.
• Power is per channel. Power unlocked on your channel cannot be used anywhere else.
• Power has no cash value. It cannot be paid out, transferred or traded.

Viewers who want more can unlock Power with Bits through the Power menu.

The base rate is 2.5 Power per Bit. Larger unlocks come with a bonus on top:

Bits spent in the extension are split by Twitch: 80% goes to you, 20% to the extension developer. Twitch sets that split for every Bits-enabled extension - it is the same for all of them and not something SAMMI chooses. The developer share covers the running costs behind all of this - servers, code signing certificates, domains - as well as SAMMI’s ongoing development.

Rules for your buttons #

Your buttons must follow the Bits Acceptable Use Policy, the Community Guidelines and the Terms of Service.

Fine - on-stream digital effects:

• Playing a sound or a sound alert
• Showing, hiding or animating an overlay
• Switching or changing an OBS scene, source or filter
• Changing your voice, your camera, your lights
• Starting a poll, a wheel spin or a minigame on stream

Not allowed:

What happens if a button breaks the rules

1. The button is removed from your channel. It disappears for viewers, can no longer be triggered, and cannot be saved again - not even under a different name, if it is the same button in disguise.
2. You receive a notice in the extension that you have to confirm before you can change your configuration again.
3. Repeated cases mean losing the ability to add new buttons, then losing Bits in the extension, and finally losing access to the extension entirely.

Violations are reported to Twitch.

Create your buttons #

1. On Twitch, go to Creator Dashboard - Extensions - My Extensions and open the extension’s Configure page.
2. Stay on the Twitch View tab. This is the panel exactly as your viewers see it, with editing controls added.
3. Press the + tile to add a button.
4. Press the pencil icon on a button to edit it.
5. Use the arrows on a button to move it left or right.

Your changes are saved to your channel as soon as you press Save - no need to restart anything.

JSON Editor #

The JSON Editor tab shows your whole configuration as text. It is useful for bulk edits, reordering many buttons at once, or copying a setup between channels.

It checks your JSON while you type and will tell you if something is wrong. Press Save Config when you are done.

The settings block holds the defaults for the whole panel:

{
  "buttons": [
    {
      "label": "🌳 Test",
      "amount": 150,
      "hoverDescription": "This is a small example",
      "fullDescription": "The longer text shown before confirming",
      "triggerName": "My Example Trigger",
      "style": { "background": "green", "color": "white" },
      "disabled": false
    }
  ],
  "settings": {
    "font": "Inter, sans-serif",
    "defaultButtonDesign": {
      "style": { "background": "blue", "color": "white" }
    }
  }
}

Receive the button in SAMMI #

1. Right click a button in SAMMI - Edit Triggers (or CTRL + double click).
2. Press + and choose Twitch Extension.
3. Put the Trigger Name from the extension into the Message field. It has to match exactly.
4. Press Save.

Use Trigger Pull Data inside the button to read who pressed it and what they pressed. All available values are listed under Integration Triggers.

Test without a viewer #

You do not need a real viewer to build your buttons. The SAMMI Bridge can send a test trigger.

1. Open the SAMMI Bridge and go to the Twitch Triggers tab.
2. Find Twitch Extension and press Show Options.
3. Fill in the fields and send the trigger.

No Power is taken from anyone and nothing is written to your redemption log - the test only sends the trigger to SAMMI.

Redemption Log #

The Redemption Log tab lists everything your viewers redeemed in the last 72 hours, newest first. Click a column header to sort.

Each entry has two actions:

• ▶ Replay sends the same trigger to SAMMI again. Useful when something went wrong on your side - an overlay did not load, SAMMI was restarting, a scene was missing. The viewer is not charged again.
• ✕ Cancel refunds the Power to the viewer and removes the entry. Use it when you could not deliver what the button promised.

SAMMI Pro #

SAMMI Pro removes the Power floor in the extension.

A button set to 0 Power can be pressed without any Power at all, which is handy for a free “say hi” interaction next to your paid ones. Without Pro, anything you set below 100 is raised to 100 when you save.

Troubleshooting #

Legal #

Viewers and broadcasters both have to accept these once before using the extension.

• End User License Agreement
• Privacy Policy