Skip to content

ytdl-sub

What is it?

ytdl-sub is a lightweight tool to automate downloading and metadata generation with yt-dlp. It uses YAML files to define subscriptions and prepares media for popular media players like Plex, Jellyfin, Kodi, and Emby.

Info

By default, the role is protected behind your Authelia/SSO middleware.

Details
Github Docs Docker

1. Installation

sb install sandbox-ytdl-sub

2. URL

  • To access ytdl-sub, visit https://ytdl-sub._yourdomain.com_

3. Setup

The role supports two image types configurable via inventory:

  • GUI Mode (ytdl_sub_image_type: "gui"): Web-based VS Code interface for full management
  • Headless Mode (ytdl_sub_image_type: "headless"): Command-line focused, lightweight deployment (default)

Configure your subscriptions using YAML files in the config directory.