Settings - Lidarr YouTube Downloader

Automation

Scheduler Status

Enable automatic periodic checks for missing albums

Auto Download

Automatically download missing albums when found

Check Interval (Minutes)

How often to check for missing albums

Download Options

XML Metadata Files

Generate XML metadata files alongside audio files (useful for Lidarr integration)

AcoustID Fingerprinting

Fingerprint downloaded tracks and look up MusicBrainz recording IDs via AcoustID

AcoustID API Key

Get a free key at acoustid.org

Concurrent Track Downloads

Number of tracks downloaded simultaneously per album. Higher values speed up downloads but increase the risk of being rate-limited or banned by YouTube. Recommended: 2.

Audio Format

MP3 re-encodes to 320kbps. M4A and Opus preserve the original YouTube stream without transcoding (no generational loss).

YouTube Search Filters

Duration Tolerance (seconds)

Allowed difference between track duration and YouTube video length. Recommended: 5-15 seconds.

Minimum Match Score

Minimum YouTube match score (0.0–1.0) required to accept a track when AcoustID verification is unavailable. Recommended: 0.8.

yt-dlp Engine

yt-dlp

...

Telegram Notifications

Bot Token

Your Telegram Bot API token from @BotFather

Chat ID

The chat ID where notifications will be sent

Notification Filters

Choose which log types to receive via Telegram

🎵 Download Started ✅ Download Success / Partial ✅ Import Success / Partial ❌ Album Error

Discord Notifications

Webhook URL

Your Discord channel webhook URL (Server Settings > Integrations > Webhooks)

Notification Filters

Choose which events to receive via Discord

🎵 Download Started ✅ Download Success / Partial ✅ Import Success / Partial ❌ Album Error

Import / Export Configuration

Export Settings

Download your current configuration as a JSON file

Import Settings

Upload a previously exported config.json to restore settings

Environment Variables

⚠️ Note: Changes to these paths require an application restart to take full effect.