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.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 05025892b9da40a7cc295b5ad02b4686a5af44040cfcde1d57c83cca106022d2 |
|
MD5 | eb09dc2d34d7c6f3a7546903b4518a36 |
|
BLAKE2b-256 | 87a87292f353b39aa472e279e8cc7f238491a7be6de83ef41d1734cfd2907c0d |