LidaTube
Finds and downloads missing Lidarr albums using yt-dlp to automatically fill music library gaps.
What is LidaTube?
LidaTube is a tool that automatically finds and downloads missing albums for your Lidarr music library using yt-dlp. It solves the problem of incomplete music collections by scanning Lidarr for gaps and fetching the audio files from online sources, then organizing them for proper library integration.
Users running Lidarr media servers who want to automate the process of filling missing albums in their music libraries without manual searching and downloading.
Developers choose LidaTube for its tight Lidarr integration, configurable automation, and reliable yt-dlp backend that handles various audio sources while supporting scheduled syncs and cookie-based access.
Overview
Find and download missing Lidarr albums via yt-dlp.
Use Cases
Best For
- Automatically completing missing albums in Lidarr libraries
- Reducing manual music collection management for media server users
- Scheduled background fetching of audio content via yt-dlp
- Self-hosted music automation alongside Docker-based media stacks
- Handling age-restricted or cookie-required audio sources
- Integrating custom download workflows with Lidarr's API
Not Ideal For
- Users who do not use Lidarr as their music management system
- Projects requiring video downloads or full multimedia content
- Environments with strict copyright compliance or licensing requirements
- Teams needing precise, real-time synchronization without scheduling delays
Pros & Cons
Pros
Directly connects to Lidarr's API to detect missing albums and optionally trigger library scans, automating the gap-filling process as shown in the environment variables like lidarr_address and library_scan_on_completion.
Uses yt-dlp for robust audio extraction from various online sources, with cookie support for accessing age-restricted or login-required content, enhancing download reliability.
Offers adjustable sync schedules, match ratios, and fallback search methods (e.g., secondary_search), allowing users to tailor the tool to their library's needs for improved accuracy.
Provides a Docker Compose setup and environment variables for easy containerization, simplifying installation and integration into existing media server stacks.
Cons
Defaults to mp3 codec with no mentioned alternatives in the README, which may not suit users preferring lossless formats like FLAC or AAC.
Has a deadband of up to 10 minutes for scheduled syncs, meaning operations might not start precisely at the set times, reducing predictability for time-sensitive updates.
Relies heavily on Lidarr's API and yt-dlp's functionality; failures in these services can halt downloads, adding points of failure outside the tool's control.
Requires setting multiple environment variables and managing cookie files for restricted access, which can be daunting for users unfamiliar with Docker or API integrations.
Frequently Asked Questions
Related Projects
MeTubeSelf-hosted video downloader for YouTube and other sites (web UI for yt-dlp)
SeerrOpen-source media request and discovery manager for Jellyfin, Plex, and Emby.
PinchflatYour next YouTube media manager
HeadphonesAutomatic music downloader for SABnzbd
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.