A Reddit bot which polls Twitch.tv streams and updates a subreddit's sidebar with their current statuses.

0. Have Python (v2 or v3) installed, along with the following libraries: 0. Requests

   1. PRAW
   2. configparser

1. Register your bot with Twitch at http://www.twitch.tv/kraken/oauth2/clients/new

2. Create a Reddit account for the bot, and make it a mod on the subreddit you want it to work on.

3. Clone this repository.

4. Copy config.sample.conf to config.conf.

5. Open up config.conf and fill in the required fields.

6. Add the following code snippet in your subreddit's sidebar where you want the stream list to be printed.

   [](#BOT_STREAMS)[](/BOT_STREAMS)
   

   These are empty links, so they won't show up on the page, but the bot will be able to see them and add text between them.

7. Run the bot as ./twitchbot. It will use a configuration file named config.conf by default, or you can run it as ./twitchbot other_config.conf to use

8. (Optional) Setup a crontab (or equivalent) to run the script as often as you want.

This bot outputs stream information according to a user specified format. The template value is printed for each active stream, with the following substitutions made:

Also, all Python escape sequences are supported in template, header, footer, separator, and no_streams.

All code is PEP8 compliant.