BlokeBot

A self-hosted Twitch bot and dashboard for running channel tools on your own terms.

Help site | Open BlokeBot | Server owner guide

Inside BlokeBot

• One dashboard - switch between the Twitch channels you help manage.
• Commands - create replies, aliases, counters, cooldowns, and scheduled messages.
• Guessing games - run rounds, reward winners, and share leaderboards.
• Points and giveaways - manage balances, gambling, prizes, and public rankings.
• Clear status - see whether the bot is ready and what needs your attention.
• Your own copy - keep channel data and credentials under your control.

New to BlokeBot?

If someone has already set up BlokeBot for your channel, you do not need Docker or Nix.

1. Open the BlokeBot address they gave you.
2. Sign in with Twitch.
3. Choose your channel.
4. Follow the dashboard prompts to connect the bot and turn on the tools you want.

The BlokeBot help site walks through each step in plain language.

Run your own copy

Docker

docker build --file packaging/docker/blokebot.Dockerfile --tag blokebot .
docker run --rm --init --publish 8080:8080 --volume blokebot-data:/data blokebot

Nix

nix run github:alsi-lawr/BlokeBot#blokebot -- serve

Run the separate BlokeBot.Site help site for approachable setup guidance. The public help site includes the server owner guide for technical detail.

Twitch EventSub webhooks

When running the EventSub chat runtime, expose the webhook route at the public callback URL and keep its signing secret in your deployment secret store. The two settings are:

{
  "TwitchBot": {
    "EventSubWebhook": {
      "CallbackUri": "https://bot.example.com/eventsub/twitch",
      "Secret": "generate-a-random-printable-secret"
    }
  }
}

The callback must be HTTPS on port 443 in production. The secret must be 10–100 printable ASCII characters and must match the value registered with Twitch.

For everyday help, start with the BlokeBot user guide. The hosted bot is available at bot.blokebot.com.