Navigation Menu

Skip to content


Repository files navigation

Twitch Bot Directory

Build Status codecov

A directory of Twitch chat bot accounts.

This is the code used for

Thanks to Mini2 for the great base template.


The code in this repo is licensed under the MIT license.

Used APIs

Thanks to the following APIs, the service can try to curate the list as best as it can on its own:

See Configuration for details on required credentials for the respective APIs.

Set up


The SQL table layout is currently not public, but can be reverse-engineered from the code (look at the unit tests setup.php, or sometimes as a comment in the table wrapper class).

PHP Dependencies

To install all the dependencies get Composer and then run composer install or php composer.phar install, depending on how you installed it. This will then download all the deps and set them up.

Cron Job

It is recommended to set up a cron job that runs php Mini/console.php check every so often. The job removes any bots whose account has since been deleted on twitch. You can also split it out to make fewer API requests in one job.


There are two configurations: one is a config.php in a folder called "lib" in the root of the project and contains all configuration needed before the DB connection is established. Almost all values defined by it can be found in the index.php files.

Then there is the config table, which holds key/value pairs for configuration. You should manually set the following:

  • 28_URL: URL to crawl for ModBot.
  • checks_per_day: Number of bot pruning runs per day. Needs to be at least 1, recommended are at least one per hour.
  • client-ID: Twitch Client-ID
  • client-secret: Twitch client secret
  • 3v-ua: User Agent for the Mod Checker API
  • auth0_domain, auth0_redirectUrl, auth0_clientId, auth0_clientSecret: auth0 configuration



All TypeCrawlers currently rely on the type ID. This means your DeepBots have to have id 22, ModBots 28 and Pajbots 44. I hope to fix this in the future.

Run tests

After installing Composer you can run the unit tests:

php vendor/bin/phpunit --bootstrap vendor/autload.php test

You might want to customize the phpunit.xml to match the database credentials of your system. The unit tests expect a database called twitchbots.


Thanks goes to these wonderful people (emoji key):

Martin Giger

💻 🐛 🚇 📖 💡



Luis Muñiz




This project follows the all-contributors specification. Contributions of any kind welcome!