Zibi-bot documentation
Last updated: 18 November 2026
1. What is Zibi-bot
Zibi-bot is a chat bot for Kick streamers. It answers commands in your chat, posts timed messages, gives viewers points and levels, and runs games, giveaways, polls, song requests and text-to-speech. It also gives you alerts and widgets to add to OBS.
You manage everything from a web panel. You sign in with Kick, so there is no extra password. Zibi-bot works only through Kick’s official API, and it is not affiliated with Kick.
2. Getting started
-
Sign in with Kick
Open the invite link an admin sent you, or click Add my channel on the sign-in page if it is shown. Approve Zibi-bot on Kick with your channel’s own account. This connects your channel and makes you its owner.
Later, click Sign in with Kick on the sign-in page to open the panel.
-
Make the bot a moderator
The panel opens on One last step. Until this is done, the bot stays silent in your chat.
- Copy the command shown,
/mod <bot name>, and send it in your Kick chat. - Click Verify. The bot writes a short message and checks that it has the moderator badge.
If it says the bot is not a moderator yet, wait a few seconds and try again. An admin can also approve the channel.
- Copy the command shown,
-
Connect to Kick, when asked
If the panel says the bot is not connected, click Connect to Kick and approve with the channel’s account. You may be asked again after an update that needs a new permission, such as
!purge. The Dashboard shows Kick: connected when all is well. -
Add the OBS sources
On the Alerts and Widgets pages, copy a widget’s address. In OBS, add a Browser source, paste the address, and set it to 1920 by 1080. For anything with sound (alerts, songs, TTS), tick Control audio via OBS.
Widget addresses contain your secret key. Do not show them on stream or share them.
Then try a few commands in your chat, such as !points or !dice. The Dashboard also has a simulator, so you can test without going live.
3. Commands
These tables are made from the bot’s code, so they match what the bot does. There are 95 built-in commands. The prefix is ! unless you change it. In Chat Bot, then Commands, then Default Commands, you can switch many of these features on or off.
In “Who can use it”, “and up” means higher roles can use it too. The order is: everyone, subscribers, VIPs, mods, the streamer. Mods and the streamer usually skip cooldowns and prices.
Points and levels
| Command | What it does | Example | Needs | Who can use it |
|---|---|---|---|---|
!level [user] | Shows a viewer’s level and XP. | !level | Always on | Everyone |
!watchtime [user] | Shows how long a viewer has watched. | !watchtime @viewer | Always on | Everyone |
!points [user] | Shows points, level and rank. | !points @viewer | Points | Everyone |
!top | The top 5 viewers by points. | !top | Points | Everyone |
!addpoints <user> <amount> | Adds points to a viewer. | !addpoints @viewer 500 | Points | Mods and the streamer |
!removepoints <user> <amount> | Takes points from a viewer. | !removepoints @viewer 100 | Points | Mods and the streamer |
!give <user> <amount> | Gives some of your points to another viewer. | !give @viewer 50 | Points, with giving on | Everyone |
!achievements [user] | Shows a viewer’s achievement tiers for chatting, watching, games won and points earned. | !achievements @viewer | Achievements | Everyone |
!leaderboard | Posts the link to the public leaderboard page. | !leaderboard | Public leaderboard, and a public URL | Everyone |
!xp [user] | Shows XP and how much is left to the next level. | !xp | Points and the !xp switch | Everyone |
Commands, counters and stream info
| Command | What it does | Example | Needs | Who can use it |
|---|---|---|---|---|
!docs | Posts the link to this documentation page. | !docs | On by default (Default commands), and a public URL | Everyone (can be changed) |
!editcounter <name> <number> | Sets the counter a command shows with {count}. | !editcounter deaths 5 | Always on | Mods and the streamer |
!title [new title] | Shows the stream title. Mods can change it. | !title Ranked grind | Always on | Everyone, mods to change it |
!game [category] | Shows the stream category. Mods can change it. | !game Just Chatting | Always on | Everyone, mods to change it |
!addcom <name> <response> | Adds a custom command from chat. | !addcom hello Hi {user}! | Always on | Mods and the streamer |
!editcom <name> <response> | Changes a custom command’s response. | !editcom hello Hey {user}! | Always on | Mods and the streamer |
!delcom <name> | Deletes a custom command. | !delcom hello | Always on | Mods and the streamer |
!cmds | Posts the link to the public commands page. | !cmds | Public commands page, and a public URL | Everyone |
!purge <number> | Deletes the last messages in chat, and the command itself. | !purge 15 | Purge | Mods and the streamer |
Giveaways, polls and predictions
| Command | What it does | Example | Needs | Who can use it |
|---|---|---|---|---|
!poll <question> | <a> | <b>, or !poll end | Starts or ends a chat poll. | !poll Next game? | Chess | Golf | Always on | Mods and the streamer |
!vote <number> | Votes in the running poll. | !vote 2 | A running poll | Everyone |
!predict <question> | <a> | <b>, then lock, win <n> or cancel | Runs a points prediction. | !predict Win this match? | Yes | No | Points | Mods and the streamer |
!bet <option> <points> | Bets points on an option of the running prediction. | !bet 1 100 | Points, and a running prediction | Everyone |
!giveaway start [word] | end | draw | reroll | clear | cancel | Runs a giveaway. Viewers enter by typing the entry word. Reroll draws a new winner, clear removes everyone who entered. | !giveaway start join | Always on | Mods and the streamer |
Points games
| Command | What it does | Example | Needs | Who can use it |
|---|---|---|---|---|
!slots <amount> | A slot machine. Three of a kind pays big. | !slots 100 | Points and Slots | Everyone |
!roulette <amount> <red | black | green> | Bets on a colour. Green pays the most. | !roulette 100 red | Points and Roulette | Everyone |
!duel @user <amount> | Challenges a viewer to a points duel. The winner takes the pot. | !duel @viewer 100 | Points and Duel | Everyone |
!accept | Accepts a duel. | !accept | Points and Duel | Everyone |
!decline | Turns down a duel. | !decline | Points and Duel | Everyone |
!gamble <amount | all | half> | A 50% chance to double the bet or lose it. | !gamble 100 | Points and Gamble | Everyone |
!raffle start [price] [max tickets] | draw | cancel | Runs a raffle with tickets bought with points. | !raffle start 100 5 | Raffle | Mods and the streamer |
!ticket [number] | Buys raffle tickets with points. | !ticket 3 | Raffle, and a running raffle | Everyone |
Viewer queue
| Command | What it does | Example | Needs | Who can use it |
|---|---|---|---|---|
!joinq | Joins the viewer queue. | !joinq | Always on | Everyone |
!leaveq | Leaves the queue. | !leaveq | Always on | Everyone |
!posq | Shows your place in the queue. | !posq | Always on | Everyone |
!queue | Lists who is in the queue. | !queue | Always on | Everyone |
!nextq | Calls the next viewer. | !nextq | Always on | Mods and the streamer |
!clearq | Empties the queue. | !clearq | Always on | Mods and the streamer |
!openq | Opens the queue. | !openq | Always on | Mods and the streamer |
!closeq | Closes the queue. | !closeq | Always on | Mods and the streamer |
Shop and stream rewards
| Command | What it does | Example | Needs | Who can use it |
|---|---|---|---|---|
!shop | Lists the items in the points shop. | !shop | Points and Shop | Everyone |
!buy <number> | Buys a shop item. The streamer sees it in the panel. | !buy 1 | Points and Shop | Everyone |
!rewards | Lists the stream rewards. | !rewards | Points and Stream rewards | Everyone |
!redeem <number> [text] | Spends points on a reward that plays on stream. The name can be changed. | !redeem 2 hello chat | Points and Stream rewards | Everyone (can be changed) |
Song requests
| Command | What it does | Example | Needs | Who can use it |
|---|---|---|---|---|
!sr <YouTube link> | Requests a song. | !sr https://youtu.be/dQw4w9WgXcQ | Song requests | Everyone (can be changed) |
!song | Shows the song playing now. | !song | Song requests | Everyone |
!songs | Shows the next songs in the queue. | !songs | Song requests | Everyone |
!wrongsong | Removes your last request. | !wrongsong | Song requests | Everyone |
!skip | Skips the current song. | !skip | Song requests | Mods and the streamer |
!skipsong | Skips the current song. | !skipsong | Song requests, with its switch on | Mods and the streamer |
!songpause | Pauses the music. | !songpause | Song requests, with its switch on | Mods and the streamer |
!songresume | Plays the music again. | !songresume | Song requests, with its switch on | Mods and the streamer |
!songvol <0-100> | Sets the music volume. | !songvol 40 | Song requests, with its switch on | Mods and the streamer |
BDuel
| Command | What it does | Example | Needs | Who can use it |
|---|---|---|---|---|
!bduel class <warrior | mage | rogue>, !bduel @user [bet], or !bduel | Makes your character, challenges a viewer, or fights a monster. Bets need Premium. | !bduel class mage | BDuel | Everyone (can be changed) |
!baccept | Accepts a BDuel challenge. | !baccept | BDuel | Everyone (can be changed) |
!bdecline | Turns down a BDuel challenge. | !bdecline | BDuel | Everyone |
!bbuy <number> | Buys BDuel gear with points. | !bbuy 2 | BDuel | Everyone (can be changed) |
!bshop <weapons | armor | pets> | Lists the BDuel shop. | !bshop weapons | BDuel | Everyone |
!bchar [user] | Shows a BDuel character. | !bchar | BDuel | Everyone |
!btop | The top BDuel fighters. | !btop | BDuel | Everyone |
Text-to-speech
| Command | What it does | Example | Needs | Who can use it |
|---|---|---|---|---|
!ttsvol <0-100> | Sets the TTS volume. | !ttsvol 60 | Chat TTS, with its switch on | Mods and the streamer |
!ttsskip | Skips the message being read. | !ttsskip | Chat TTS, with its switch on | Mods and the streamer |
!ttspause | Pauses TTS. | !ttspause | Chat TTS, with its switch on | Mods and the streamer |
!ttsresume | Starts TTS again. | !ttsresume | Chat TTS, with its switch on | Mods and the streamer |
!ttsclear | Empties the TTS queue. | !ttsclear | Chat TTS, with its switch on | Mods and the streamer |
!ttsgrant @user [5m|30m|1h|6h|24h|permanent] [free|eleven|all] | Gives a viewer TTS access for a while: their messages are read without the command (or with it, free). With eleven (or all) the time is for your ElevenLabs voice commands (or both). The name can be changed. | !ttsgrant @dana 30m | Chat TTS, with its switch on | Mods and the streamer |
!ttsrevoke @user | Takes a viewer's TTS access away, the free TTS and ElevenLabs. The name can be changed. | !ttsrevoke @dana | Chat TTS, with its switch on | Mods and the streamer |
!tts <text> | Reads your text aloud on stream. The name can be changed. | !tts hello everyone | Chat TTS, in command mode | Everyone (can be changed) |
On-stream tools
| Command | What it does | Example | Needs | Who can use it |
|---|---|---|---|---|
!battle | Shows the score of the streamer battle against another channel. | !battle | Streamer battle, and a battle running | Everyone |
!kd [reset | start] | Shows kills, deaths, K/D and the best streak. Mods can reset it, or show it again after !kdend. The name can be changed. | !kd | KD counter | Everyone |
!kill [n] | Adds a kill (or n kills; a negative number fixes a mistake) to the KD counter. | !kill 2 | KD counter | Mods and the streamer |
!death [n] | Adds a death to the KD counter and ends the kill streak. | !death | KD counter | Mods and the streamer |
!newround | Starts a new round or match on the KD counter. | !newround | KD counter | Mods and the streamer |
!roundwin | Counts a round won on the KD counter. | !roundwin | KD counter | Mods and the streamer |
!roundloss | Counts a round lost on the KD counter. | !roundloss | KD counter | Mods and the streamer |
!kdend | Stops the KD counter and hides it on stream; the numbers stay. !kd start shows it again. The name can be changed. | !kdend | KD counter | Mods and the streamer |
!placement <n> | Sets the last placement in a battle royale match on the KD counter. | !placement 3 | KD counter | Mods and the streamer |
!pin <text> or !pin @user | Pins a message, or a viewer’s last message, on stream. | !pin Giveaway at 9pm | Pinned message | Mods and the streamer (can be changed) |
!unpin | Clears the pinned message. | !unpin | Pinned message | Mods and the streamer (can be changed) |
!score <team> <+1 | -1 | number>, reset, names A B, label <text> | Changes the scoreboard on stream. The name can be changed. | !score red +1 | Scoreboard | Mods and the streamer |
!happyhour [minutes] | stop | Starts a subathon happy hour: subs, gifted subs and Kicks add more time for a while. Time added by hand is never multiplied. The name can be changed. | !happyhour 30 | Subathon timer (Premium) | Mods and the streamer |
!spin | Spins the Wheel of Fortune on stream. The name can be changed. | !spin | Wheel of Fortune | Everyone (can be changed) |
Chat games
| Command | What it does | Example | Needs | Who can use it |
|---|---|---|---|---|
!arena <boss [1-5 | random | HP] | tug | potato | combo | stop> | Starts a chat arena game: a boss fight (stars 1 to 5 set its HP), a tug of war, a hot potato or a chat combo. The name can be changed. | !arena boss 3 | Chat arena | Mods and the streamer |
!attack | Hits the arena boss, or adds a hit to the combo. Each viewer has a short cooldown. The arena can also take the word without the "!", or any message. | !attack | Chat arena, and a boss fight or a combo | Everyone |
!pass [@user] | Passes the hot potato to a viewer, or to someone random. | !pass @viewer | Chat arena, and a hot potato | Everyone |
!flip [heads | tails] [amount] | Flips a coin on stream. With a side and an amount it is a points bet, under the Gamble rules. | !flip heads 100 | Heads or tails | Mods and the streamer (can be changed) |
!coin [heads | tails] [amount] | The mods’ name for the coin flip: mods and the streamer can always flip with it. The name can be changed. | !coin | Heads or tails | Mods and the streamer |
!guess start <min-max> [seconds] | end | cancel | Starts a guess-the-number round. The closest guess wins. The name can be changed. | !guess start 1-100 | Guess the number | Mods and the streamer |
!g <number> | Guesses a number in the running round (a plain number in chat works too). One guess each unless the streamer allows more; hot/cold hints can say higher or lower. | !g 42 | Guess the number, and a running round | Everyone |
!guessgame [flag | city | draw | monster | famous], skip, stop | Starts the guessing game: a flag, a city photo, your drawing, a monster or a famous person on stream. Chat types the answer. The name can be changed. | !guessgame flag | Guessing game | Mods and the streamer |
!rate open [what] | close | reset | Opens a 1 to 5 chat rating; viewers vote with a number or a word. Close freezes the score. The name can be changed. | !rate open the new song | Chat rating | Mods and the streamer |
!trivia [category | stop] | Asks a trivia question, from one category if you name it. The first right answer in chat wins points. With multiple choice on, chat answers A to D. The name can be changed. | !trivia geography | Trivia | Mods and the streamer |
!addq <category> | <question> | <answer> [| other answer] [|| wrong | wrong | wrong] | Adds a trivia question to your own list, in a category. Wrong choices after "||" make it a multiple-choice question. The name can be changed. | !addq games | Which block do you mine for diamonds? | diamond ore | Trivia | Mods and the streamer |
!words [word] [minutes] | Starts words on stream: scrambled letters, and chat finds the hidden words for points. The name can be changed. | !words 3 | Words on stream | Mods and the streamer |
!wordsend | Ends the words round, and endless mode. | !wordsend | Words on stream | Mods and the streamer |
Starter commands
Every new channel starts with these custom commands. You can edit, switch off or delete them, and add your own in Chat Bot, then Commands, then My Commands. Your own commands can have a cooldown, a price in points, a role, aliases, or work as a keyword without the !.
| Command | What it does | Response it starts with | Who can use it |
|---|---|---|---|
!commands | Lists the commands everyone can use. | All the commands: {docs} | Everyone |
!discord | Posts your Discord invite. Off until you add your link. | Join our Discord: https://discord.gg/YOUR-LINK | Everyone |
!so | A shoutout with a link to another channel. With the Shoutout card widget, it also shows a card on stream. | Go follow {touser} https://kick.com/{touser} | Mods and the streamer |
!dice | Rolls a number from 1 to 6. | {user} rolled a {random:1-6} | Everyone |
!uptime | How long the stream has been live. | We have been live for {uptime} | Everyone |
!lurk | Tells chat you are lurking. | {user} is now lurking. Enjoy! | Everyone |
!love | A random love score between two viewers. | There is {random:0-100}% love between {user} and {touser} | Everyone |
4. Variables
Put variables in a command’s response, a timer or a thank-you message. The bot fills them in when it posts. Each one can be written as {name} or $(name).
| Variable | What it becomes | Example |
|---|---|---|
{sender} | The viewer who used the command (same as {user}). | {sender} becomes viewer |
{target} | The first word after the command, without @, or the sender (same as {touser}). | {target} becomes friend |
{level} | The sender’s level. | {level} becomes 7 |
{watchtime} | The sender’s watch time, in minutes. | {watchtime} becomes 340 |
{randomuser} | A random viewer who chatted in the last 15 minutes. | {randomuser} becomes someone |
{title} | The stream title. | {title} becomes Ranked grind |
{game} | The stream category. | {game} becomes Just Chatting |
{user} | The viewer who used the command. | {user} becomes viewer |
{touser} | The first word after the command, without @, or the sender. | {touser} becomes friend |
{args} | Everything typed after the command. | {args} becomes good luck today |
{count} | How many times the command was used, or its counter. | {count} becomes 12 |
{channel} | Your channel name. | {channel} becomes yourchannel |
{points} | The sender’s points. | {points} becomes 1520 |
{pointsname} | What your channel calls points. | {pointsname} becomes points |
{uptime} | How long you have been live. | {uptime} becomes 2 hours and 5 minutes |
{commandlist} | The commands everyone can use. | {commandlist} becomes !dice !uptime !points |
{docs} | The address of the public commands page (open to everyone, no sign-in). | {docs} becomes https://zibi-bot.com/docs |
{1} {2} ... | One word after the command, by its number. | !hug {1} gives the first word |
{random:1-100} | A random whole number between the two numbers. | {random:1-6} becomes 4 |
{pick:a|b|c} | One of the choices, at random. | {pick:yes|no|maybe} becomes maybe |
{urlfetch https://...} | The text a web address returns (the first 300 characters). The address must start with https://. | {urlfetch https://example.com/quote.txt} |
$(user), $(random 1-6) | Every variable can also be written in the $(name) style. | $(touser) is the same as {touser} |
Thank-you messages
The chat messages for follows, subs, gifted subs and Kicks can use {user}, plus {count} for gifted subs and {amount} for Kicks.
Widget texts
These widget settings have their own variables:
| Widget | Setting | Variables |
|---|---|---|
| Achievements | Chat announcement | {user} {track} {tier} {count} {unit} {points} {pointsName} |
| Alert box (rich) | Follow: text | {user} {count} {amount} |
| Alert box (rich) | Follow: variants (one per line) | {user} |
| Alert box (rich) | Sub: text | {user} {count} {amount} |
| Alert box (rich) | Sub: variants (one per line) | {user} |
| Alert box (rich) | Gift: text | {user} {count} {amount} |
| Alert box (rich) | Gift: variants (one per line) | {user} {count} |
| Alert box (rich) | Kicks: text | {user} {count} {amount} |
| Alert box (rich) | Kicks: variants (one per line) | {user} {amount} |
| Chat arena | Boss: start message | {boss} {hp} {command} {seconds} |
| Chat arena | Boss: beaten message | {boss} {user} {top} {pointsName} |
| Chat arena | Boss: got away message | {boss} {hp} |
| Chat arena | Tug: start message | {a} {b} {seconds} |
| Chat arena | Tug: win message | {team} {points} {pointsName} {count} |
| Chat arena | Potato: start message | {user} {command} |
| Chat arena | Potato: pass message | {from} {user} |
| Chat arena | Potato: blew up message | {user} {points} {pointsName} {passes} |
| Chat arena | Combo: start message | {command} {window} |
| Chat arena | Combo: end message | {combo} {count} {points} {pointsName} {best} |
| Streamer battle | Start message | {them} {minutes} {fuel} |
| Streamer battle | Score message | {me} {them} {myScore} {theirScore} |
| Streamer battle | End message | {me} {them} {myScore} {theirScore} {result} |
| Heads or tails | Result message | {side} {user} |
| Heads or tails | Bet won message | {side} {user} {amount} {balance} {pointsName} |
| Heads or tails | Bet lost message | {side} {user} {amount} {balance} {pointsName} |
| Emote combo | Announcement | {name} {count} |
| Discord: stream ended | Message | {channel} {title} {duration} {game} |
| Goals | Goal reached message | {title} {current} {target} |
| Guess the number | Start message | {min} {max} {command} {seconds} |
| Guess the number | Winner message | {number} {user} {guess} {points} {pointsName} {count} |
| Guess the number | Nobody guessed message | {number} |
| Guessing game | Round message | {mode} {seconds} {points} {pointsName} |
| Guessing game | Winner message | {user} {answer} {points} {pointsName} {place} |
| Guessing game | Nobody got it message | {answer} |
| Hype train | Level message | {level} |
| Hype train | End message | {level} {points} {top} |
| KD counter | Stats message | {kd} {kills} {deaths} {streak} {best} {rounds} {wins} {losses} {placement} {extra} |
| Event labels | Latest follower text | {user} |
| Event labels | Latest sub text | {user} |
| Event labels | Latest gifter text | {user} {count} |
| Event labels | Top Kicks text | {user} {amount} |
| Chat rating | Open message | {title} |
| Chat rating | Close message | {title} {average} {count} |
| Stream rewards | Rewards | {user} {text} |
| Scoreboard | Reply after a change | {teamA} {scoreA} {teamB} {scoreB} |
| Shoutout card | Heading | {user} |
| Subathon timer | Happy hour: start message | {minutes} {subs} {gifts} {kicks} |
| Trivia | Question message | {question} {seconds} {points} {pointsName} |
| Trivia | Winner message | {user} {answer} {points} {pointsName} |
| Trivia | Nobody got it message | {answer} |
| Viewer counter | Text | {viewers} |
| Wheel of Fortune | Result message | {user} {result} |
| Words on stream | Start message | {letters} {count} {minutes} |
| Words on stream | Word found message | {user} {word} {points} {pointsName} |
| Words on stream | End message | {found} {count} {winner} {score} {word} {pointsName} |
| !xp | Reply | {user} {xp} {next} {level} |
5. Widgets and OBS
Each widget is a page you add to OBS as a Browser source. Its address is /w/<name>?key=<your key>. Copy the full address from the widget’s card in the panel. Some widgets read extra options from the address, for example &goal=sub for the Goals widget.
The leaderboard and the commands list are public pages for your viewers, with no key. They need the bot to have a public address.
| Widget | Kind | What it does | Where | Plan |
|---|---|---|---|---|
| Alert box (rich) | Alerts | Alerts for follows, subs, gifts and Kicks with your own image, GIF or video, sound, animation, colors and text-to-speech. Add it as an OBS browser source and check “Control audio via OBS”. | OBS: /w/alerts?key=... | Free |
| Chat overlay | Chat widgets | Shows the live chat on stream, with Kick emotes, name colors and badges, and YouTube and TikTok chat when they are on. | OBS: /w/chat?key=... | Free |
| Emote combo | Chat widgets | When chat sends the same emote many times in a row, shows a growing combo counter. | OBS: /w/combo?key=... | Premium |
| On-screen emotes | Chat widgets | Every emote sent in chat floats, bounces or rains across the screen. | OBS: /w/emotes?key=... | Free |
| Pinned message | Chat widgets | Mods pin a message on stream with !pin <text> or !pin @user, and clear it with !unpin. | OBS: /w/pinned?key=... | Free |
| !xp | Commands | Shows a viewer’s XP and how much is left until the next level. | Panel and chat | Free |
| Import from Nightbot | Commands | Paste Nightbot’s commands (JSON export or “!name message” lines) and add them as Zibi-bot commands. | Panel and chat | Free |
| Public commands page | Commands | A public web page with all the chat commands and who can use them. !cmds posts its link. | Public page: /p/commandlist | Free |
| Purge | Commands | Mods delete the last chat messages with !purge <number>, e.g. !purge 15. | Panel and chat | Free |
| Achievements | Event widgets | Permanent milestones for chatting, watching, winning games and earning points, with a reward per tier. | OBS: /w/achievements?key=... | Free |
| Activity feed | Event widgets | The latest follows, subs, gifts and Kicks: a list on the panel (with a button to replay the last alert) and an OBS page. | OBS: /w/feed?key=... | Free |
| End credits | Event widgets | Rolls this stream’s followers, subs, gifters, Kicks senders and top chatters as scrolling credits. Show the page at the end of the stream. | OBS: /w/credits?key=... | Premium |
| Event labels | Event widgets | A text label for OBS. Add &show=follower, &show=sub, &show=gifter or &show=kicks to the page address to pick the label (one browser source per label). | OBS: /w/labels?key=... | Free |
| Hype meter | Event widgets | A live gauge of how busy chat is, compared with the channel’s usual pace. | OBS: /w/hypemeter?key=... | Free |
| KD counter | Event widgets | Kills, deaths, K/D, streaks, rounds or placements on stream, with presets for popular shooters. | OBS: /w/kd?key=... | Free |
| Shoutout card | Event widgets | When a mod writes !so @user, shows a “Go follow” card for that channel on stream. | OBS: /w/shoutout?key=... | Free |
| Sponsor banners | Event widgets | Rotating sponsor banners with an image and a line of text, each for its own number of seconds. | OBS: /w/sponsor?key=... | Free |
| Viewer counter | Event widgets | Shows how many people are watching right now (from Kick’s official API, updated every minute). | OBS: /w/viewers?key=... | Free |
| Goals | Goals | Follower, sub, Kicks and chat message goals with an animated progress bar. Add one browser source per goal and put &goal=follow, &goal=sub, &goal=kicks or &goal=chat at the end of the address. | OBS: /w/goals?key=... | Free |
| Hype train | Goals | Subs, gifted subs and Kicks that come in close together start a hype train with levels, a countdown and the top contributors. | OBS: /w/hypetrain?key=... | Premium |
| Scoreboard | Goals | Two teams and their scores on stream, changed by mod commands or the panel. | OBS: /w/scoreboard?key=... | Free |
| Streamer battle | Goals | A timed battle against another Zibi-bot channel, fuelled by Kicks, chat messages or both. | OBS: /w/battle?key=... | Free |
| Subathon timer | Goals | A big countdown that grows with every follow, sub, gifted sub and Kicks, with a happy hour that multiplies the time. Start it from this card; it keeps counting through a bot restart. | OBS: /w/subathon?key=... | Premium |
| Discord: stream ended | Integrations | Posts a message with the VOD link to Discord when the stream ends. | Panel and chat | Free |
| BDuel | Interactive | A chat RPG: viewers pick a class, buy gear with points and duel each other or monsters; the fight plays on stream. | OBS: /w/bduel?key=... | Free |
| Chat arena | Interactive | Chat games on stream: fight a boss together, a tug of war between two teams, or pass the hot potato. | OBS: /w/arena?key=... | Free |
| Chat rating | Interactive | Chat rates something from 1 to 5; the average and the vote count show on stream. | OBS: /w/rating?key=... | Free |
| Chat TTS | Interactive | Reads chat aloud on stream: viewers use !tts <text>, or every message is read. Add the page as an OBS browser source and check “Control audio via OBS”. | OBS: /w/tts?key=... | Free |
| Giveaway on screen | Interactive | Shows the running giveaway (!giveaway): how to enter, the number of entries and the winner reveal. | OBS: /w/giveaway?key=... | Free |
| Guess the number | Interactive | Viewers guess a hidden number in a range; the closest guess wins points. | OBS: /w/guess?key=... | Free |
| Guessing game | Interactive | Flags, cities, monsters, famous people or your own drawing on stream: chat guesses what it is. | OBS: /w/guessgame?key=... | Free |
| Heads or tails | Interactive | A coin flip on stream; viewers can bet points on heads or tails. | OBS: /w/coinflip?key=... | Free |
| Now playing | Interactive | An on-stream card with the song request playing now: cover, title, who asked for it, progress and the next song. | OBS: /w/nowplaying?key=... | Free |
| Poll on screen | Interactive | Shows the running chat poll (!poll) as live bars with percentages. | OBS: /w/poll?key=... | Free |
| Raffle | Interactive | Viewers buy raffle tickets with points; more tickets, more chances to win. | OBS: /w/raffle?key=... | Free |
| Trivia | Interactive | The bot asks a question; the first right answer in chat wins points. | OBS: /w/trivia?key=... | Free |
| Wheel of Fortune | Interactive | Viewers spin a wheel from chat; the wheel spins on stream and the bot announces the result. | OBS: /w/wheel?key=... | Free |
| Words on stream | Interactive | Scrambled letters on stream; chat finds the hidden words for points. English or Hebrew. | OBS: /w/words?key=... | Free |
| Zibi voice assistant | Interactive | The voice assistant on stream: an orb that opens when you talk to Zibi, shows the answer and says it out loud. | OBS: /w/zibi?key=... | Free |
| Public leaderboard | Loyalty | A public web page with the top viewers by points, level and watch time. !leaderboard posts its link. | Public page: /p/leaderboard | Free |
| Public shop page | Loyalty | A public page for viewers with your points shop and the points leaderboard: /shop/<channel>. Read-only, no sign-in. | Public page: /shop/<channel> | Free |
| Reset rankings | Loyalty | Sets every viewer’s levels (XP), watch time or message count back to zero, for a new season. | Panel and chat | Free |
| Stream rewards | Loyalty | Viewers spend points on rewards that play on stream: a sound, an image or GIF, text read aloud, or a message on screen. | OBS: /w/rewards?key=... | Free |
The OBS chat dock: Kick, YouTube and TikTok in one window
The chat dock is a small window inside OBS, next to your scenes. It shows your Kick chat together with YouTube and TikTok chat, marks each message with its platform, and lets you write to Kick (and YouTube) without leaving OBS. Viewers never see it: it is not part of your stream.
- Copy the address. In the panel, open Settings, find OBS chat dock and click Copy.
- Add it to OBS. In OBS: Docks menu, then Custom Browser Docks. Type a name such as
Chat, paste the address under URL and click Apply. Drag the new window wherever you like. - Write. Type in the box at the bottom and press Enter. Me writes as your own Kick account, Bot as the bot. Commands such as
!pollwork from the dock too. Hover a Kick message to reply to it or remove it.
Keep the address private. It can write in your chat. Never add it to a scene as a Browser source. If it leaks, click Make a new address in the same card: the old one stops working at once.
Add YouTube and TikTok chat
- TikTok: Settings, Chat platforms. Turn on TikTok chat, type your TikTok username without the @ and save. The dock shows your TikTok chat and gifts while you are live. TikTok is read only: TikTok has no way for apps to write in LIVE chat, so you still answer there from your phone or LIVE Studio.
- YouTube, reading: turn on YouTube chat and type your channel (
@handle) or the link to the stream. Nothing else is needed. YouTube chat arrives about 5 seconds late. - YouTube, writing: in the same card, click Connect YouTube and sign in with the Google account of your channel. A Kick / YouTube choice then appears next to Send in the dock: pick one or both. On YouTube you always write as your own account, up to 200 characters, and only while you are live.
- When a viewer on YouTube or TikTok uses a command, the bot answers in Kick chat as “@name (YouTube) ...” and on the chat overlay. Both can be turned off in the same card.
Zibi, the voice assistant (closed beta)
On channels in the beta, two buttons appear next to Send in the chat dock. Talk to Zibi in Hebrew or English, for example “Hey Zibi, open a giveaway with the word pizza” or “Zibi, start a poll: chess or golf”. Zibi answers out loud with what it will do. Nothing happens until you confirm: say “yes” (or “כן”), or click Confirm. Say “no” (or “לא”) to drop it.
- Hey Zibi (the sound-wave button): the mic stays open and Zibi wakes up when a sentence starts with “Zibi” or “Hey Zibi”. Say just “Hey Zibi” and it answers “Yes?” and listens to your next sentence. Everything else you say is checked on the bot and dropped; it never goes to Claude. The choice is remembered.
- Push to talk (the mic button): click, speak, and it sends when you stop talking. No “Zibi” needed.
- The Zibi overlay: Widgets, Zibi voice assistant. Add it to your scenes as a Browser source at 1920 × 1080. It stays invisible until you talk to Zibi; then it opens, shows the answer and the commands, says the answer on stream (viewers hear it), and closes again. Turn off “Zibi speaks on stream” to hear it only in the dock. Without the overlay, Zibi speaks in the dock.
- The mic in OBS: OBS blocks microphones in its browser windows unless it starts with
--enable-media-stream. Right-click your OBS shortcut, choose Properties, and add--enable-media-streamat the end of Target (after the closing quote). Start OBS from that shortcut. - What it can do: any command your channel has, with the same rules as typing it in chat as the streamer, and the panel’s buttons: the music (“put on some music”, “stop the music”, “next song”, “volume 40”) and the buttons on your widget cards (“start the flag game”). It never resets, deletes or wipes chat (
!purge). - Your Zibi settings: Settings, Zibi voice assistant (the channel owner only). Pick Zibi’s voice from the ElevenLabs voices (a woman’s or a man’s voice, with a sample to hear), and choose what Zibi may do: chat commands, music, points, and panel buttons.
- Fast and free for the common things: polls, giveaways, points, the music and the games are understood by the bot itself, at once. Only other requests go to Claude.
- Privacy: the recording goes to ElevenLabs to become text, and the text goes to Claude (Anthropic) to choose the commands. The bot does not keep the recording or the text. In Hey Zibi mode every sentence you say goes to ElevenLabs to be checked for “Zibi” (up to 4 hours a day). Up to 200 requests to Claude a day per channel.
- The beta is switched on per channel by a Zibi-bot admin.
Streaming to several platforms at once (multistream)
The bot reads each platform’s chat by your channel name, so it does not matter how you send your video. OBS sends to one platform on its own. To stream to Kick and TikTok (or YouTube) at the same time:
- The Multiple RTMP outputs plugin (free, open source, by SoraYuki). Your main platform goes out through Start Streaming as usual, and the plugin sends the same video to the others.
Installing the plugin (Windows):
- Close OBS.
- Open the plugin’s releases page on GitHub: github.com/sorayuki/obs-multi-rtmp/releases.
- Under Assets, download the file that ends in
windows-x64-Installer.exeand run it. It finds your OBS folder by itself. (Portable OBS: download thewindows-x64.zipinstead and copy itsobs-pluginsanddatafolders into your OBS folder.) - Open OBS. A window called Multiple output appears. If you do not see it, open the Docks menu and tick it.
- In that window click Add new target. Give it a name (for example
TikTok), paste the platform’s server address and stream key, and click OK. - Click Start Streaming in OBS for your main platform, then Start next to each target in the Multiple output window. Each target can also be set to start with the main stream.
- TikTok needs a stream key to receive video from OBS, and TikTok gives one only to accounts allowed to go LIVE from a computer. Check in the TikTok app: tap +, then LIVE, and look for PC/Mac. Without a key, you can go LIVE from TikTok LIVE Studio and pick OBS Virtual Camera as its camera (in OBS, click Start Virtual Camera), or go LIVE from your phone.
- A restream service such as Restream is another way: OBS sends once to the service, and the service sends to each platform.
6. Alerts, media uploads and the live preview
The Alerts page sets what happens for each follow, sub, gifted sub and Kicks: an image, GIF or video, a sound, the text, colours, the animation and text-to-speech. Variants can change the alert by the number of gifted subs or Kicks, or pick one at random.
- Media uploads: upload images (PNG, JPG, GIF, WebP), videos (WebM, MP4) and sounds (MP3, OGG, WAV). Each file can be up to 10 MB. The Free plan holds 100 MB in all, Premium 500 MB. Files are checked by their content, not their name. A WebM video with a transparent background shows without a background.
- Only upload what you own or have a license to use on stream. See the terms.
- Live preview: the preview box next to the form shows the alert as you edit, before you save. Its sound is off until you click to play it.
- Test buttons send a test alert to OBS, so you can check the position and the sound.
7. Song requests and TTS
Song requests
Turn on Song Request in Interaction. Viewers request a YouTube video with !sr <link>. In Settings you can set the longest song, songs per viewer, a price in points, the lowest role and level, blocked viewers, and a playlist that plays when the queue is empty.
The music plays best in OBS: copy the player address from the Song Request page, add it as a Browser source, and tick Control audio via OBS. You can also play it in the panel with Play here, but only one player plays at a time. The optional Now playing widget shows the song on stream.
The bot asks YouTube only for a song’s title. Filters such as “music only” or “minimum views” are not available.
Text-to-speech
Turn on Chat TTS in Interaction. Viewers use !tts <text>, or the bot reads every message. You choose the command name, the voice, the lowest role, a price, filters for links, emotes and repeated letters, a character limit and a blacklist. Add the TTS widget to OBS and tick Control audio via OBS.
TTS uses the voices of the computer that runs OBS. Messages in Hebrew are read with a Hebrew voice.
ElevenLabs voices (your own account)
On the Integrations page, paste the API key of your own ElevenLabs account and click Test: your voices show up, cloned ones too, each with a sample. Make a voice command from any of them, such as !dani, and pick who can use it, a price in points, a cooldown and a character limit. A viewer types !dani hello everyone and it is read on stream in that voice, through the same Chat TTS page in OBS (Chat TTS must be on). It uses your ElevenLabs characters, so set the daily limits for the channel and for each viewer (5000 and 500 by default).
Mods give a viewer time with !ttsgrant @user 30m eleven, or all for the free TTS and ElevenLabs together; !ttsrevoke @user removes both. Kicks and the shop’s TTS time can also be for ElevenLabs. Your key is stored encrypted and only owners see the card. If ElevenLabs refuses the key or your account runs out of characters, the voice commands say so once and the free TTS keeps working.
8. Premium
Every channel starts on Free. Premium raises the limits and adds a few widgets and features. Payments are not live yet, so an admin gives Premium by hand for now. Rows marked “planned” are not available yet.
| Feature | Free | Premium |
|---|---|---|
| Bot name in chat | Zibi-bot | Custom (planned) |
| Custom commands | 100 | No limit |
| Keyword commands | 5 | 50 |
| Timers | 20 | 100 |
| Leaderboard size (public page) | 20 | 100 |
| Shop items | 6 | 150 |
| Stream rewards (!redeem) | 3 | No limit |
| Song request queue | 15 | 50 |
| Alert variants per type | 2 | 25 |
| Uploaded alert media (images, videos, sounds) | 100 MB | 500 MB |
| Chat TTS (browser voices) | Yes | Yes |
| Cloned voice TTS (ElevenLabs) | No | Yes (planned) |
| Discord go-live messages | 1 | 10 |
| Sponsor banners on stream | 2 | 20 |
| Saved polls (presets) | 2 | 50 |
| BDuel | Basic: classes, monster fights | Full: custom items, bets |
| Premium widgets (Hype Train, Subathon, End Credits, Emote Combo) | No | Yes |
| Beta features | No | Yes |
| Staff (moderators) | 3 | No limit |
“No limit” still has a safety cap: up to 50 staff and 50 stream rewards, and up to 60 custom BDuel items.
When Premium ends, nothing is deleted. The first items up to the Free limit keep working, and the rest wait until you go Premium again or remove some.
9. Staff
Your moderators can help from their own computer. On Sub-Users, add each person’s Kick username and tick the pages they may open. They sign in with their own Kick account and see only those pages, in your channel only. Settings and Sub-Users stay yours.
- Add owners on the same page. An owner has full access to the channel, like you.
- A sign-in lasts 7 days. You can see who is signed in, and sign one person or everyone out.
- Removing someone from the list signs them out at once.
- Every change staff make is written in the channel’s log.
- The Widgets and OBS pages show your secret widget key. Give them only to people you trust.
You are responsible for what your staff do in your panel.
10. Troubleshooting and FAQ
- The bot does not answer in chat.
- Check that the Dashboard says Kick: connected and that the mod check is done. The log on the Dashboard says if a message failed and why. A paused channel does not answer either.
- Verify says the bot is not a moderator.
- Send
/mod <bot name>in your own chat, with the exact name the panel shows, then click Verify again. - Alerts do not show in OBS.
- Check that the address in OBS is the full one from the panel, with its key. Use a test button on the Alerts page. If you see every alert twice, remove the older alert source from OBS.
- I cannot hear alerts, songs or TTS.
- In the Browser source settings, tick Control audio via OBS, then check the source’s slider in the OBS audio mixer.
- “Your Kick account is not the channel” when connecting.
- Connect must be approved with the channel’s own Kick account. Sign out of Kick in your browser, sign in with the channel account, and try again.
- “Has no channel on this bot” after signing in.
- Ask the streamer to add you on Sub-Users, or ask an admin for an invite link to add your own channel.
- A command says “Premium needed”, or an item is switched off.
- You are over a Free limit. Remove some items, or go Premium.
- Does Zibi-bot keep a log of my chat?
- No. It keeps the last 200 messages in memory for widgets, and they are gone when the bot restarts. See the privacy policy.
- Can viewers buy points?
- No. Points have no money value and cannot be bought, sold or cashed out.
- Does Zibi-bot moderate my chat?
- No. It never times out or bans anyone. The only message deleting is
!purge, which a mod types by hand.