A directory of Twitch chat bot accounts.
This is the code used for twitchbots.info.
Thanks to Mini2 for the great base template.
The code in this repo is licensed under the MIT license.
Thanks to the following APIs, the service can try to curate the list as best as it can on its own:
- Twitch API
- 3v.fi Twitch Mod Check API
- FrankerFaceZ bots list
- BetterTTV channel bots list
See Configuration for details on required credentials for the respective APIs.
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).
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.
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.
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 💻 🐛 🚇 📖 💡 |
nD00rn 📖 |
Luis Muñiz 🎨 |
CBenni 🤔 |
---|
This project follows the all-contributors specification. Contributions of any kind welcome!