You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
93 lines
4.3 KiB
Markdown
93 lines
4.3 KiB
Markdown
<h1 align="center">TheFrenchGhosty's Ultimate YouTube-DL Scripts Collection</h1>
|
|
|
|
<p align="center">The ultimate collection of scripts for YouTube-DL.</p>
|
|
|
|
<p align="center">🎉 Thanks for 1000 stars! 🎉</p>
|
|
|
|
Associated Reddit /r/Datahoarder post: [Here for 3.1.0](https://redd.it/lx3ccm) | [Here for 3.0.0](https://redd.it/llw7zq) | [Here for 2.0.0](https://redd.it/h7q4nz) | [Here for 1.0.0](https://redd.it/dwhvq6).
|
|
|
|
## Features:
|
|
|
|
- [Copylefted libre software](https://github.com/TheFrenchGhosty/TheFrenchGhostys-YouTube-DL-Archivist-Scripts) (AGPLv3+ licensed)
|
|
- Download content in the best possible quality, better than every other software, period.
|
|
- Download all kind of content: channels, playlists and individual videos
|
|
- Download audio only content, in the best possible quality
|
|
- Content separated in two to be easier to archive
|
|
- Dedicated scripts to download videos destined to be watched and deleted on a PC
|
|
- Dedicated scripts to download videos destined to be watched and deleted on a Mobile device
|
|
- Easily expandable for users familiar with yt-dlp / youtube-dl
|
|
- [SponsorBlock](https://sponsor.ajay.app/) integration using [mpv_sponsorblock](https://github.com/po5/mpv_sponsorblock) by [@po5](https://github.com/po5)
|
|
- [Jellyfin](https://jellyfin.org/) integration using [Jellyfin YouTube Metadata Plugin](https://github.com/ankenyr/jellyfin-youtube-metadata-plugin) by [@ankenyr](https://github.com/ankenyr)
|
|
- No Contributor License Agreement
|
|
- No Code of Conduct
|
|
|
|
---
|
|
|
|
## Donate:
|
|
|
|
Liberapay: https://liberapay.com/TheFrenchGhosty
|
|
|
|
Bitcoin (BTC): [bc1qjpal63yc94jw03pnhu3vyfqv7djxsr0lmwe5jk](bitcoin:bc1qjpal63yc94jw03pnhu3vyfqv7djxsr0lmwe5jk)
|
|
|
|
Monero (XMR): [44yL1VNsRmvW3khxHAQvzr9mfyfkMLFmS5xo3EehkQRgcBSgAUcoqf4Cj9mTyCwEPm1Sif1Pqdbw5UoFCvNLNp6CET277J6](monero:44yL1VNsRmvW3khxHAQvzr9mfyfkMLFmS5xo3EehkQRgcBSgAUcoqf4Cj9mTyCwEPm1Sif1Pqdbw5UoFCvNLNp6CET277J6)
|
|
|
|
---
|
|
|
|
## Installation (Linux):
|
|
|
|
Install [yt-dlp](https://github.com/pukkandan/yt-dlp) and [ffmpeg](https://www.ffmpeg.org/) (optionally, install [atomicparsley](https://github.com/wez/atomicparsley), it's required for embedding thumbnails into m4a files).
|
|
|
|
Download the latest [release](https://github.com/TheFrenchGhosty/TheFrenchGhostys-YouTube-DL-Archivist-Scripts/releases) and follow the included ReadMe, do not use the `master` branch unless you are ready to re-download EVERYTHING.
|
|
|
|
---
|
|
|
|
## Installation (Windows):
|
|
|
|
The Windows version, while it existed, required [work|some work|a lot of work|] to maintain because it was [too complex|very buggy|caused hourly BSOD's], and was never extensively tested. Windows users need to use the scripts in WSL, Cygwin, Git Bash, or some other Linux-on-Windows environment that enables Bash functionality in Windows.
|
|
|
|
Installation using WSL (recommended): [Here](docs/WSL.md)
|
|
|
|
Installation using Cygwin, Git Bash or similar: [Here](docs/Cygwin-Git-Bash.md)
|
|
|
|
Downloaded videos will likely exceed Windows' 260-character path length limit and not be playable out of the box. You should read more about [paths](docs/About-Paths.md) to familiarize yourself with the issue, as well as some potential workarounds.
|
|
|
|
---
|
|
|
|
## Usage:
|
|
|
|
Create a folder where you want your videos downloaded in a drive where you have enough space available.
|
|
|
|
Put the folders `Archivist Scripts`, `Audio-Only Scripts` and `Watch Scripts` in the created folder (See the documentation to understand the differences).
|
|
|
|
Add content to a 'Source - XXXXXX.txt' file depending of what type of content you want to download (See the documentation to understand the differences).
|
|
|
|
Open a terminal in the folder of the script you want to use and run `./[SCRIPT].sh`.
|
|
|
|
Done.
|
|
|
|
---
|
|
|
|
# Documentation:
|
|
|
|
## Basics:
|
|
|
|
- Scripts Type (Archivist, Audio-Only, Watch...): [Here](docs/Scripts-Type.md)
|
|
|
|
- Content Type (Channels, Playlists, Unique...): [Here](docs/Content-Type.md)
|
|
|
|
## Advanced:
|
|
|
|
- SponsorBlock implementation: [Here](docs/SponsorBlock.md)
|
|
|
|
- Region Restriction: [Here](docs/Region-Restriction.md)
|
|
|
|
- Details: [Here](docs/Details.md)
|
|
|
|
---
|
|
|
|
## Contact:
|
|
|
|
If you want to get in touch with me, or other users of my projects, feel free to join the Matrix room of one of my other project [PussTheCat.org](https://pussthecat.org): [#pussthecat.org:pussthecat.org](https://matrix.to/#/#pussthecat.org:pussthecat.org).
|
|
|
|
If you want to contact me privately, see: https://pussthecat.org/about/.
|