lidarr-spotify-frontend/README.md

75 lines
1.8 KiB
Markdown
Raw Normal View History

# 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
```