Welcome to twitch-bot

Twitch Chat bot with custom commands, TTS, sounds, rewards, API integrations and more!

✨ See it in action on Twitch

Welcome to our Twitch Bot!

This bot is intended for self-hosting streamers. Its adaptation for other channels is not covered in this project.

For Twitch API help, visit https://dev.twitch.tv/docs/.

This bot assumes users have programming experience. Please keep in mind that this project may not meet the needs of all users, but it does offer the ability to create a customized Twitch Bot.

We used Twitch's example at https://dev.twitch.tv/docs/irc/example-bot as a starting point. Thanks, Twitch!

Features

• Twitch chat overlay
  • Supports Twitch emotes and badges, 7TV emotes, BTTV emotes and modifiers, and FFZ emotes and modifiers
  • Customisable formatting, colours, and animations
• Custom commands
• Text-to-speech with custom voices from streamelements and TikTok
• Sound effects
• Spotify integration with song requests
• Spotify song overlay
• Twitch channel point rewards integration
• Interval commands (e.g. periodic messages)
• Twitch task overlay
• Discord webhook integration for announcing stream start
• OBS websocket integration
• Probably more!

Setup

View SETUP instructions

Configuration

View CONFIGURATION instructions

Start the bot

Client for Chat, Tasks and Spotify overlays:

cd client
npm start

Server:

cd server
npm start

Troubleshooting

Primarily, watch the console output for errors to troubleshoot issues.

For tokens that are saved in tokens.json (Twitch and Spotify), if you change your scope and there are already access_token and refresh_token present in the file, you should remove these token values. Once you have your new access code the program will retrieve a new access_token and refresh_token.

Contributing

Contributions, issues and feature requests are welcome!
Feel free to check the issues page.

License

This project is MIT licensed.