A chat-controlled to do list overlay for Twitch.

Created by DamienPup for LadyWynter FantasyWriter. Inspired by liyunze-coding/Chat-Task-Tic-Overlay.

1. Latest changes
2. List of Commands
3. Settings Files
4. Install Instructions
   • Manually generating an oauth token

The latest changes since last time I pushed something to this repo:

• Improved the token generation script and released it as a windows .exe
• Less twitch permissions are now required
• Better error handing
• Fixed issues with the scrolling animation

• !task help (command): List commands. Optionally, get help on a command.
• !task credits: List bot credits.
• !task show <number>: Shows a task and it's status in chat.
• !task add <task>: Add a task to the list. Task can contain spaces.
• !task done <number>: Finish a task.
• !task remove <number>: Delete a task
• !task edit <number> <new-content>: Edit a task to contain different text.
• !task clear all: Clear all tasks
• !task clear done: Clear only fishised tasks.
• !task reload: Reload bot and overlay.
• !task reassign <number> (user): Reassign a task to a new user. If the user is not given, reassign to yourself.
• !task github: Display the bots github url.

By default everyone can use help, credits and github, add tasks, as well as finish (done), remove, and edit tasks they started. Mods can use clear, reassign, as well as finish (done), remove, and edit all tasks. Only the broadcaster can reload the bot. All of these permissions can be changed in settings.js.

• CLIENT_ID.txt:
  • Used by generate_token.py to generate an oauth token, and pretty much nothing else.
  • If you generate your token manually, this can still be a nice place to store a copy of your client id, so you don't need to login to the twitch dev console to get it.
• auth.js:
  • Holds login settings, including your oauth token, bot username, and channel name
• settings.js:
  • Holds the main settings for the overlay and bot
  • Includes the active task limit, scrolling settings, auto-delete settings, command names and alisies, command help messages, and command permissions.
• style_settings.css:
  • Holds the visual settings for the overlay.
  • Includes fonts, font sizes, and various color options.

1. Login to the Twitch Developer Console with your main or dedicated bot account.
2. Create an app.
   • Set the redirect URL to http://localhost:5000/auth
   • Set the type to Chat Bot
3. Paste the app's Client ID into CLIENT_ID.txt.
4. Run generate_token.py to generate an oauth token. (See below for manual token generation instuctions)
   • You will need Python install for this step. 3.6 or later is required, however 3.12 is recommended.
   • The releases tab (should) contain a pyinstaller build of this tool. To use it: download it, put it in the same directory as the script file, and run it. No promises it won't be blocked by your browser or AV.
5. Open auth.js. Fill out the target channel and bot username. Don't touch the OAUTH_TOKEN.
6. Add a Browser Source to OBS or Streamlabs (or whatever your using), check Local File and select index.html.

1. Copy this URL:

https://id.twitch.tv/oauth2/authorize
?client_id=CLIENT_ID_HERE
&redirect_uri=http://localhost:5000/auth
&response_type=token
&scope=chat:read+chat:edit+channel:read:redemptions+user:read:email

2. Replace CLIENT_ID_HERE with your apps Client ID.
3. Paste this url into a brower, authorize the app, and wait for the browser to time out.
4. Copy the access_token from the URL bar.
5. Open auth.js, and paste your token into the quotes on the first line, after OAUTH_TOKEN. It should look like this:

const OAUTH_TOKEN = "YOUR_TOKEN_HERE";