45 lines
1.2 KiB
Markdown
45 lines
1.2 KiB
Markdown
# yt-forager
|
|
|
|
CLI tool to find lost YouTube metadata, thumbnails, & videos via `archive.org`, the finest YouTube archive in the land.
|
|
|
|
## install
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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). |