feat: terminal spotify client (ncmpcpp-style)

2026-09-06 08:08:56 +00:00
commit 352ed02871
12 changed files with 1673 additions and 0 deletions
@@ -0,0 +1,93 @@
+# spotify-cli
+
+Terminal-basierter Spotify Client im Stil von ncmpcpp.
+
+## Voraussetzungen
+
+- Python 3.8+
+- Spotify Free oder Premium Account
+- Spotify App in den [Spotify Developer Dashboard](https://developer.spotify.com/dashboard) angelegt
+
+## Setup
+
+### 1. Spotify App erstellen
+
+1. Gehe zu https://developer.spotify.com/dashboard
+2. Erstelle eine neue App
+3. Setze den Redirect URI auf `http://localhost:8888/callback`
+4. Kopiere die **Client ID**
+
+### 2. Installation
+
+```bash
+cd spotify-cli
+pip install -e .
+```
+
+Oder direkt:
+
+```bash
+pip install -r requirements.txt
+python -m spotify_cli.main
+```
+
+### 3. Einloggen
+
+```bash
+spotify-cli --login
+```
+
+Beim ersten Start wirst du nach deiner Client ID gefragt. Der Browser öffnet sich automatisch zur Spotify-Authentifizierung.
+
+## Benutzung
+
+```bash
+spotify-cli
+```
+
+### Tastenkombinationen
+
+| Taste | Aktion |
+|-------|--------|
+| `j`/`k` oder `↑`/`↓` | Navigieren |
+| `Enter` | Auswaehlen / Abspielen |
+| `Space` | Play / Pause |
+| `n` | Naechster Track |
+| `p` | Vorheriger Track |
+| `+`/`-` | Lautstaerke |
+| `r` | Repeat togglen |
+| `s` | Shuffle togglen |
+| `/` | Suche oeffnen |
+| `h` oder `Esc` | Zurueck |
+| `1`-`8` | Schnellauswahl (Nav) |
+| `L` | Library |
+| `q` | Beenden |
+
+### Views
+
+- **Home**: Kuerzlich gespielte Tracks
+- **Playlists**: Alle deine Playlists
+- **Liked Songs**: Deine gelikten Songs
+- **Recently Played**: Verlauf
+- **Library**: Liked Songs, Alben, Kuenstler
+- **Queue**: Warteschlange
+- **Devices**: Geraete wechseln
+- **Search**: Songs, Alben, Kuenstler, Playlists suchen
+
+## Config
+
+Config-Datei: `~/.config/spotify-cli/config.json`
+
+```json
+{
+  "client_id": "deine-client-id"
+}
+```
+
+Token wird in `~/.config/spotify-cli/token.json` gespeichert.
+
+## Logout
+
+```bash
+spotify-cli --logout
+```