The ultimate collection of scripts for YouTube-DL.
🎉 Thanks for 1000 stars! 🎉
Associated Reddit /r/Datahoarder post: [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/) (optionnally, 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): ### 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](https://stackoverflow.com/questions/56974927/permission-denied-trying-to-run-python-on-windows-10) 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](https://www.cygwin.com/), [Git Bash](http://git-scm.com), or some other application that enables Bash functionality in Windows. * [Python 3](https://www.python.org/downloads/) * [yt-dlp](https://github.com/pukkandan/yt-dlp) - Make sure this is in your PATH. * [ffmpeg](https://www.ffmpeg.org/) - Make sure this is in your PATH. * [atomicparsley](https://github.com/wez/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 --version` * `yt-dlp --version` * `ffmpeg --version` If all of the above commands execute correctly, download the latest [release](https://github.com/TheFrenchGhosty/TheFrenchGhostys-YouTube-DL-Archivist-Scripts/releases) 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](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/.