Skip to content
The friendly Twitch chatbot! πŸ€–πŸ’¬
Python
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows
assets
tests
.gitignore
.pre-commit-config.yaml
LICENSE
README.md
app.py
bannable_words.txt
chat.py
config.py
emotes.py
emotes.txt
requirements.txt
responses.txt
utils.py

README.md

bobby


forthebadge
Python application contributions welcome Maintenance GitHub license

The friendly Twitch chatbot! πŸ€–πŸ’¬ Bobby helps you moderate your Twitch.tv chat! He saves every chat message in a easy to read log file πŸ“„, sends out messages periodically, responds to messages and commands πŸ“© as well as bans trolls and spammers! 🚫

Features

  • Write chatlogs to files
  • Logging every chat message (Read chat in your terminal emulator)
  • Respond to messages in chat
  • Respond to commands such as !roll
  • Timeout / Ban users in chat for foul language
  • Send messages periodically
  • Timeout spammers

Installation

Make sure to have Python3 installed on your machine.

Clone the repository and install packages.

git clone https://www.github.com/belmind/bobby
cd bobby
pip3 install -r requirements.txt

Open the file config.py and add your CHANNEL name and OATH key. If you don't already have a oath key you can get one from twitchapps.com/tmi.

Usage

python3 app.py -f name

Where name is the name of the output file. It's not necessary and defaults to %d-%m-%y.txt

Chat Responses

It's simple to edit the chat responses! Simply, open the file responses.txt and modify it!

!rank, Diamond IV (44 LP)
!highscore, My highscore is exactly 113 312 413 100!

NOTE that the values are being separated by a comma ,.

Bobby will then respond with the following format: @{user} {msg} in a few milliseconds.

Foul Language

There is a file named bannable_words.txt which you can fill out with words you would neve want to see in a chat room.

badword1
badword2
badword3

Bobby will instantly ban these users from chat. Make sure that you give the bot moderator privileges if you are running it from a seperate account.

Periodic Messages

The bot currently only sends out a specifc message once every 100 messages in chat. This can be found and changed in config.py.

Contributing

Pull requests are welcome. Please make sure to update tests as appropriate.

License

Bobby is open source software licensed as MIT.

You can’t perform that action at this time.