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.

License

This project is released under the Unlicense.