Lidarr YouTube Downloader

A free, open-source bridge between Lidarr and YouTube that fills the gaps in your self-hosted music library. Powered by yt-dlp, MusicBrainz, iTunes, and AcoustID, it searches YouTube for your missing albums, scores the best audio match, downloads it at up to 320 kbps, writes complete ID3 metadata with embedded artwork, and triggers a Lidarr import — all from a clean web UI that runs on any Docker host (NAS, Synology, Unraid, Raspberry Pi, VPS). Quick Start · Features · How It Works · Configuration · Screenshots · FAQ - 🔍 Smart YouTube matching — searches up to 15 candidates per track and scores them by title similarity, duration window, official-channel boost, and forbidden-word filtering (remix, live, cover, karaoke…) - 🎯 AcoustID fingerprinting — optional chromaprint verification rejects mismatched audio before import - 🏷️ Full metadata tagging — MP3 / M4A / Opus with MusicBrainz IDs, iTunes 3000×3000 cover art, year, track numbers, and optional XML sidecars for Lidarr re-import - 📦 Native Lidarr integration — copies tagged files into your Lidarr library path and triggers RefreshArtist; background paginated sync of wanted/missing for instant UI - 🔌 Lidarr download client — optionally registers in Lidarr as a Newznab indexer + SABnzbd download client, so Lidarr searches, grabs and imports automatically (see Use as a Lidarr download client) - ⚡ Parallel downloads — configurable concurrent tracks (1–5) with mid-download skip, per-track progress, speed, and ETA - 🚫 Banned URLs & candidate retries — per-track YouTube blacklist; tries up to 15 candidates before giving up - 📥 Manual YouTube URL & playlist import — paste any YouTube or YouTube Music URL (single track or full playlist) with album-art preview - 🎵 Audio streaming preview — listen to candidates and playlist items in the browser before queuing - ⏱️ Built-in scheduler — auto-discover and auto-download new missing albums at a configurable interval with per-run album limits - 🔔 Telegram & Discord notifications — per-channel filters for success, partial success, errors, and manual events - 🛠️ yt-dlp tuning UI — cookies file, player client, retries, sleep intervals, IPv4 force, one-click yt-dlp upgrade, loudness normalization, and automatic PO tokens via a bundled bgutil provider sidecar (fixes "Sign in to confirm you're not a bot") - 📊 Stats dashboard & logs — success rate, average match score, total downloaded size, per-album logs with retry - 🌓 Modern dark/light web UI — responsive design, drag-to-reorder queue, structured logs - 🐳 Docker-first — single container, Compose-ready, works on NAS, home server, Unraid, Synology, or any VPS Lidarr YouTube Downloader is the open-source project Angrido/Lidarr-YouTube-Downloader (https://github.com/Angrido/Lidarr-YouTube-Downloader) by Angrido, released under MIT. Ion packages it unmodified from commit 39766ae12dda, adding only a manifest, an icon and a start script.

Written by Angrido, published to Oikou by Ben Grande.

• ★ 76 stars on GitHub
• Licence: MIT
• Upstream version v1.9.2
• Built from commit 39766ae12dda

View the repository on GitHub

Not rated. Nobody has said who this app is suitable for, so Personal Clouds and the Oikou app treat it as 18+.

Internet

It asks to reach these hosts, and no others:

• cdnjs.cloudflare.com
• ntfy.sh
• acoustid.org
• img.youtube.com
• lrclib.net
• music.youtube.com
• musicbrainz.org

Folders on your Personal Cloud’s computer

• Can read and change files in a folder on your Personal Cloud’s computer that you choose: Your music library, where tagged albums are copied for Lidarr (the folder Lidarr watches) (music)

You choose each folder on your Personal Cloud, and whether it may only read it (the default) or also change it. It can send what it reads to the internet hosts above.

Personal Cloud tools

None. It uses nothing from your Personal Cloud beyond its own storage.

Notifications

It does not send push notifications.

Storage

Up to 512 MB on your Personal Cloud.

Keys it asks you for

You give each one on your Personal Cloud when you install it, or give it one of your Personal Cloud’s shared secrets of the same name. Oikou never sees them.

• Asks you for: lidarr-api-key — Your Lidarr API key (Lidarr > Settings > General) (optional)
• Asks you for: lidarr-url — Address of your Lidarr server, e.g. http://192.168.1.10:8686 (optional)

Its address

Works best with its own address. A Personal Cloud shared through Cloudflare can give it one; on a private Personal Cloud on Tailscale it opens under your Personal Cloud’s address, where it may not work fully. Private and shared Personal Clouds

Sign in to add this web app to a Personal Cloud of yours. It runs there, on your own computer, and you open it from there; nothing is installed on your phone.

Sign in to add