Aide de nowplayingd

Premier lancement

Il faut macOS 26 ou plus récent. nowplayingd n'a pas d'icône dans le Dock : il vit dans la barre des menus, sous la forme d'un disque. Le disque est plein pendant l'écoute et vide à l'arrêt.

Au premier lancement, un assistant t'accompagne, un écran après l'autre :

1. Autorisations : ce que macOS va demander, et pourquoi. Le réseau local, pour trouver tes enceintes Sonos ; l'app Musique et Spotify, pour voir ce qui joue et piloter la lecture depuis le menu.
2. Enceintes : recherche des enceintes Sonos de ton réseau.
3. Comptes : Last.fm et ListenBrainz, tous deux optionnels.
4. Scrobble : optionnel, désactivé par défaut.
5. Sur ce Mac : Apple Intelligence pour les haïkus, langues de traduction.
6. Plein écran : le raccourci, et le passage automatique quand le Mac est inactif.

Tu peux le relancer à tout moment : Réglages → À propos → Relancer l'assistant de configuration…

Se connecter aux services

Dans Réglages → Comptes, ou dans l'assistant. Tous les comptes sont optionnels : avec des enceintes Sonos ou l'app Musique seules, nowplayingd marche déjà.

Last.fm

Last.fm donne à chaque utilisateur une clé d'API gratuite et personnelle. Tu crées la tienne une fois ; la tuile Last.fm te guide en trois étapes :

1. Ouvrir le formulaire Last.fm. Connecté à Last.fm, mets nowplayingd comme nom d'application (Application name), laisse les autres champs vides et valide.
2. Copie l'API key et le Shared secret affichés par Last.fm dans les deux champs.
3. Enregistrer et autoriser. La page d'autorisation de Last.fm s'ouvre dans ton navigateur : clique sur Yes, allow access, puis reviens dans nowplayingd. Ton nom apparaît avec une coche verte.

Tu ne tapes jamais ton mot de passe Last.fm dans nowplayingd. Ta clé, ton secret et la clé de session restent dans le trousseau de ton Mac. Déconnecter ferme la session ; Retirer efface aussi ta clé d'API. Tu peux aussi retirer l'accès sur last.fm (Settings → Applications).

ListenBrainz

1. Clique sur Se connecter : ta page de réglages ListenBrainz s'ouvre.
2. Copie ton User token.
3. Reviens dans nowplayingd et clique sur Coller. L'app vérifie le jeton et affiche ton nom.

Le jeton reste dans ton trousseau ; Ma clé d'API permet d'en changer ou de le retirer.

Mastodon et Bluesky

Seulement pour partager ce que tu écoutes. Voir Partager.

Enceintes Sonos

nowplayingd lit tes enceintes directement sur le réseau local : ni compte Sonos, ni cloud, ni app Sonos ouverte.

Pour que ça marche :

1. Le Mac et les enceintes sont sur le même réseau. Un réseau « invités », un VLAN séparé ou l'isolement des clients Wi-Fi empêchent de les voir.
2. Quand macOS demande si nowplayingd peut trouver des appareils sur le réseau local, réponds Autoriser. Si tu as refusé : Réglages Système → Confidentialité et sécurité → Réseau local → active nowplayingd.
3. Si ton app Sonos propose un réglage UPnP, il doit rester activé.
4. Si le pare-feu de macOS demande si nowplayingd peut accepter les connexions entrantes, réponds Autoriser : tes enceintes s'en servent pour signaler chaque changement aussitôt. En refusant, tout marche quand même, un peu moins vite (relève toutes les 2 s).

Pour vérifier : Réglages → Sources → Tester les enceintes. Quand tout va bien, ça ressemble à ceci :

ok  Bonjour : 9 enceintes dans 5 pièces.
ok  Port 1400 : les 9 enceintes répondent.
ok  Topologie : 4 groupes (Salon, Cuisine, Télé, Chambre).
ok  Salon : Massive Attack — Teardrop
--  Télé : joue la télé, ignoré.

Message	Que faire
Aucune enceinte trouvée	Vérifie les points 1 et 2 ci-dessus. Sinon, indique l'adresse IP d'une enceinte dans Adresse de secours (Réglages → Sources).
Aucune enceinte ne répond	Un pare-feu, un VLAN ou un réseau invités bloque : mets le Mac sur le réseau des enceintes.
Impossible de lire les groupes	Vérifie le réglage UPnP de l'app Sonos.
La radio demande Last.fm	Connecte Last.fm (voir plus haut) : c'est lui qui reconnaît les morceaux à la radio.

L'adresse IP d'une enceinte se trouve dans l'app Sonos (Réglages → Système → À propos de mon système) ou dans ton routeur.

Ce qui est affiché, et ce qui ne l'est pas

• Affiché : la musique en streaming lancée depuis l'app Sonos (Apple Music, Spotify, Tidal, Deezer, Qobuz…), ta bibliothèque, et la radio. À la radio, un morceau n'apparaît que s'il est reconnu, ce qui écarte pubs, jingles et émissions.
• Ignoré : l'entrée ligne (une platine vinyle, par exemple), AirPlay, Spotify Connect et la télé. Soit il n'y a rien à lire, soit l'app qui a lancé la musique la scrobble déjà.

Musique et Spotify sur ce Mac

Activé par défaut (Réglages → Sources). nowplayingd affiche ce que jouent l'app Musique et Spotify sur ce Mac, avec la sortie audio : AirPlay, Bluetooth, haut-parleurs du Mac…

• macOS demande une fois si nowplayingd peut piloter Musique et Spotify. Avec cette autorisation, il voit ce qui joue déjà au lancement, et les boutons lecture, pause et suivant du menu marchent. Sans elle, un morceau n'apparaît qu'au premier changement (lecture, pause, suivant).
• Quand l'app Musique envoie le son vers une enceinte AirPlay avec son propre bouton AirPlay, ce choix n'est pas visible pour les autres apps.
• Tidal, Deezer, Qobuz, YouTube Music : leurs apps ne sont pas lisibles depuis le Mac. Relie-les à Last.fm dans leurs propres réglages ; nowplayingd verra ces écoutes via ton compte.

Plein écran

• ⌥⌘N, ou « Plein écran » dans le menu. Échap ou un clic pour fermer.
• Grande pochette, artiste et album, haïku animé et, en bas, les coulisses : des cartes tirées au hasard de Wikipédia, Wikidata, Wikimedia Commons, Last.fm, MusicBrainz et du Cover Art Archive.
• Sur un grand écran (iMac, Studio Display), l'historique s'affiche en colonne à droite.

Dans Réglages → Plein écran :

• passage automatique après 2 à 30 minutes d'inactivité, éventuellement seulement pendant l'écoute ;
• tous les écrans, ou seulement l'écran principal ;
• Garder l'écran allumé et Empêcher l'économiseur d'écran : activés par défaut, ils ne jouent que pendant le plein écran. macOS compte l'inactivité une seule fois pour les deux : empêcher seulement l'économiseur repousse aussi la veille de l'écran ;
• les coulisses et le haïku peuvent être désactivés.

Paroles

Optionnelles, désactivées par défaut : Réglages → Plein écran → Afficher les paroles pendant l'écoute.

• Elles viennent de LRCLIB, une base communautaire gratuite. Tous les morceaux n'y sont pas.
• En plein écran, elles remplacent le haïku, qui passe dans les coulisses. La ligne en cours est en ambre et suit le morceau (enceintes Sonos, Musique, Spotify).
• Originales ou traduites : l'interrupteur dans le menu, ou la touche T en plein écran. La traduction se fait sur ton Mac.

Scrobble

Optionnel et désactivé par défaut (Réglages → Scrobble).

• Quoi : les enceintes Sonos, l'app Musique, et Spotify (désactivé par défaut : Spotify scrobble lui-même s'il est relié à Last.fm).
• Vers : Last.fm et/ou ListenBrainz, connectés dans Réglages → Comptes.
• Quand : le morceau est annoncé « en écoute » au début, puis scrobblé à la moitié, ou après 4 minutes s'il est long (seulement les morceaux de plus de 30 secondes), daté de son début. À la radio, il est marqué comme non choisi par toi.
• Pas de doublon : juste avant d'écrire, nowplayingd relit tes dernières écoutes. Si une autre app a déjà scrobblé le même morceau, il n'envoie rien. Il n'envoie pas non plus deux fois le même titre en 10 minutes.
• Hors ligne : les scrobbles attendent sur le disque de ton Mac et partent dans l'ordre au retour de la connexion.
• Plusieurs Macs : active le scrobble sur un seul d'entre eux, ou passe par une centrale.

Haïku et traduction

• Le haïku est écrit sur ton Mac par Apple Intelligence, dans la langue des titres quand le modèle la parle, sinon en anglais. Il faut un Mac compatible, avec Apple Intelligence activée (Réglages Système → Apple Intelligence et Siri). Sinon, il n'y a simplement pas de haïku.
• Les textes (Wikipédia, biographies) s'affichent dans ta langue quand ils existent. Sinon, ils sont traduits sur ton Mac par le framework Translation d'Apple et portent la mention « Traduit sur l'appareil ». Télécharge les langues voulues dans Réglages → Langue (l'anglais d'abord : la plupart des biographies sont en anglais).
• Les noms d'artistes, d'albums et de morceaux ne sont jamais traduits.

Partager sur Mastodon ou Bluesky

Une seule connexion, dans Réglages → Comptes :

• Mastodon : indique ton serveur (par exemple mastodon.social) et clique sur Se connecter. La page de ton serveur s'ouvre dans le navigateur : autorise nowplayingd, c'est tout.
• Bluesky : tape ton identifiant (par exemple toi.bsky.social) et clique sur Se connecter. La page de Bluesky s'ouvre : clique sur Accepter. Aucun mot de passe ne passe par nowplayingd.

Tu peux retirer l'accès à tout moment, dans Mastodon ou Bluesky, ou avec Déconnecter.

Ensuite : Partager sur Mastodon ou Bluesky… dans le menu (⇧⌘M). Tu obtiens un aperçu modifiable avec le morceau, l'album, le haïku, des mots-clés et la pochette avec sa description. Choisis le réseau, relis : rien ne part avant que tu cliques sur Publier. Sur Bluesky, le texte tient en 300 caractères : si le titre est très long, le haïku est retiré d'abord. Si un réseau a mis fin à la session, nowplayingd te demande simplement de te reconnecter.

Une centrale et des écrans

Un Mac toujours allumé (un Mac mini, par exemple) peut servir de centrale : il lit toutes les sources, écrit les haïkus et il est le seul à scrobbler. Tes autres Macs deviennent des écrans : ils affichent ce que la centrale publie sur le réseau local, sans rien relever eux-mêmes. Par défaut, chaque Mac est Autonome.

1. Sur le Mac mini : Réglages → Rôle → Centrale (toujours allumée). Active Ouvrir à l'ouverture de session, et note le code de jumelage à six chiffres.
2. Sur l'iMac ou le MacBook : Réglages → Rôle → Écran. La centrale apparaît ; tape le code une seule fois.
3. Pour que la centrale redémarre seule après une coupure de courant : Réglages Système → Utilisateurs et groupes → ouverture de session automatique.

Lecture/pause, suivant et « J'aime » depuis un écran agissent sur la centrale. Si la centrale se tait plus de deux minutes, l'écran peut afficher ses propres sources (sans scrobbler) et le signale dans le menu. Nouveau code et Oublier tous les écrans, sur la centrale, coupent tous les écrans déjà jumelés.

Réglages utiles

Réglage	Où
Rafraîchissement : services en ligne de 15 s à 5 min (30 s par défaut), enceintes de 3 s à 1 min (10 s par défaut)	Réglages → Sources
Adresse de secours d'une enceinte	Réglages → Sources
Rafraîchir maintenant	Menu, ⌘R
Langue de l'app et des contenus, langues de traduction	Réglages → Langue, puis Redémarrer

Problèmes fréquents

Last.fm ne s'affiche pas. Réglages → Comptes → Last.fm : si la tuile demande une clé, suis ses trois étapes (voir plus haut), puis Se connecter.

« Utilisateur inconnu ». Vérifie l'orthographe de ton nom d'utilisateur Last.fm ou ListenBrainz.

La radio ne s'affiche pas. Il faut être connecté à Last.fm, la station doit envoyer « ARTISTE - TITRE », et Last.fm doit connaître le morceau. Pendant une émission ou une pub, rien ne s'affiche : c'est voulu.

Un morceau reste « en écoute » alors qu'il est arrêté. Last.fm garde parfois l'annonce jusqu'à la fin théorique du morceau. nowplayingd la retire dès qu'un autre morceau est scrobblé, ou dès que Sonos ne joue plus.

Pas de haïku. Apple Intelligence est indisponible ou désactivée, ou le haïku est désactivé dans Réglages → Plein écran.

Repartir de zéro. Dans Réglages → Comptes, déconnecte chaque compte (et Retire ta clé Last.fm). Quitte nowplayingd, puis supprime le dossier ~/Library/Containers/ch.patrickostertag.nowplayingd. Le détail est dans la politique de confidentialité.

Confidentialité

nowplayingd ne collecte aucune donnée. Pas de serveur, pas de compte chez moi, ni pistage ni analytique. L'app parle directement à tes enceintes et aux services que tu choisis. Tes identifiants restent dans le trousseau de ton Mac ; les haïkus sont écrits et les textes traduits sur ton Mac.

Le détail, service par service : politique de confidentialité.

Une question, un bug, une idée ? Écris-moi sur Mastodon. Pour aider au diagnostic, joins le résultat de Tester les enceintes (sélectionne le texte et copie-le) et ta version (Réglages → À propos).

nowplayingd est en bêta. Envie de le tester ? C'est par ici.