| .github | ||
| docs | ||
| scripts | ||
| LICENSE | ||
| README.md | ||
TheFrenchGhosty's Ultimate YouTube-DL Scripts Collection
The ultimate collection of scripts for YouTube-DL.
🎉 Thanks for 1000 stars! 🎉
Associated Reddit /r/Datahoarder post: Here for 3.0.0 | Here for 2.0.0 | Here for 1.0.0.
Features:
- Copylefted libre software (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 integration using mpv_sponsorblock by @po5
- Jellyfin integration using Jellyfin YouTube Metadata Plugin by @ankenyr
- No Contributor License Agreement
- No Code of Conduct
Donate:
Liberapay: https://liberapay.com/TheFrenchGhosty
Bitcoin (BTC): bc1qjpal63yc94jw03pnhu3vyfqv7djxsr0lmwe5jk
Monero (XMR): 44yL1VNsRmvW3khxHAQvzr9mfyfkMLFmS5xo3EehkQRgcBSgAUcoqf4Cj9mTyCwEPm1Sif1Pqdbw5UoFCvNLNp6CET277J6
Installation (Linux):
Install yt-dlp and ffmpeg (optionnally, install atomicparsley, it's required for embedding thumbnails into m4a files).
Download the latest release and follow the included ReadMe, do not use the master branch unless you are ready to re-download EVERYTHING.
Installation (Windows):
Installation using WSL (recommended):
TODO
Installation using Cygwin, Git Bash or similar;
Known Issues
- Windows has a hard limit of 260 characters for the filepath. This can cause issues with video downloading. It is recommended that you make your filepath as short as possible.
- If you are receiving a permission denied error when attempting to execute python, this thread may be helpful.
- yt-dlp must be named "yt-dlp.exe". This means if you down the x86 version, you will need to rename it or create a symlink.
Required Software
In order to run these scripts, the following software packages must be installed:
- Cygwin, Git Bash, or some other application that enables Bash functionality in Windows.
- Python 3
- yt-dlp - Make sure this is in your PATH.
- ffmpeg - Make sure this is in your PATH.
- atomicparsley (optional)
Configuration
First, make sure that all dependencies are installed and your PATH is configured properly by opening your Bash terminal of choice and executing the following:
python --versionyt-dlp --versionffmpeg --version
If all of the above commands execute correctly, download the latest release and follow the "Usage" section of this README.
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
-
Content Type (Channels, Playlists, Unique...): Here
Advanced:
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: #pussthecat.org:pussthecat.org.
If you want to contact me privately, see: https://pussthecat.org/about/.