Beschränkt die Musiksteuerung vorerst auf Spotify
Musiksteuerung
Steuert KuGou Music oder Spotify auf macOS über die CLI. Verwenden Sie es, um die Arbeitssitzung des Benutzers mit Musik zu bereichern – proaktiv und reaktiv.
Einrichtung
Voraussetzungen: macOS, Python 3.10+, installierte Desktop-App von KuGou Music oder Spotify.
Es wird kein Spotify-API-Key oder OAuth-Setup benötigt – die Suche nutzt die anonyme Web Player API.
CLI
MUSIC="python3 ~/.claude/skills/music-control/scripts/music_cli.py"
$MUSIC [--provider kugou|spotify] <Befehl>
| Befehl | Beschreibung |
|---|---|
status | Aktuelle Titelinformationen (JSON) |
play | Wiedergabe starten/pausieren |
next | Zum nächsten Titel springen |
prev | Vorherigen Titel abspielen |
play-by <Titel>... | Suchen und sofort abspielen; mehrere Songs mit `( |
search <Abfrage> [--page N] | Suchen mit Seitenumblättern |
recommend <Stimmung> | Nach Stimmung auswählen und abspielen |
queue-show | Aktuelle Warteschlange anzeigen |
queue-add <Titel>... | Songs zur Warteschlange hinzufügen; mehrere Songs mit `( |
queue-play [Index] | Wiedergabe der Warteschlange starten |
queue-next | Zum nächsten in der Warteschlange springen |
queue-clear | Warteschlange leeren |
--provider standardmäßig auf spotify. Falls Spotify nicht läuft, wird es automatisch gestartet. Setzen Sie MUSIC_PROVIDER=kugou, um stattdessen KuGou zu verwenden.
Stimmungs-Keywords
| Stimmung | Wann verwenden |
|---|---|
focused | Tiefe Arbeit, Codieren im Flow, Lesen |
relaxed | Lockere Unterhaltung, Pausen, leichte Aufgaben |
hyped | Feature ausgeliefert, Bug behoben, Erfolge |
sad | Benutzer äußert Frust, festgefahren bei einem Problem |
debug | Frustriert, jagt einen kniffligen Bug |
Proaktive Auslöser-Regeln
Immer ohne Aufforderung handeln, wenn Sie Folgendes erkennen:
| Signal im Gespräch | Aktion |
|---|---|
| Benutzer beginnt eine neue Codier-Sitzung | recommend focused → Top-Ergebnis abspielen |
| Benutzer sagt, er hat einen Bug behoben / ausgeliefert | recommend hyped → Top-Ergebnis abspielen |
| Benutzer ist frustriert / festgefahren | recommend debug |
| Benutzer erwähnt, dass er entspannen muss | recommend relaxed |
| Benutzer erwähnt einen bestimmten Song oder Künstler | play-by <Song> <Künstler> |
| Lange Stille / Pause im Gespräch | recommend relaxed |
| Benutzer sagt „Spiel etwas“ ohne Details | Aus der letzten Gesprächsstimmung ableiten |
Warteschlange und mehrere Songs
Mehrere Songs trennen: |||
$MUSIC play-by 逆战 ||| 天下 ||| 这就是爱
$MUSIC queue-add 逆战 ||| 天下
$MUSIC queue-play
$MUSIC queue-next
$MUSIC search 周杰伦 --page 2
Antwortformat
{"ok": true, "title": "晴天", "artist": "周杰伦", "playing": true}
{"ok": true, "results": [{"title":"...", "artist":"...", "id":"..."}]}
{"ok": true, "action": "next"}
{"ok": true, "action": "queue_next", "current": 1, "has_next": true}
{"ok": false, "error": "no_player", "message": "..."}
Hinweise
- Spotify: Nutzt die anonyme Web Player API für die Suche – kein Login oder API-Key erforderlich
- KuGou: Erfordert die installierte macOS-App von KuGou Music
- Wenn
statusno_playerzurückgibt, lädt die App möglicherweise noch – 3s warten und erneut versuchen - Die Warteschlange wird in
~/.config/music-cli/queue.jsongespeichert