Turn Twitch chatter into Python events.

twitchobserver makes interacting with Twitch chat super easy. It is built and tuned for realtime applications. You can make chatbots chat. You can build Twitch Plays video games.

• Pure Python: No extra dependencies. Just plain and simple Python.
• Small API: With a few classes and a handful of methods, you can learn it over a coffee break.
• Event Based: Makes writing apps easy and straightforward.
• Context Manager: Further simplifies working with observers.

$ pip install twitchobserver

from twitchobserver import Observer

observer = Observer('Nick', 'oauth:abcdefghijklmnopqrstuvwxyz0123')
observer.start()
observer.join_channel('channel')
observer.send_message('Hello and goodbye', 'channel')
observer.leave_channel('channel')

API documentation can be found over on ReadtheDocs.org.

$ python -m unittest discover -s tests

Whenever a message is sent, echo it back. The Observer is created as a context manager object which will implicitly handle calling start() and stop().

import time
from twitchobserver import Observer

with Observer('Nick', 'oauth:abcdefghijklmnopqrstuvwxyz0123') as observer:
    observer.join_channel('channel')

    while True:
        try:
            for event in observer.get_events():
                if event.type == 'TWITCHCHATMESSAGE':
                    observer.send_message(event.message, event.channel)

            time.sleep(1)

        except KeyboardInterrupt:
            observer.leave_channel('channel')
            break

More examples can be found in the Cookbook.

Joshua Skelton	Felix Siebeneicker	Kovalchuk Evgeny

For a detailed history of changes made to the twitchobserver see the changelog.

MIT

See the license document for the full text.