yt-forager/README.md
2022-08-26 15:06:05 -04:00

1.2 KiB

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).