A simple tool used to retrieve chat messages from livestreams, videos, clips and past broadcasts. No authentication needed!
Project description
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.)
======= History
0.0.1 (2020-12-01)
- First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for chat_downloader-0.0.5-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a6a03eb8cd9a91d53b0a74ab727a1261aa66b365d421b7b11f9b87b8b740dc56 |
|
MD5 | 202a15f59f55fbab71a0f8e335cf7c7e |
|
BLAKE2b-256 | 59d3ade07b3949e3696c7671d8fef8cde314dc06e02989d95487cb41bf436414 |