{"id":13595657,"url":"https://github.com/xenova/chat-downloader","last_synced_at":"2025-10-09T11:36:13.034Z","repository":{"id":38830655,"uuid":"282085598","full_name":"xenova/chat-downloader","owner":"xenova","description":"A simple tool used to retrieve chat messages from livestreams, videos, clips and past broadcasts. No authentication needed!","archived":false,"fork":false,"pushed_at":"2024-07-23T00:42:32.000Z","size":4351,"stargazers_count":1063,"open_issues_count":59,"forks_count":146,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-09-25T16:43:14.029Z","etag":null,"topics":["chat","livestream","python","twitch","youtube","zoom"],"latest_commit_sha":null,"homepage":"https://chat-downloader.readthedocs.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xenova.png","metadata":{"files":{"readme":"README.rst","changelog":"HISTORY.rst","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"xenova","ko_fi":"xenova","custom":"https://www.buymeacoffee.com/xenova"}},"created_at":"2020-07-24T00:32:18.000Z","updated_at":"2025-09-25T10:28:34.000Z","dependencies_parsed_at":"2024-01-14T10:16:45.393Z","dependency_job_id":"25dd8285-5ff3-489f-be44-31e13141c0fd","html_url":"https://github.com/xenova/chat-downloader","commit_stats":null,"previous_names":["xenova/chat-replay-downloader"],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/xenova/chat-downloader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenova%2Fchat-downloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenova%2Fchat-downloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenova%2Fchat-downloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenova%2Fchat-downloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xenova","download_url":"https://codeload.github.com/xenova/chat-downloader/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenova%2Fchat-downloader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001304,"owners_count":26083058,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chat","livestream","python","twitch","youtube","zoom"],"created_at":"2024-08-01T16:01:54.759Z","updated_at":"2025-10-09T11:36:13.016Z","avatar_url":"https://github.com/xenova.png","language":"Python","funding_links":["https://github.com/sponsors/xenova","https://ko-fi.com/xenova","https://www.buymeacoffee.com/xenova"],"categories":["Python","Libraries","[](#table-of-contents) Table of contents"],"sub_categories":["Python","[](#universal)Universal"],"readme":"..\n    TODO\n    - temp move ... move back to root\n    - auto-generate using other rst files\n\n***************\nChat Downloader\n***************\n\n.. image:: https://img.shields.io/pypi/pyversions/chat-downloader\n   :target: https://pypi.org/project/chat-downloader\n   :alt: Python\n\n.. image:: https://img.shields.io/pypi/v/chat-downloader.svg\n   :target: https://pypi.org/project/chat-downloader\n   :alt: PyPI version\n\n.. image:: https://pepy.tech/badge/chat-downloader/month\n   :target: https://pypi.org/project/chat-downloader\n   :alt: Downloads\n\n.. image:: https://img.shields.io/github/license/xenova/chat-downloader\n  :target: https://github.com/xenova/chat-downloader/blob/master/LICENSE\n  :alt: License\n\n.. image:: https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fxenova%2Fchat-downloader%2Fmaster%2Fdocs%2F_dynamic%2Fcoverage.json\n  :target: https://pypi.org/project/chat-downloader\n  :alt: Coverage\n\n..\n    [![GitHub issues](https://img.shields.io/github/issues/xenova/chat-downloader)](https://badge.fury.io/py/chat-downloader)\n    [![GitHub forks](https://img.shields.io/github/forks/xenova/chat-downloader)](https://badge.fury.io/py/chat-downloader)\n    [![GitHub stars](https://img.shields.io/github/stars/xenova/chat-downloader)](https://badge.fury.io/py/chat-downloader)\n    [![Downloads](https://img.shields.io/github/downloads/xenova/chat-downloader/total.svg)](https://github.com/xenova/chat-downloader/releases)\n\n`Chat Downloader`_ is a simple tool used to retrieve chat messages from livestreams,\nvideos, clips and past broadcasts. No authentication needed!\n\n.. _Chat Downloader: https://github.com/xenova/chat-downloader\n\n############\nInstallation\n############\n\nThis tool is distributed on PyPI_ and can be installed with ``pip``:\n\n.. _PyPI: https://pypi.org/project/chat-downloader/\n\n.. code:: console\n\n   $ pip install chat-downloader\n\nTo update to the latest version, add the ``--upgrade`` flag to the above command.\n\nAlternatively, the tool can be installed with ``git``:\n\n.. code:: console\n\n   $ git clone https://github.com/xenova/chat-downloader.git\n   $ cd chat-downloader\n   $ python setup.py install\n\n\n#####\nUsage\n#####\n\n\nCommand line\n------------\n\n.. code:: console\n\n    usage: chat_downloader [-h] [--version] [--start_time START_TIME]\n                           [--end_time END_TIME]\n                           [--message_types MESSAGE_TYPES | --message_groups MESSAGE_GROUPS]\n                           [--max_attempts MAX_ATTEMPTS]\n                           [--retry_timeout RETRY_TIMEOUT]\n                           [--interruptible_retry [INTERRUPTIBLE_RETRY]]\n                           [--max_messages MAX_MESSAGES]\n                           [--inactivity_timeout INACTIVITY_TIMEOUT]\n                           [--timeout TIMEOUT] [--format FORMAT]\n                           [--format_file FORMAT_FILE] [--chat_type {live,top}]\n                           [--ignore IGNORE]\n                           [--message_receive_timeout MESSAGE_RECEIVE_TIMEOUT]\n                           [--buffer_size BUFFER_SIZE] [--output OUTPUT]\n                           [--overwrite [OVERWRITE]] [--sort_keys [SORT_KEYS]]\n                           [--indent INDENT] [--pause_on_debug | --exit_on_debug]\n                           [--logging {none,debug,info,warning,error,critical} | --testing | --verbose | --quiet]\n                           [--cookies COOKIES] [--proxy PROXY]\n                           url\n\n\nFor example, to save messages from a livestream to a JSON file, you can use:\n\n.. code:: console\n\n   $ chat_downloader https://www.youtube.com/watch?v=jfKfPfyJRdk --output chat.json\n\n\n\nFor a description of these options, as well as advanced command line use-cases and examples, consult the `Command Line Usage \u003chttps://chat-downloader.readthedocs.io/en/latest/cli.html#command-line-usage\u003e`_ page.\n\n\nPython\n------\n\n.. code:: python\n\n   from chat_downloader import ChatDownloader\n\n   url = 'https://www.youtube.com/watch?v=jfKfPfyJRdk'\n   chat = ChatDownloader().get_chat(url)       # create a generator\n   for message in chat:                        # iterate over messages\n       chat.print_formatted(message)           # print the formatted message\n\n\nFor advanced python use-cases and examples, consult the `Python Documentation \u003chttps://chat-downloader.readthedocs.io/en/latest/source/index.html#python-documentation\u003e`_.\n\n\n##########\nChat Items\n##########\n\nChat items/messages are parsed into JSON objects (a.k.a. dictionaries) and should follow a format similar to this:\n\n.. code-block::\n\n    {\n        ...\n        \"message_id\": \"xxxxxxxxxx\",\n        \"message\": \"actual message goes here\",\n        \"message_type\": \"text_message\",\n        \"timestamp\": 1613761152565924,\n        \"time_in_seconds\": 1234.56,\n        \"time_text\": \"20:34\",\n        \"author\": {\n            \"id\": \"UCxxxxxxxxxxxxxxxxxxxxxxx\",\n            \"name\": \"username_of_sender\",\n            \"images\": [\n                ...\n            ],\n            \"badges\": [\n                ...\n            ]\n        },\n        ...\n    }\n\n\nFor an extensive, documented list of included fields, consult the `Chat Item Fields \u003chttps://chat-downloader.readthedocs.io/en/latest/items.html#chat-item-fields\u003e`_ page.\n\n##########################\nFrequently Asked Questions\n##########################\n\n*Coming soon*\n\n######\nIssues\n######\n\nFound a bug or have a suggestion? File an issue `here`_. To assist the\ndevelopers in fixing the issue, please follow the issue template as\nclosely as possible.\n\n.. _here: https://github.com/xenova/chat-downloader/issues/new/choose\n\n\n############\nContributing\n############\n\nIf you would like to help improve the tool, you'll find more\ninformation on contributing in our `Contributing Guide \u003chttps://chat-downloader.readthedocs.io/en/latest/contributing.html#contributing-guide\u003e`_.\n\n\n################\nSupported sites:\n################\n\n-  YouTube.com - Livestreams, past broadcasts and premieres.\n-  Twitch.tv - Livestreams, past broadcasts and clips.\n-  Zoom.us - Past broadcasts\n-  Facebook.com (currently in development) - Livestreams and past\n   broadcasts.\n\n.. _Chat Item Wiki: https://github.com/xenova/chat-downloader/wiki/Item-Template\n.. _Command Line Wiki: https://github.com/xenova/chat-downloader/wiki/Command-Line-Usage\n.. _Python Wiki: https://github.com/xenova/chat-downloader/wiki/Python-Documentation\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxenova%2Fchat-downloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxenova%2Fchat-downloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxenova%2Fchat-downloader/lists"}