Tune by Mozaiklabs

Dépannage

Les problèmes les plus fréquents et ce que vous pouvez faire. Si rien ne marche, envoyez un rapport depuis Tune : il contient tout ce qu'il faut pour un diagnostic.

L'interface ne s'ouvre pas

  • Vérifiez que Tune tourne : la fenêtre de console sous Windows, sudo systemctl status tune-server avec le paquet .deb, sudo systemctl status tune sous Tune OS.
  • L'adresse est http://<adresse-du-serveur>:8888, et sous Tune OS http://tune-XXXX.local ou http://<adresse-IP>.
  • Tune OS juste installé : le premier démarrage dure 15 à 30 minutes, avec deux redémarrages automatiques. Une machine qui répond déjà en SSH n'a pas forcément fini. Le déroulement s'écrit dans /var/log/tune-os-firstboot.log.
  • Windows, accès depuis un autre appareil impossible : le pare-feu Windows bloque Tune sur le profil « Réseau privé ». Autorisez tune-server.exe sur les réseaux privés dans le pare-feu Windows. Ce même blocage empêche aussi la découverte DLNA.
  • Port déjà utilisé : choisissez un autre port avec TUNE_PORT (voir Configuration). Sous Windows, depuis la 1.0.0-rc2, relancer Tune par son raccourci alors qu'il tourne déjà ouvre simplement l'instance en cours dans le navigateur.
  • Docker : le conteneur redémarre en boucle (sur un NAS, il s'arrête de manière inattendue) : le dossier monté sur /data n'est pas accessible en écriture à l'utilisateur tune (uid 1000). C'est le cas d'un dossier créé par Docker lui-même, comme ./data. Remplacez-le par le volume nommé tune-data:/data (voir Prise en main), ou donnez ce dossier à l'uid 1000 : sudo chown -R 1000:1000 ./data. Relancez ensuite docker compose up -d.

Un appareil n'apparaît pas

  • L'appareil et le serveur doivent être sur le même réseau (même sous-réseau, même VLAN). La découverte passe par le multicast : SSDP (UDP 1900) et mDNS (UDP 5353).
  • Sous Docker, utilisez network_mode: host.
  • Regardez dans Réglages › Audio › Appareils ignorés : l'appareil a peut-être été masqué.
  • Si la machine a plusieurs cartes réseau (ou un VPN), indiquez à Tune l'adresse à annoncer avec TUNE_ADVERTISED_IP.
  • Un LMS installé sur la même machine occupe le port 3483 : les lecteurs Squeezebox ne verront pas Tune.

Pas de son

Sortie locale

  • Vérifiez le Backend audio dans Réglages › Audio › Sorties audio locales. Sous Windows, ASIO a besoin du pilote du fabricant du DAC.
  • Une autre application peut garder le DAC en mode exclusif : fermez-la.
  • Linux (paquet .deb) : le service tourne sous l'utilisateur tune, qui doit appartenir au groupe audio.
  • Linux : en 1.0.0-rc1, un balayage ALSA/PipeWire bloqué pouvait figer Tune, qu'il fallait alors redémarrer à la main. Depuis la 1.0.0-rc2, ce blocage ne fige plus le serveur. Si la sortie audio se perd encore, envoyez un rapport depuis Tune.
  • Machine à un seul processeur : depuis la 1.0.0-rc2, Tune garde toujours au moins 4 fils de travail, pour éviter les gels de plusieurs secondes qui coupaient la lecture locale.

Appareil réseau

  • Réglages › Audio › Diagnostic audio (niveau Expert) et le Chemin du signal de la barre de lecture montrent ce qui est envoyé à l'appareil.
  • Vérifiez que l'appareil accepte le format envoyé. Pour le DSD, essayez le mode Auto ou PCM (conversion) dans Réglages › Appareils › Réglages par zone.
  • Coupures en DSD 256/512 vers un renderer : Réglages › Audio › Lecture DSD (renderers réseau), option Streaming continu. Après la mise à jour vers la 1.0, vérifiez que ce choix est toujours celui que vous aviez fait.

Windows : ASIO retombe sur WASAPI au démarrage

Symptôme : ASIO est choisi, mais au démarrage de Tune seules des sorties WASAPI (par ex. « Haut-parleurs ») apparaissent, ou la lecture reste bloquée. La 1.0.0-rc2 corrige les deux causes connues de ce repli : Tune attend désormais la fin de la recherche des pilotes ASIO avant de se replier sur WASAPI. S'il s'est replié malgré tout, il repasse de lui-même sur ASIO au balayage suivant des appareils, dès que rien ne joue sur une sortie locale.

  • Vérifiez que Réglages › Audio › Sorties audio locales › Backend audio est bien sur ASIO, et que le pilote ASIO du fabricant est installé.
  • Redémarrez Tune.
  • Si Tune affiche Balayage ASIO suspendu après un plantage, il a désactivé la recherche des pilotes ASIO pour éviter une boucle de plantages. Cliquez sur Réarmer le balayage ASIO, puis redémarrez Tune.
  • Si le problème persiste, envoyez un rapport depuis Tune en précisant votre DAC et son pilote.

Tune OS : pochettes et photos d'artistes disparues en 1.0.0-rc1

En 1.0.0-rc1, Tune OS cherchait le cache des pochettes dans /opt/tune/data/artwork_cache, alors que les versions précédentes l'avaient rangé dans /opt/tune/artwork_cache : presque toutes les pochettes et photos d'artistes semblaient perdues. La 1.0.0-rc2 corrige ce problème. Au démarrage, Tune reprend l'ancien cache et y recopie ce que la rc1 avait rangé ailleurs, sans rien écraser ni effacer. Il suffit donc de mettre Tune à jour. Si vous aviez déjà recopié les images à la main, il n'y a rien à défaire.

Bibliothèque

  • Un dossier ajouté n'apparaît pas : le chemin doit exister sur la machine où tourne Tune, et être lisible par le compte qui fait tourner Tune. Après le premier démarrage, modifier TUNE_MUSIC_DIRS n'a plus d'effet : passez par Réglages › Bibliothèque › Emplacements.
  • Changements non vus sur un partage réseau : Tune vérifie un partage toutes les 15 minutes. Pour aller plus vite, relancez Analyser la bibliothèque.
  • La jauge ReplayGain repartait de 0 % après une mise à jour ou un redémarrage, en 1.0.0-rc1. Depuis la 1.0.0-rc2, elle compte les pistes déjà analysées de toute la bibliothèque.
  • Partage réseau pas encore prêt au démarrage : depuis la 1.0.0-rc2, pour un partage SMB qu'il monte lui-même, Tune attend le premier essai de montage avant d'analyser la bibliothèque, puis retente en arrière-plan pendant environ 5 minutes. Les pochettes ne sont plus effacées tant que le partage est absent.
  • Une pochette a changé après la mise à jour : depuis la 1.0.0-rc2, l'image du dossier (par ex. cover.jpg ou folder.jpg) passe avant la jaquette intégrée aux fichiers. Pour un coffret rangé un dossier par disque, c'est l'image posée à la racine du coffret qui l'emporte. Une pochette que vous avez téléversée n'est jamais remplacée.
  • Analyses de fond trop gourmandes : réduisez Réglages › Audio › Vitesse des analyses de fond, ou mettez-les en pause depuis État du serveur.

Services de streaming

  • Deezer : « ARL refusé par Deezer » ou session perdue : ouvrez deezer.com, récupérez un nouveau cookie arl et collez-le dans Réglages › Accès et jetons › Services de streaming.
  • TIDAL, Qobuz : déconnectez puis reconnectez le service au même endroit.
  • YouTube : sans Activer la lecture YouTube, la recherche marche mais la lecture échoue.
  • Spotify : dans la 1.0, le catalogue se parcourt mais ne se lit pas. Pour connecter le compte, il faut le Client ID de votre propre application Spotify (voir Services de streaming).
  • Bandcamp : une piste relancée plusieurs jours plus tard depuis la file d'attente, l'historique ou un favori peut ne plus jouer, car son adresse a expiré. Depuis la 1.0.0-rc2, l'échec est noté dans le journal, et une zone Chromecast s'arrête en signalant l'erreur au lieu de rester muette. Relancez la piste depuis la page de son album.

Envoyer un rapport depuis Tune

Ouvrez Support, en bas de la barre latérale.

Signaler un bogue (onglet Diagnostic)

Ouvert à tous, sans licence. Décrivez Ce qui se passe, ajoutez si besoin des captures d'écran, puis cliquez sur Envoyer au forum. Votre texte, les diagnostics et les journaux récents du serveur partent dans un fil modéré du forum. Les chemins personnels sont retirés du rapport, et Voir le rapport joint vous le montre avant l'envoi.

Si Tune répond Limite d'envoi atteinte, parfois dès le premier envoi (problème connu, signalé), utilisez Copier le rapport et collez-le dans un nouveau sujet du forum, ou réessayez plus tard.

Écrire au support (onglet Tickets)

Ce formulaire s'affiche lorsqu'une licence Tune Premium est enregistrée. Il comprend Sujet, Catégorie, Zone concernée (facultatif), Votre message et Pièces jointes (jusqu'à 5 fichiers). Laissez cochée la case Joindre les journaux et la fiche système : sans eux, un diagnostic demande souvent plusieurs allers-retours. Le suivi de vos demandes se trouve dans l'onglet Tickets.

Journaux

  • Réglages › Système › Santé du serveur (niveau Avancé) : Télécharger les logs, ou Télécharger le diagnostic (un ZIP qui contient les journaux, les diagnostics et la configuration, identifiants masqués). Le Niveau de log se règle au même endroit.
  • Fichiers : voir le tableau « Emplacement des données » dans Configuration.

Voir aussi