Viewer ratio bot

A bot written in python and made for my Twitch channel Twitch.tv/Ridgure.

Are you stuck streaming a category on twitch that is completely over saturated? Want to make use of the potential of the viewers that exist on Twitch? Then this is the bot for you. This bot checks how many viewers there are in a category and recommends if this category is good to stream or not.

Key Features • Getting started • Acknowledgements • Connect

Features:

Automated functions:

Done by the bot automatically:
Checks all the streamed games on Twitch
Checks all the streams for those games with the language English or other
Checks all the tags for those streams
Black/whitelist of streams
Black/whitelist of titles for all games or per game
Black/whitelist of tags
Filters out categories with drops
Filters out streams longer than 18 hours
Averages out the data over the course of a specified amount of time
Saves the data of the last 5 weekdays to a file depending on the time of day
Saves the data of the last 2 weekends to a file

Getting started

Clone

Clone this repository to your local machine using git clone https://github.com/Ridgure/ViewerRatioBot.git

Setup

In order to be able to run the bot add a file config.py in the same folder as the bot and go through the steps below: config.py should look something like this:

Host = "irc.twitch.tv"         # The Twitch IRC server
Port = 6667                    # Always use port 6667!
Nickname = "<Name>"            # Your Twitch username, lowercase
FollowerToken = "<Token>"      # Token generated by twitchapps.com/tmi without the oauth: part
SubscriberToken = "<Token>"    # Self generated token
Channel = "#<Channel>"         # The channel you want to join
ClientID = "<ClientID>"        # Your client ID

Create a Twitch account with the name of your bot
Register your application on the Twitch developer site
- Set the Name to the name of the account you just created
- Set the redirect uri to http://localhost
- Set the application directory to Chat Bot
- Agree to the terms and conditions
- Get a Client_ID and a Client_Secret
Generate your token for accessing follower data and chat
- Go to Get token here and click connect with twitch
- Click Authorize
- Your token should look something like this: oauth:a1b2c3d4e5f6g7h8i9j1k2l3m5n6o7
Generate your token for accessing subscriber data
- Go to the link underneath
- Remember to swap out <clientID> with your client id!
- Click Authenticate
- It will look like you got a blank page but your url should look like the second url
- Your access token is the gibberish where it says Token in the url

https://id.twitch.tv/oauth2/authorize?client_id=<clientID>&redirect_uri=http://localhost&response_type=token&scope=channel_subscriptions+user_read+channel_check_subscription+chat_login
http://localhost/#access_token=<Token>&scope=channel_subscriptions+user_read+channel_check_subscription+chat_login&token_type=bearer

Prerequisites

You will need to install these things to run the bot

Python 3.10.x
Libraries:
- Requests

Running the bot

Run bot.py by going to its location and running this command:

python ViewerRatioBot.py

Acknowledgements:

This whole project started off with this Instructables article

Other interesting projects to check out:

PythonBot by ZERG3R on Twitch as ZERG3R

Ponderier by DillonEA on Twitch as DillonEA

Xekeism by XekeDeath on Twitch as XekeDeath

Connect:

Twitch

See the bot in action when I am live on Twitch over at Twitch.tv/Ridgure

Social media

Please follow me on: Twitch, Facebook, Twitter and Instagram