dustmop / rechat-dl

Simple python script to download Chat Replay messages from Twitch VODs

rechat-dl is a simple command-line tool to download the Chat Replay messages and metadata of Twitch VODs for archival purposes.

Installation

1. Clone the repository or download the zip
2. Install the requests library, if not yet installed: pip install requests

Notes

rechat-dl requires version 2.7+ of the Python interpreter. Its only dependency is requests.

Usage

rechat-dl.py VOD-ID [FILE]
	VOD-ID: can be found in the vod url like this:
	http://www.twitch.tv/streamername/v/{VOD-ID}

	FILE (optional): the file the chat messages will be saved into.
	if not set, it's rechat-{VOD-ID}.json

Output

The outputted .json file contains a json array, the first element of which is the VOD metadata (creation time, title, description, ...), followed by the Chat Replay messages. There's no documentation for the Chat Replay API yet, but its output is very similiar to the IRC interface.

This tool only downloads the chat messages, but doesn't offer a way to view them in real-time alongside a VOD.

---

This README file was loosely inspired by the bandcamp-dl readme, which was inspired by the youtube-dl readme. So likewise, I release this readme into the public domain. I mean, I guess??