# 🎵 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:

```bash
pip install requests
```
📼 External Tools

    yt-dlp: YouTube downloader for audio/video.

Install via pip (recommended):
```bash
pip install -U yt-dlp
```
Or install system-wide:
```bash
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:
```bash
    LIDARR_API_KEY="your-lidarr-api-key" ./musicfetch.py "Artist - Track"
```
🧑‍💻 Usage
🔉 Download by Search Term
```bash
./musicfetch.py "Artist - Track"
```
Example:
```bash
./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
```bash
./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?
    Make sure your Lidarr installation is reachable and the artist exists or can be found in 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 welcome! Just keep it simple and compatible with Bash-based workflows.
📜 License

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