archiving community contributions on YouTube: unpublished captions, title and description translations and caption credits
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
tech234a ede8c81927 Add shutdown notification and username sending 2 months ago
.gitignore Update gitignore 4 months ago
Dockerfile Added Dockerfile written by Fusl 4 months ago
README.md Add notice about project completion 2 months ago
config.json Allow specifying TRACKER_USERNAME in config.json 4 months ago
discovery.py Disable credit retrieval 3 months ago
export.py More robust rate limit check 3 months ago
requirements.txt Implement TRACKER_USERNAME support 4 months ago
tracker.py Update version 3 months ago
worker.py Add shutdown notification and username sending 2 months ago
youtube_channel.py youtube-util: Bug fix 3 months ago
youtube_util.py Update default API version 3 months ago

README.md

YouTube Community Contributions Archiving Worker

Discord

This project is now complete, and we are working on sorting and finalizing the data. Thank you to everyone who contributed!

Worker for the Save Community Captions project: Archiving unpublished YouTube community-contributions.

Lost? Click here to learn what this is all about!

Current Stats

See how much has been archived so far.

Setup

To run these tools you will need to supply session cookies (SSID,HSID,SID) see the tutorial for more details.

Primary Usage

Heroku️ (Minimal Setup! Minimal Maintenance!)

A wrapper repo for free and easy deployment and environment configuration, as well automatic updates every 24-27.6 hours is available. Deploy up to 5 instances of it to a free Heroku account (total max monthly runtime 550 hours) with no need for credit card verification by clicking the button below.

Deploy

Archiving Worker

After completing the above setup steps, simply run

python3 worker.py

Docker image

Stable Docker Image:

docker pull fusl/ytcc-archive

Run:

docker container run --restart=unless-stopped --network=host -d --tmpfs /grab/out --name=grab_ext-yt-communitycontribs -e HSID=XXX-e SID=XXX -e SSID=XXX -e TRACKER_USERNAME=Fusl -e PYTHONUNBUFFERED=1 fusl/ytcc-archive

Bonus Features

Export Captions and Titles/Descriptions Manually

This feature requires an older version of export.py. Get this file, Python 3, and the requests module (pip install requests). Then, simply run python3 exporter.py followed by a list of space-separated YouTube video IDs, and all community-contributed captioning and titles/descriptions in all languages will be exported.

Discover Videos Manually

Simply run python3 discovery.py followed by a list of space-separated YouTube video IDs and a list of discovered video, channel and playlist IDs will be printed, as well as whether caption contributions are enabled.