Chat Downloader

Open source

A Python command-line tool and library that retrieves chat messages from livestreams, videos, clips and past broadcasts on several streaming sites.

chat-downloader.readthedocs.io
Chat Downloader homepage screenshot
GitHub stars
1.2k
Last 30 days
+2(+0%)
Last commit
1 yr ago
Repository age
6 years
Version
v0.2.8
Licence
MIT
Self-hosted
Yes

About Chat Downloader

Chat Downloader fetches the chat that goes with a livestream, a video, a clip or a past broadcast. It needs no authentication, so you point it at a URL and it returns the messages. It can be run as a command-line program or imported into Python code, where it hands back a generator you loop over message by message.

Each message is parsed into a JSON object (a dictionary in Python) with fields such as the message text, its type, a timestamp, the time within the video and details about the author. The documentation lists every field on a separate page, and the command line offers many options for start and end times, message types, retries, output format, cookies and proxies.

It is distributed on PyPI and installs with pip, or it can be installed from a git clone. Supported sites are YouTube, Twitch and Zoom, with Facebook support still in development. The project is released under the MIT licence and documented on Read the Docs.

Key features

  • Retrieves chat from livestreams, videos, clips and past broadcasts
  • Needs no authentication
  • Installs from PyPI with pip
  • Saves a stream's chat to a JSON file
  • Messages arrive as parsed JSON objects
  • Python API for advanced use cases
  • Covers YouTube and Twitch broadcasts

Good fit for

  • Archiving a livestream's chat
  • Analysing chat messages in Python
  • Exporting chat to JSON
Built with
Python tools
Tags
chat
livestream
youtube
twitch
python
cli
json

Chat Downloader: questions and answers

What is Chat Downloader used for?
Chat Downloader is a Python command-line tool and library that retrieves chat messages from livestreams, videos, clips and past broadcasts on several streaming sites. It is a good fit for archiving a livestream's chat, analysing chat messages in Python and exporting chat to JSON.
Is Chat Downloader open source?
Yes. Chat Downloader is open source under the MIT licence. Its source code is on GitHub at xenova/chat-downloader and is written mainly in Python.
Is Chat Downloader free?
Yes. Chat Downloader is open source, so the software itself is free to use.
What are some alternatives to Chat Downloader?
Similar open-source tools in the Developer Tools category include App Store Connect CLI, TypeUI and Neovim. SaaS products in the same category include act101, Angular Material Blocks and Browserwire.
Is Chat Downloader actively maintained?
The most recent commit to Chat Downloader was on 5 November 2025, and the latest release is v0.2.8, published on 3 September 2023. The project has 1.2k stars on GitHub, with 2 added in the last 30 days.

Open-source alternatives to Chat Downloader

See all

SaaS alternatives to Chat Downloader

See all