22 lines
2.1 KiB
Markdown
22 lines
2.1 KiB
Markdown
# Lidarr YouTube Downloader
|
|
|
|
A free, open-source bridge between [Lidarr](https://lidarr.audio/) 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.
|
|
|
|
## Features
|
|
- Smart YouTube matching (title similarity, duration, official-channel boost, forbidden-word filtering)
|
|
- Optional AcoustID/chromaprint fingerprint verification before import
|
|
- Full ID3 / MP4 tagging with MusicBrainz IDs and iTunes cover art
|
|
- Can register inside Lidarr as a native download client (Newznab indexer + SABnzbd emulation) so Lidarr drives search/grab/import itself
|
|
- Built-in scheduler for auto-discovery of new missing albums
|
|
- Telegram & Discord notifications
|
|
- Manual YouTube URL / playlist import with audio preview
|
|
|
|
## Setup notes
|
|
1. After install, open the app and go to **Settings** to fine-tune audio format, concurrency, match threshold, scheduler and notifications.
|
|
2. **Lidarr URL** and **Lidarr API key** are required (find the API key in Lidarr → Settings → General → Security).
|
|
3. **Download folder** and **Music library folder** must be host paths reachable by both this app and your Lidarr container — ideally the exact same path Lidarr itself uses for its library, to avoid import path mismatches.
|
|
4. If YouTube returns "Sign in to confirm you're not a bot", export a `cookies.txt` (Netscape format, throwaway Google account) and drop it into this app's data folder under `cookies/cookies.txt` — it's already mounted and referenced automatically.
|
|
5. To use this app as a native Lidarr download client instead of just pushing files in, follow the "Use as a Lidarr download client" section in the [project README](https://github.com/Angrido/Lidarr-YouTube-Downloader#-use-as-a-lidarr-download-client).
|
|
|
|
**Disclaimer:** provided for personal, educational use to manage your own music library. You are responsible for complying with copyright law and YouTube's Terms of Service.
|