Streamer.bot
Run your Streamer.bot actions from Fishrift events: a donation, a raid, a channel point reward or a bot command. Set it up under Integrations > Streamer.bot.
How it connects
Your Fishrift overlay inside OBS talks to Streamer.bot on the same computer. No ports to open, no tunnels.
- In Streamer.bot, open Servers/Clients > WebSocket Server, turn it on and note the port (8080 by default). Leave authentication off.
- On Fishrift's Streamer.bot page, turn the integration on and enter the host (
127.0.0.1) and port. - Keep a Fishrift overlay open in OBS. The status dot shows whether your overlay can reach Streamer.bot.
When several overlays are open, only one of them runs each action, so it fires once.
Mappings
A mapping connects Fishrift events to one Streamer.bot action.
- In Streamer.bot, right click the action and choose Copy Action Id.
- In Fishrift, make a mapping and paste the action ID (or type the action name).
- Add up to 10 triggers. The action runs once when any trigger matches.
Put mappings in groups. Switching a group off switches all its mappings off.
Events
Ko-fi donation, external donation, Ko-fi subscription, follow, subscribe, resub, gift sub, bits, raid, hype train begin, channel points, bot command, and any event.
Conditions
| Condition | Matches |
|---|---|
| Any | Always |
| Amount range | An amount between a minimum and maximum |
| Exact amount | One amount |
| Minimum amount | At least an amount |
| Reward | One channel point reward |
| Command | One bot command, without the ! |
Arguments
Your action gets these arguments. Use them in Streamer.bot as %user%, %amount% and so on.
| Argument | Contains |
|---|---|
user | The viewer's name |
amount | The amount, as text |
currency | Your currency |
message | The viewer's message |
event_type | The event, like bits or kofi_donation |
platform | twitch, kick, youtube, kofi or external |
reward_title | The channel point reward |
command | The bot command |
source | The name of an external donation site |
Testing
Each mapping has a Test button that sends a test follow from "FishriftTest", and Diagnose to check every step: matching, sending, whether an overlay is open and whether Streamer.bot is reachable.
Real test alerts from the editor don't fire Streamer.bot.