Dépannage
Les problèmes les plus courants et leur solution. Si le vôtre n’y est pas, ouvrez un ticket sur GitHub en joignant le fichier de journal.
À jour pour la version 0.4.3
Documentation
À l’installation
| Problème | Solution |
|---|---|
| « Windows a protégé votre ordinateur » | Cliquez sur « Informations complémentaires », puis « Exécuter quand même ». L’installeur n’est pas signé commercialement. |
| macOS refuse d’ouvrir l’app | Réglages Système → Confidentialité et sécurité → « Ouvrir quand même ». |
| « RustMusic est endommagé » | Dans le Terminal : xattr -cr /Applications/RustMusic.app |
| « GLIBC_2.39 not found » | Installez la version de compatibilité glibc 2.35 (page Téléchargements). |
| L’AppImage ne démarre pas | Rendez-la exécutable (chmod +x) et installez libfuse2. |
| L’interface clignote au défilement (Linux) | Laissez DMA-BUF sur « Auto » dans Réglages → Apparence → Options expert, ou désactivez-le, puis cliquez sur « Relancer maintenant ». |
| L’interface est lente (machine modeste ou virtuelle) | Choisissez « Allégés » dans Réglages → Apparence → Options expert → Effets visuels. Le changement est immédiat. |
Le son
- Pas de son en mode exclusif : une autre application utilise peut-être déjà la sortie. Fermez-la, ou repassez en mode partagé dans Réglages → Audio.
- Le DAC affiche toujours la même fréquence : vérifiez que le mode exclusif est activé et que la bonne sortie est sélectionnée.
- Plus de son des autres applications : c’est l’effet normal du mode exclusif sur cette sortie ; elles reviennent à l’arrêt de la lecture.
- La pastille n’indique pas « Bit-perfect » : vérifiez une source sans perte, la fréquence et les canaux acceptés par le DAC, le volume à 100 % et un ReplayGain désactivé ou neutre. La pastille « Exclusif » indique seulement une sortie réservée.
- Linux, « Pas d’accès direct à cette sortie » avec un DAC USB : mettez RustMusic à jour. Depuis la 0.2.10, il retrouve la carte derrière la sortie PipeWire même quand PipeWire et ALSA la nomment différemment.
- Un morceau saute ou revient en arrière en cours de lecture (fichiers sur un disque réseau) : corrigé en 0.2.10, l’enchaînement attend désormais que le morceau soit entièrement décodé.
- Au lancement, la reprise jouait quelques secondes de silence avant de repartir : corrigé en 0.3.0, le morceau repart directement à la position enregistrée.
- Un changement de sortie ou de mode ne s’appliquait qu’au morceau lancé ensuite : depuis la 0.3.1, il s’applique tout de suite, sans relancer l’application.
- Linux, mode exclusif : le DAC disparaissait de la liste des sorties, qui ne montrait plus que « Dummy Output ». Corrigé en 0.3.1 : il y reste, sélectionné.
- Linux, aucun son avec PipeWire seul (paquet Flatpak notamment) : corrigé en 0.3.1, RustMusic se connecte au serveur son dans tous les cas.
Le DSD
- Le DAC affiche une fréquence PCM au lieu de « DSD » : activez « DSD natif (DoP) » et le mode exclusif, et vérifiez que votre DAC prend en charge le DoP.
- Du bruit à la place de la musique : le flux DoP a été modifié en route. Vérifiez qu’aucun autre logiciel n’applique d’égaliseur ou d’effet sur la sortie.
- Une coupure entre les pistes DSD : mettez RustMusic à jour, puis vérifiez la lecture sans blanc dans Réglages → Général. Depuis la 0.2.8, le DoP peut s’enchaîner sans coupure sur les trois systèmes ; un changement de format peut demander de rouvrir la sortie. La 0.2.9 corrige aussi les files bloquées avec du DSD converti en PCM.
La bibliothèque
- De nouveaux fichiers n’apparaissent pas : cliquez sur « Rescanner ». RustMusic ne surveille pas les dossiers en continu.
- Un dossier est marqué « Inaccessible » : le partage réseau n’est pas monté ou le disque est débranché. Ses morceaux sont conservés ; rebranchez-le, puis rescannez.
- Le NAS a été remonté sous un autre nom (par son adresse, puis par son nom, ou l’inverse) : RustMusic retrouve le même partage et propose de mettre la bibliothèque à jour ; morceaux, playlists, favoris et file d’attente suivent.
- Une compilation n’a que sa première piste : avant la 0.2.10, une compilation sans tag « artiste de l’album » pouvait perdre ses autres pistes à l’import. Mettez à jour, puis lancez un nouveau scan.
- Pas de pochette : « Récupérer les pochettes » dans le menu « Gérer » de la bibliothèque.
- Pas de paroles : placez un fichier .lrc portant le même nom à côté du morceau, ou attendez qu’elles soient disponibles sur LRCLIB.
- Un artiste invité manque : Réglages → Stockage → « Liaisons d’artistes » → « Réparer ».
- Deux artistes apparaissent comme un seul (« Chris Brown/Nicki Minaj ») : Réglages → Stockage & données → « Vérifier les artistes multiples ». Un groupe a été séparé à tort : « Revoir les corrections », puis « Annuler ».
- Un compositeur manque dans la vue Compositeurs : son nom n’est pas dans le tag compositeur ; complétez-le dans l’atelier de tags.
Radios, podcasts et serveurs
| Problème | Solution |
|---|---|
| Pas de page Radios ou Podcasts | Activez-les dans Réglages → Écoute en ligne : ils sont désactivés par défaut. |
| Une radio sonne étouffée | Son flux est en AAC+ (badge « AAC+ ») : le décodeur ne le lit qu’en qualité réduite. Si la station en propose un autre, choisissez-le dans « Qualité du flux » du menu « … ». |
| « La radio ne répond plus » | La station a coupé son flux, ou le réseau est tombé trop longtemps. RustMusic se reconnecte seul après une courte coupure ; sinon, relancez la station. |
| « Aperçu indisponible » | Le flux de l’émission ne répond pas pour l’instant. Réessayez plus tard, ou ajoutez l’émission par l’adresse de son flux RSS. |
| Une émission n’a pas de flux | Certaines émissions ne publient pas de flux RSS public : RustMusic ne peut pas les suivre. |
| Un serveur est « Injoignable » | Vérifiez qu’il est allumé et que l’adresse est la bonne dans Réglages → Stockage & données. Ses morceaux gardés hors ligne restent jouables. |
| Le serveur DLNA n’est pas trouvé | Un serveur dans Docker ou sur un autre réseau ne s’annonce pas : ajoutez-le par son adresse, par exemple http://127.0.0.1:8200. |
Le réseau : lecteurs, AirPlay et DLNA
| Problème | Solution |
|---|---|
| Aucun lecteur réseau dans « Sortie audio » | Activez « Lire sur un lecteur réseau » ou « Lire sur un appareil AirPlay (v1) » dans Réglages → Réseau & DLNA : ces fonctions sont désactivées par défaut. Vérifiez ensuite que l’appareil est allumé et sur le même réseau local (pas le Wi-Fi invité), puis cliquez sur « Rechercher ». |
| Appareils introuvables avec un VPN actif | Mettez RustMusic à jour : depuis la 0.3.0, la recherche part de chaque carte réseau et le serveur DLNA ne s’annonce plus dans le tunnel. Si un appareil reste absent, vérifiez que votre VPN laisse passer le réseau local. |
| Un appareil AirPlay n’apparaît pas | Il est sans doute protégé par mot de passe, ou n’accepte que l’AirPlay 2 : RustMusic ne gère que l’AirPlay 1, sans mot de passe. |
| Un court blanc entre les morceaux sur Sonos | C’est attendu : les Sonos enchaînent avec un court blanc. Sur les autres lecteurs, l’enchaînement reste sans blanc. |
| Un fichier DSD refusé par le lecteur réseau | L’appareil annonce ne pas lire ce format, et RustMusic le signale au lieu d’envoyer le fichier. Écoutez-le sur une sortie de l’ordinateur (DSD natif ou converti en PCM). AirPlay ne prend pas encore en charge le DSD. |
| macOS 15 : aucun appareil trouvé, serveur DLNA invisible | Autorisez RustMusic dans Réglages Système → Confidentialité et sécurité → Réseau local. Sans cette autorisation, macOS bloque en silence la recherche et le serveur. |
| L’appareil ne voit pas le serveur RustMusic | « Partager sur le réseau » activé, même réseau local, pare-feu autorisé et application ouverte. Certains routeurs filtrent le multicast entre Wi-Fi et Ethernet : vérifiez l’isolation des clients dans les réglages de la box. |
| L’ampli refuse la pause ou l’avance rapide sur le serveur DLNA | Corrigé en 0.3.0 : le serveur annonce désormais qu’il les accepte. Mettez RustMusic à jour. |
| L’ampli s’arrête après le premier morceau d’un album servi par RustMusic | Corrigé en 0.3.1 : le serveur DLNA décrit chaque morceau et le vrai nombre de morceaux d’un album ou d’un dossier. Mettez RustMusic à jour. |
| Un fichier ne se lit pas sur l’appareil | L’appareil ne prend peut-être pas en charge son format ou sa fréquence. |
La télécommande d’ampli
- « Aucun ampli trouvé » : la télécommande pilote les amplis Onkyo, Pioneer, Integra, Denon, Marantz et Yamaha. Vérifiez que l’ampli est allumé ou en veille réseau, sur le même réseau que l’ordinateur, puis cliquez sur « Rechercher » dans Réglages → Télécommande. Sous macOS 15, l’autorisation d’accès au réseau local est aussi nécessaire.
- L’ampli est « injoignable » : RustMusic réessaie toutes les 5 secondes et le retrouve de lui-même dès qu’il répond, même s’il a changé d’adresse sur le réseau.
- L’ampli ne s’éteint pas au clic : c’est voulu. Maintenez le bouton marche un peu moins d’une seconde, jusqu’à ce qu’il se remplisse de rouge.
Journal et réinitialisation
RustMusic écrit un journal dans le sous-dossier logs du dossier de données (fichier rustmusic.log). Depuis la 0.2.9, il contient aussi la sortie choisie, la chaîne audio et les conversions, en plus des erreurs. Joignez-le à vos tickets. Le bouton « Dossier de données » dans Réglages → Stockage ouvre ce dossier.
En dernier recours, « Réinitialiser l’application » repart d’un état neuf. Pensez à exporter vos réglages et playlists avant.
Pour aller plus loin
Une question sans réponse ?
Ouvrez un ticket sur GitHub : chaque retour aide à améliorer RustMusic et cette documentation.