ChatGodApp

This application combines a Twitch bot with a web interface to allow you to select specific chatters and have their messages read aloud using Text-to-Speech (TTS). The idea behind ChatGodApp was inspired by the popular Twitch Streamer Doug Doug. I have simply taken inspiration (and a tiny bit of css) from his original project and made a (in my opinion) more stable and feature-rich "copy" of his original project (note: aside from inspiration, all code was written by me and was not taken from his repo).

Features

• Web interface with 3 user slots
• Text-to-Speech for selected chatters
• Random user selection from active chatters
• Manual user selection

Setup

1. Create a .env file in the root directory using the .env.example as a template:

# Twitch credentials
TWITCH_CHANNEL=your_twitch_channel_name_here
TWITCH_ACCESS_TOKEN=your_access_token_here
TWITCH_REFRESH_TOKEN=your_refresh_token
TWITCH_CLIENT_ID=your_client_id_here
TWITCH_CLIENT_SECRET=your_client_secret_here

...

# Flask secret key (change this to something random)
FLASK_SECRET_KEY=your_secret_key_here

You can get a Twitch access token by:

• Going to https://twitchtokengenerator.com/, adding your own client_id and client_secret, checking the chat:read scope, and clicking generate token.
• You can get a client_id and secret at https://dev.twitch.tv/

2. Install dependencies:

pip install -r requirements.txt

3. Run the application:

python web_app.py

4. Open your browser and navigate to http://localhost:8080

How to Use

1. Have users type one of the following commands in your Twitch chat to register:

   • !player1 - Register for slot 1
   • !player2 - Register for slot 2
   • !player3 - Register for slot 3

2. In the web interface:

   • Click "Pick Random" to select a random registered user for a slot
   • Or enter a specific username in "Choose User"
   • Toggle TTS on/off using the checkboxes

3. When a selected user chats, their message will appear in the web interface and be read aloud.