Skip to content

Angrido/Lidarr-YouTube-Downloader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

135 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎵 Lidarr YouTube Downloader

Version Python Alpine Docker License

Bridge the gap between Lidarr and YouTube

Automatically download missing albums with perfect metadata tagging


✨ Features

  • 🔍 Auto-finds high-quality audio on YouTube (up to 320kbps)
  • 🏷️ Smart tagging with MusicBrainz + iTunes metadata
  • 📦 Direct import to your Lidarr library
  • 🌓 Modern UI with dark/light mode
  • 🎚️ Configurable filters - customize forbidden words
  • 🔔 Telegram and Discord notifications
  • 🐳 Docker ready - deploy in seconds

🚀 Quick Start

Docker Compose

services:
  lidarr-downloader:
    image: angrido/lidarr-downloader:latest
    container_name: lidarr-downloader
    ports:
      - "5005:5000"
    volumes:
      - ./config:/config
      - /DATA/Downloads:/DATA/Downloads
      - /DATA/Media/Music:/music
    environment:
      - LIDARR_URL=http://192.168.1.XXX:8686
      - LIDARR_API_KEY=your_api_key_here
      - DOWNLOAD_PATH=/DATA/Downloads
      - LIDARR_PATH=/music
    restart: unless-stopped

Access: http://localhost:5005


⚙️ Configuration

Required Settings

Variable Example Description
LIDARR_URL http://192.168.1.10:8686 Lidarr address (use IP)
LIDARR_API_KEY abc123... From Lidarr → Settings → General
DOWNLOAD_PATH /DATA/Downloads Download folder

Optional Settings

Variable Default Description
LIDARR_PATH - Final library path (optional)
SCHEDULER_ENABLED false Auto-check missing albums
SCHEDULER_INTERVAL 60 Check interval (minutes)

💡 All settings configurable via Web UI!

YouTube Cookies (Recommended)

YouTube may block downloads with a "Sign in to confirm you're not a bot" error. To fix this:

  1. Install a browser extension like "Get cookies.txt LOCALLY"
  2. Open an incognito/private window and log into a throwaway Google account on youtube.com
  3. Export cookies in Netscape format and save as cookies.txt
  4. Mount the file and set YT_COOKIES_FILE:
volumes:
  - ./cookies.txt:/cookies/cookies.txt
environment:
  - YT_COOKIES_FILE=/cookies/cookies.txt

⚠️ Do not use your main Google account — it may get flagged. Cookies expire periodically and will need re-exporting.

📸 Screenshots


⚠️ Disclaimer

This tool is for educational purposes and managing your personal library.
Users are responsible for complying with copyright laws and YouTube's ToS.


Star History Chart

Made with ❤️

About

Seamlessly bridge Lidarr and YouTube. Automatically fetch missing albums, download them as fully tagged MP3s, and trigger instant Lidarr imports to complete your music library.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors