🎵 MusicFetch

MusicFetch is a smart command-line utility that fetches music by querying Lidarr (a music collection manager) or, if no match is found or a timeout occurs, falls back to downloading using yt-dlp. It supports input in the form of either:

• "Artist - Track" (e.g. "Daft Punk - Harder Better Faster Stronger")
• A full YouTube URL (e.g. "https://www.youtube.com/watch?v=dQw4w9WgXcQ")

The downloaded track is organized into your Lidarr media folder or a YouTube subfolder if it's a fallback.

---

🚀 Features

• Searches for and adds artists to Lidarr.
• Automatically triggers album searches in Lidarr.
• Falls back to downloading via yt-dlp if no match is found.
• Supports metadata extraction from YouTube URLs.
• Handles Lidarr timeouts gracefully.

---

📦 Dependencies & Installation

🐍 Python Dependencies

• Python 3.6+
• requests

You can install the required Python packages using:

pip install requests

📼 External Tools

yt-dlp: YouTube downloader for audio/video.

Install via pip (recommended):

pip install -U yt-dlp

Or install system-wide:

sudo apt install yt-dlp  # On Debian/Ubuntu

⚙️ Configuration

Lidarr Setup

    Ensure Lidarr is running and accessible (e.g., http://localhost:8686).

    Create or retrieve your API key from Lidarr's settings.

Environment Variable
Set your API key in the terminal session:

export LIDARR_API_KEY="your-lidarr-api-key"

Or run inline:

    LIDARR_API_KEY="your-lidarr-api-key" ./musicfetch.py "Artist - Track"

🧑‍💻 Usage 🔉 Download by Search Term

./musicfetch.py "Artist - Track"

Example:

./musicfetch.py "ODESZA - Bloom"

If Lidarr finds the artist and album, it will trigger a download in Lidarr. If not, the song will be downloaded via yt-dlp using a YouTube search. 📺 Download by URL

./musicfetch.py "https://www.youtube.com/watch?v=xxxxxxxxxxx"

The script extracts metadata from the video and organizes the file under the artist's folder. 📁 Output Structure

Music is saved in:

/base_dir/
├── Artist Name/
│   ├── Album Name/   (if found via Lidarr)
│   └── youtube/      (if fallback used)

❓ Troubleshooting

No results from Lidarr -
Check to make sure your Lidarr installation is reachable and the artist exists or can be found in Lidarr's metadata sources.

yt-dlp errors -
Try updating it:

yt-dlp -U

Permission denied or file not found?
Ensure /media/music exists and is writable.

🛠️ Contributing

PRs are welcome, I only ask that you make the changes easy to follow. This script is designed to act as middleware, and not a replacement or plugin for Lidarr. The changes must also be compatible with Bash-based workflows.

📜 License

MIT – Use it freely and improve it as you wish!