CLI tool to find lost YouTube metadata, thumbnails, & videos via archive.org
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.
 
aria 605663bb9e
recover accidentally deleted packages
7 months ago
parsers fix spacing issues on videos 7 months ago
.gitignore first commit, no terminal usage beyond tests yet 7 months ago
LICENSE add license 7 months ago
README.md add more info to usage 7 months ago
cli.js now with extra cli in every bite! 7 months ago
lib.js now with extra cli in every bite! 7 months ago
package-lock.json recover accidentally deleted packages 7 months ago
package.json recover accidentally deleted packages 7 months ago
test.js first commit, no terminal usage beyond tests yet 7 months ago

README.md

yt-forager

CLI tool to find lost YouTube metadata, thumbnails, & videos via archive.org, the finest YouTube archive in the land.

install

git clone https://git.gay/a/yt-forager
cd yt-forager
npm i
npm link # sudo this on mac and linux

usage

Examples of using yt-forager:

videos

yt-forager https://www.youtube.com/watch?v=jNQXAC9IVRw 

# Scan of metadata at the the earliest possible date, checks if the video is still up on YouTube or not 
# in your jurisdiction. If not, it scans archive.org for a copy.

yt-forager https://www.youtube.com/watch?v=jNQXAC9IVRw -o me.at.the.zoo.json # Same scan, exports JSON to "me.at.the.zoo.json"

channels

yt-forager https://youtube.com/c/GibiASMR # Full scan of the channel

yt-forager https://youtube.com/c/GibiASMR -a # Partial scan of the channel (skips autofetching additional URLs)

yt-forager https://youtube.com/c/GibiASMR -o gibiasmr.json # Outputs JSON object given at the end to a file, rather than the console.

supported dates

Eras/designs supported:

  • 2014-2017 (+ certain 2018-2020 archives that had polymer disabled)

I plan to eventually support all major YouTube eras that are available on archive.org (including the current design).