Home

A neat Python script to download chat messages from past broadcasts.

Twitch Chat Downloader provides custom formatting that can be easily added by anyone to format Twitch messages and their output directory, without writing Python code. Special formats, such as subtitles, are available and configurable.

Arguments

All arguments are optional. You will be prompted for input if necessary.

Argument	Description
-h --help	List all commands with descriptions
-v --video	Video ID
-o --output	Output directory. Default: ./output
-f --format	Output format. Default: default
-q --quiet	Suppress console output
--verbose	Verbose logging
--init	Initialize script
--update	Update settings
--input	Read data from JSON file rather than the Twitch API
--client-id	Twitch client ID
--preview	Print chat lines
--timezone	Timezone name
--formats	List available formats
--version	Settings version

Examples

python app.py

python app.py -v 123456789

python app.py --format irc --input ./output/zarlach/v123456789.json

python app.py -v 123456789 --format all --timezone America/New_York --output ~/Downloads/Twitch

Notes

• Twitch Chat Downloader uses Twitch API v5, which is to be removed in 2019. Example responses from the Twitch API for video and comments are found in docs/examples.
• The Twitch API refers to Twitch messages as "comments", hence, the code does also refer to messages as comments.