Chat Downloader

A simple tool used to retrieve chat messages from livestreams, videos, clips and past broadcasts. No authentication needed!

Installation

Install using pip

pip install chat-downloader

To update to the latest version, add the --upgrade flag to the above command.

Install using git

git clone https://github.com/xenova/chat-downloader.git
cd chat-downloader
python setup.py install

Usage

Chat items are parsed into JSON objects (a.k.a. dictionaries). For a comprehensive, documented list of included fields, consult the Chat Item Wiki.

Command line:

chat_downloader https://www.youtube.com/watch?v=5qap5aO4i9A

For advanced command line use-cases and examples, consult the Command Line Wiki.

Python:

from chat_downloader import ChatDownloader

url = 'https://www.youtube.com/watch?v=5qap5aO4i9A'
chat = ChatDownloader().get_chat(url)       # create a generator
for message in chat:                        # iterate over messages
    print(chat.format(message))             # print the formatted message

For advanced python use-cases and examples, consult the Python Wiki.

Issues

Found a bug or have a suggestion? File an issue here. To assist the developers in fixing the issue, please follow the issue template as closely as possible.

Contributing

If you want to contribute to chat-downloader, be sure to follow the contribution guidelines.

Supported sites:

• YouTube.com - Livestreams, past broadcasts and premieres.
• Twitch.tv - Livestreams, past broadcasts and clips.
• Facebook.com (currently in development) - Livestreams and past broadcasts.

TODO list:

• Finalise unit testing
• Improve documentation
• Add progress bar when duration is known
• Add support for streams by username (i.e. currently live)
• Websites to add:
  • facebook.com (in progress)
  • vimeo.com
  • dlive.tv
  • instagib.tv
  • dailymotion.com
  • reddit live
  • younow.com
• Add --statistics tag. This will show a summary of all chat messages retrieved (e.g. sum YouTube superchat, memberships, subscriptions, etc.)