TMoohI

About

TMoohI acts as a layer between your client applications and Twitch chat servers (Twitch Message Interface, "TMI").

It abstratcs the notion of the different chat clusters and manages all kinds of connections to all servers via a single client connection. Additionally, it handles rate limits, allowing bots to send an arbitrary amount of messages without being globally banned from twitch for 2 hours.

Additionally, it seeks to prevent excessive connection initiation (and therefore being kicked from twitchs servers) by keeping track of how many connections were created.

Features

• Connect to twitch chat in an instant, without having to worry about connect/join rate limits
• Restart your client without needing to reconnect to twitch, all channels are available instantly
• Connect, send and receive messages from all chat clusters (normal chat, event chat, group chat) from a single connection, without any effort
• IRCv3.0
• realtime online statistics and debug output via WebSockets
• Connection crash/death/reconnect detection and handling
• IRC Client compatible

How to use

Install python 3.4 (or compatible) with the required packages:

pip install -r requirements.txt

Then run with:

python TMoohI.py

To use a custom config.yaml, use

python TMoohI.py --config config.yaml

Connect the same way as you would for twitch. Ignore rate limits. Be happy.

In order to use the status page, you need to install bower, and in html/ run bower i If you changed the websocket port in the TMoohI config, or you are using a non-standard setup, set ws_url to the new host/port combo in html/TMoohIApp.js

License

TMoohI by CBenni is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License. Permissions beyond the scope of this license may be available at business@cbenni.com.