Initial commit: Spotify to Lidarr frontend with Docker and Unraid script

README.md

@@ -0,0 +1,74 @@
+# Lidarr Spotify Frontend
+
+Web-Frontend, um Alben aus Spotify zu suchen und an Lidarr zu uebergeben.
+
+## Features
+
+- Albumsuche ueber Spotify API
+- Track-Auswahl pro Album
+- Uebergabe an Lidarr als Album-Download (MissingAlbumSearch)
+- Einstellung im Frontend: ueberfluessige Dateien nach Download loeschen (optional)
+- Docker-ready
+
+## Voraussetzungen
+
+- Spotify App mit `Client ID` und `Client Secret`
+- Laufendes Lidarr mit API-Key
+- In Lidarr existierender `Root Folder` (z. B. `/music`)
+
+## Konfiguration
+
+1. Beispiel kopieren:
+
+```bash
+cp .env.example .env
+```
+
+2. Werte in `.env` setzen.
+
+## Start mit Docker Compose
+
+```bash
+docker compose up --build -d
+```
+
+Danach erreichbar unter: [http://localhost:3000](http://localhost:3000)
+
+## Unraid: Build + Template automatisch aktualisieren/anlegen
+
+```bash
+chmod +x scripts/run-unraid.sh
+./scripts/run-unraid.sh
+```
+
+Optional mit eigenen Werten:
+
+```bash
+SPOTIFY_CLIENT_ID=xxx \
+SPOTIFY_CLIENT_SECRET=yyy \
+LIDARR_URL=http://192.168.1.50:8686 \
+LIDARR_API_KEY=zzz \
+LIDARR_ROOT_FOLDER=/music \
+IMAGE_REPO=ghcr.io/dein-user/lidarr-spotify-frontend \
+IMAGE_TAG=latest \
+./scripts/run-unraid.sh
+```
+
+Das Skript:
+
+- baut das Docker-Image
+- aktualisiert ein vorhandenes Unraid-Template unter `/boot/config/plugins/dockerMan/templates-user/`
+- legt das Template neu an, falls es noch nicht existiert
+
+## Wichtige Hinweise
+
+- Lidarr arbeitet artist-zentriert. Die App versucht den Artist zuerst anzulegen und danach das Album in Lidarr zu finden.
+- Track-Auswahl wird auf Lidarr-Tracknamen gemappt. Bei stark abweichenden Titeln kann die Zuordnung unvollstaendig sein.
+- Die Cleanup-Option versucht unselektierte Track-Dateien ueber die Lidarr API zu loeschen, falls diese bereits vorhanden sind.
+
+## Lokaler Start ohne Docker
+
+```bash
+npm install
+npm start
+```