# jmbannon/ytdl-sub

Lightweight tool to automate downloading and metadata generation with yt-dlp

Repository: https://github.com/jmbannon/ytdl-sub
Canonical: https://ross.abutalabs.com/products/ytdl-sub
Homepage: https://ytdl-sub.readthedocs.io
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: emby, jellyfin, kodi, plex, yt-dlp, yt-dlp-wrapper, ytdl, youtube, lidarr, nfo, radarr, servarr, sonarr
Last push: 2026-08-26T03:04:20+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 100
- inputs: {"age_days": 1819, "days_push": 7, "days_rel": 7, "gap_med": 1.5, "n_releases_24m": 143}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2927, forks 104 (observed 2026-08-28T04:07:30.460917+00:00)

## What it is
A Python command-line tool that automates downloading media via yt-dlp and generates metadata and file structures for media servers like Plex, Jellyfin, Kodi, and Emby. Subscriptions are defined in YAML with prebuilt presets, and it can write proper music tags via the beets API.

## Use cases
- automatically download youtube channels as tv shows for plex
- download youtube subscriptions and generate nfo metadata for jellyfin
- archive soundcloud or bandcamp discographies with proper music tags
- schedule automated youtube downloads into a media server library
- prepare downloaded videos with correct folder structure for kodi
- wrap yt-dlp with presets for plex emby jellyfin

## When to choose
- you want hands-off, scheduled downloads from YouTube or other yt-dlp-supported sites
- you use Plex, Jellyfin, Kodi, or Emby and want files organized with metadata automatically
- you prefer declarative YAML subscriptions with prebuilt presets over manual yt-dlp commands

## When to avoid
- you need a GUI-based downloader rather than a CLI tool
- you only need occasional one-off video downloads without metadata organization
- you need a web interface or integration with *arr apps' download pipelines

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, workflow-automation, file-system
- domain: media, self-hosted, developer-tools
- platform: cli, python, cross-platform
- tags: yt-dlp, plex, jellyfin, kodi, emby, youtube-downloader, media-server, subscriptions, nfo-metadata, servarr, metadata, automation, docker, linux

## Member repositories
- jmbannon/ytdl-sub (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:30.460917+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:33:35.736303+00:00, confidence not recorded.
  - readme: https://github.com/jmbannon/ytdl-sub (fetched 2026-08-28T04:07:30.460917+00:00, sha 5bb23775d43c)
- Data as of 2026-08-30T08:39:29.467469+00:00.