plex-yt-dlp

Easy to use binary wrapper for using yt-dlp.

What it does

• This creates the Folder-Structures and also the File-Names exactly like it's needed for using in a Plex-Library.

• For Plex you have to use the YouTube-Agent alongside with the Absolute-Series-Scanner for your library to look beautiful.

Features

• Embeds Video metadata into the video itself
• Embeds the video thumbnail into the video
• Embeds thumbnail as music cover
• Downloads metadata as info.json for plex
• Downloads and embeds english and german subtitles if available
• This can also download RSS-Feeds -- use "rss" option for that

Requirements

Please install the following packages before using this script:

• yt-dlp
• ffmpeg
• curl
• rsync (Linux only)
• python3-mutagen

Pre-Setup

Config-File

Upon running the script for the first time you will be prompted with the message that a config.txt-File was created.

Config-File Example

NOTE: They can be relative paths to your binary or absolute paths

{
    "tempPath": "./temp",
    "musicPath": "./music",
    "rssPath": "./rss",
    "videoPath": "./video"
}

Why the temp path?

• The Temp-Path is where the files will be downloaded and also where the files will be modified
• If your other paths refer to a NAS-Drive for example this last step would be really slow
• The Files will get moved from temp to the final path after the converting process is finished

Usage

Just use ./plex-yt-dlp -h or ./plex-yt-dlp --help for the help screen.

This will print something like:

==========================================================================================================
==
== plex-yt-dlp [OPTIONS]
==
== -h, --help
==      Display this help screen
==
== -v, --version
==      Display current version
==
== -u, --url [urlHere]
==      Url to download
==
== -l, --links [pathToTxtFile]
==      File with URLs/Playlists to be download
==
== -t, --type [mediaType]
==      What output you want -- "video" or "music" or "rss"
==
== -r, --reverse
==      Reverse the order of the given playlist or rss feed
==
== -io, --indexOverwrite [num] -- optional
==      Overwrite the playlist index
==
== -ido, --idOverwrite [num] -- optional
==      Overwrite the auto ID
==
==========================================================================================================

Examples

# Download a video/playlist
./plex-yt-dlp -u urlHere -t video

# Download a single track or playlist
./plex-yt-dlp -u urlHere -t music

# Download a rss feed
./plex-yt-dlp -u urlHere -t rss

# Download a playlist starting from index 10
./plex-yt-dlp -u urlHere -t video -io 10

# Download a music playlist starting from index 10
./plex-yt-dlp -u urlHere -t music -io 10

# Download a rss feed starting from index 10
./plex-yt-dlp -u urlHere -t rss -io 10

Building yourself

Cloning the Repo and sub-modules

git clone https://github.com/SenpaiSimon/plex-yt-dlp.git
cd plex-yt-dlp
git submodule update --init --recursive

Install Build-Tools

sudo apt update
sudo apt install cmake build-essential libcurl4-openssl-dev -y

Building

Linux:

mkdir build
cd build
cmake ..
make

Windows:

mkdir build
cd build
cmake ..
cmake --build .