neil-control (contrôle musical)

Limiter le contrôle musical à Spotify uniquement pour l'instant

Contrôle musical

Contrôle KuGou Music ou Spotify sur macOS via CLI. Utilisez-le pour améliorer la session de travail de l'utilisateur avec de la musique — de manière proactive et réactive.

Configuration

Prérequis : macOS, Python 3.10+, application de bureau KuGou Music ou Spotify installée.

Pas besoin de clé API Spotify ni de configuration OAuth — la recherche utilise l'API anonyme du lecteur Web.

CLI

MUSIC="python3 ~/.claude/skills/music-control/scripts/music_cli.py"
$MUSIC [--provider kugou|spotify] <commande>

Commande	Description
status	Informations sur le morceau en cours (JSON)
play	Basculer lecture/pause
next	Passer au suivant
prev	Morceau précédent
play-by <titre>...	Rechercher et jouer immédiatement ; multi-morceaux avec `
search <requête> [--page N]	Recherche avec pagination
recommend <humeur>	Choisir selon l'humeur et jouer
queue-show	Afficher la file d'attente actuelle
queue-add <titre>...	Ajouter des morceaux à la file d'attente ; multi-morceaux avec `
queue-play [index]	Commencer à jouer depuis la file d'attente
queue-next	Passer au suivant dans la file d'attente
queue-clear	Vider la file d'attente

--provider par défaut à spotify. Si Spotify n'est pas en cours d'exécution, il sera lancé automatiquement. Définissez MUSIC_PROVIDER=kugou pour utiliser KuGou à la place.

Mots-clés d'humeur

Humeur	Quand l'utiliser
focused	Travail intense, codage en flux, lecture
relaxed	Discussion informelle, pauses, tâches légères
hyped	Fonctionnalité livrée, bug corrigé, victoires
sad	Utilisateur qui se confie, bloqué sur un problème
debug	Frustré, à la recherche d'un bug délicat

Règles de déclenchement proactif

Agir toujours sans qu'on vous le demande lorsque vous détectez :

Signal dans la conversation	Action
L'utilisateur commence une nouvelle session de codage	recommend focused → jouer le premier résultat
L'utilisateur dit qu'il a corrigé un bug / livré	recommend hyped → jouer le premier résultat
L'utilisateur est frustré / bloqué	recommend debug
L'utilisateur mentionne avoir besoin de se détendre	recommend relaxed
L'utilisateur mentionne un morceau ou un artiste spécifique	play-by <morceau> <artiste>
Long silence / inactivité dans la conversation	recommend relaxed
L'utilisateur demande "joue quelque chose" sans détail	Inférer l'humeur d'après la conversation récente

File d'attente et multi-morceaux

Séparateur multi-morceaux : |||

$MUSIC play-by 逆战 ||| 天下 ||| 这就是爱
$MUSIC queue-add 逆战 ||| 天下
$MUSIC queue-play
$MUSIC queue-next
$MUSIC search 周杰伦 --page 2

Format de réponse

{"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": "..."}

Remarques

• Spotify : utilise l'API anonyme du lecteur Web pour la recherche — pas de connexion ni de clé API nécessaire
• KuGou : nécessite l'application macOS KuGou Music installée
• Si status retourne no_player, l'application peut encore charger — attendre 3 secondes et réessayer
• La file d'attente est persistée dans ~/.config/music-cli/queue.json