BiBot - Bits to Actions

What is BiBot?

BiBot lets you map Twitch, YouTube and Kick events - bits, donations, subscriptions, raids and more - to specific actions in the app. For example, when a viewer sends 100 bits, the app can display an alert on the overlay, read a TTS message, or simulate a keyboard shortcut in another program.

Control bar

The bar at the top of the BiBot tab controls the behavior of the entire system:

• Disabled - BiBot does not react to any events
• Normal - actions are queued and execute one after another
• Gentle - like Normal, but every action's cooldown is doubled
• Chaos - actions trigger immediately, without checking cooldowns
• PANIC - instantly pauses and clears the queue; useful when something goes wrong on stream

The ⚙ (gear) icon on the right side of the bar opens BiBot settings, where you can set a global cooldown (minimum delay between any actions) and clear the queue.

Tabs

Below the control bar you will find the following tabs:

• Actions - list of event-to-action mappings; this is where you create new mappings
• Presets - groups of entries that can be triggered manually with a button, a chat command, or a keyboard shortcut
• Blacklist - list of users ignored by BiBot
• Statistics - activity summary
• Game Control - control a game using bits or other events (memory modification, scripts)
• Queue - real-time view of the currently executing and pending actions

Creating a mapping

In the Actions tab, click + New action. Form configuration:

• Name - internal name of the mapping (visible in the panel and statistics)
• Event type - what the action reacts to: Bits, Donation, Subscription, Gift Sub, Superchat, Raid, Follow
• Platform - All, Twitch, YouTube or Kick; restricts to a specific platform
• Amount match mode - Minimum (from X and above, optionally with an upper limit) or Exact (a specific amount)
• Min. amount - minimum event value; 0 = always
• Max. amount - optional upper limit (action fires only within a range, e.g. 100-499 bits)
• Cooldown - minimum delay between triggers of the same action (in seconds); 0 = none
• Actions - what happens when the condition is met; multiple actions can be added at once

Available action types

• Alert - display an alert on the overlay (image or video, sound, animated text)
• TTS - read a message using the text-to-speech engine; available variables: {username}, {amount}, {message}
• Keyboard shortcut - simulate a key press (e.g. to trigger an effect in another program); a specific target window can be specified
• Launch program - open an external application or script
• Chat message - send an automatic message to chat; available variables: {username}, {amount}, {message}
• Screen effect - trigger a visual effect on screen (flash, screen shake, vignette, jumpscare, wind mouse, mouse inversion); requires Screen Effects to be enabled in BiBot settings

Presets

A preset is a named group of entries, e.g. "Autumn effects set". Each entry can have an assigned action (sound, alert, keyboard shortcut), a chat command (e.g. !effect), or be triggered manually with a button in the panel. Presets are useful for quickly switching sets of effects without editing mappings.

Queue

The Queue tab shows in real time which action is currently executing and which actions are waiting. You can also clear the queue by clicking the button in the tab or in the settings (gear icon).

Example: alert for bits

You want the app to display an alert with sound when 200+ bits are sent:

1. Event type: Bits
2. Match mode: Minimum, Min. amount: 200
3. Click + Add action and choose Alert - configure the image and sound
4. Cooldown: 30 seconds - so it doesn't fire 10 times in a row

Order and priority

If multiple actions match a single event (e.g. you have actions for 100+ bits and 500+ bits), all matching actions will fire. Make sure the Max. amount ranges are set correctly if you want only one action to trigger.

Blacklist

In the Blacklist tab you can add usernames whose events BiBot will ignore. Useful for blocking bots or test accounts.

Statistics

The Statistics tab shows the total number of triggered actions, bits revenue, a ranking of the most frequently used actions, and peak activity hours (peak hours UTC).