# Spotify-Downloader Installation Guide

Diese Anleitung dient zur Installation und Einrichtung des Spotify-Downloaders auf einem Linux-System. Der Spotify-Downloader ermöglicht das Herunterladen von Musik für den persönlichen Gebrauch.

Spotify-Downloader nutzt der Spotify-API hierbei nur für die Metadaten (Titel, Album, Künstler, etc.) und lädt die Musik über YouTube herunter. Daher ist es notwendig, dass `ffmpeg` installiert ist, um die heruntergeladenen Dateien in das gewünschte Format zu konvertieren.

## 1. Paketübersicht
- `python3`: Die Programmiersprache Python, die für die Ausführung des Spotify-Downloaders erforderlich ist.
- `ffmpeg`: Ein Multimedia-Framework, das für die Verarbeitung von Audio- und Videodateien benötigt wird.
- `deno`: (optional) Ein modernes JavaScript/TypeScript-Laufzeitumgebung, die für bestimmte Funktionen des Spotify-Downloaders erforderlich ist.
- `pip`: Der Paketmanager für Python, der zur Installation von Python-Paketen verwendet wird.
- `pipx`: Ein Tool zum Installieren und Ausführen von Python-Anwendungen in isolierten Umgebungen.
- `spotdl`: Das Hauptpaket des Spotify-Downloaders, das die Funktionalität zum Herunterladen von Musik von Spotify bereitstellt.

## 2. System-Pakete installieren
Zuerst werden die benötigten Basis-Pakete über `pacman` installiert. Da CachyOS einiges bereits vorinstalliert hat, dient dies zur Absicherung.

```bash
sudo pacman -S python3 ffmpeg deno pip pipx
```

## 3. Pipx einrichten
Pipx ermöglicht die Installation von Python-Anwendungen in isolierten Umgebungen. Dies verhindert Konflikte zwischen verschiedenen Python-Paketen und erleichtert die Verwaltung von Anwendungen.

Zunächst teilen wir pipx mit, welcher Pfad für die installierten Anwendungen genutzt werden soll:

```bash
pipx ensurepath
```

## 4. Spotify-Downloader installieren
Nun installieren wir den Spotify-Downloader mit pipx:

```bash
pipx install spotdl
```

## 5. Spotify-Downloader verwenden
Nach der Installation kann der Spotify-Downloader über das Terminal verwendet werden. Um Musik von Spotify herunterzuladen, verwenden wir den folgenden Befehl:

```bash
spotdl <Spotify-URL>
```

*Hierbei die `<Spotify-URL>` durch die URL des gewünschten Spotify-Tracks, Albums oder Playlists ersetzen.*

## 6. Spotify-Downloader aktualisieren
Um den Spotify-Downloader auf die neueste Version zu aktualisieren, wird der folgende Befehl verwendet:

```bash
pipx upgrade spotdl
```

## 7. Troubleshooting
Falls Probleme bei der Installation oder Nutzung des Spotify-Downloaders auftreten, können die folgenden Schritte helfen:

### Explizites Angeben der Bitrate

```bash
spotdl --bitrate 192 <Spotify-URL>
```