admiralbolt/TwitchIO

TwitchIO - An Async Bot/API wrapper for Twitch made in Python.

The only edits to this fork is adding a somewhat dumb api to allow stopping a bot / websocket client without CTRL-C. In my case I was listening in a separate thread and for some ungodly reason windows doesn't support pthread_kill so there was no way of actually killing the thread once it started since the KeyboardInterrupt exception was the only way.

Point is, there's now a stop() method on the Bot and the recv() call times out after 5 seconds.

An Asynchronous IRC/API Wrapper currently in Development for TwitchBots made in Python!

Documentation

Official Documentation: Click Here!

Support

For support using TwitchIO, please join the official support server on Discord.

Installation

The following commands are currently the valid ways of installing TwitchIO.

TwitchIO requires Python 3.6 or higher.

Windows

py -version -m pip install twitchio

Linux

python3 -m pip install twitchio

Getting Started

TwitchIO uses many endpoints which may require different tokens and IDs.

1. IRC endpoints which require an OAuth token.

   To get a token, log in to Twitch with the bot's account and visit: https://twitchapps.com/tmi/

2. HTTP endpoints which require a client ID.

   To be documented.

3. HTTP endpoints which require an OAuth token and certain scopes.

   To be documented.

All 3 endpoints may be used at the same time. Otherwise, you may choose to use any or some of the endpoints.

Currently, TwitchIO's development is at a phase which has emphasis on the IRC endpoint and creating a framework around it. Once this is implemented, the other 2 endpoints will be developed further.

A quick and easy bot example:

from twitchio.ext import commands


class Bot(commands.Bot):

    def __init__(self):
        super().__init__(irc_token='...', client_id='...', nick='...', prefix='!',
                         initial_channels=['...'])

    # Events don't need decorators when subclassed
    async def event_ready(self):
        print(f'Ready | {self.nick}')

    async def event_message(self, message):
        print(message.content)
        await self.handle_commands(message)

    # Commands use a different decorator
    @commands.command(name='test')
    async def my_command(self, ctx):
        await ctx.send(f'Hello {ctx.author.name}!')


bot = Bot()
bot.run()

Become a patron and help support TwitchIO's development <3.

All Twitch logos used are owned by Twitch.tv respectively. Use of the Twitch logos does not imply any affiliation with or endorsement by them.