Scanner votre bibliothèque
Cette page s’adresse à la personne qui fait tourner le serveur. Elle explique comment le serveur garde sa bibliothèque à jour avec votre dossier de musique, quand lancer un scan vous-même, et ce que veulent dire les listes de la console (fichiers manquants, doublons, sans pochette).
Ce qu’il vous faut
- Un serveur avec un dossier de musique réglé (
MUSONIC_MUSIC_DIR; avec Docker, le dossier monté sur/music). - Un compte administrateur, pour la console.
En bref : vous n’avez presque rien à faire
Section intitulée « En bref : vous n’avez presque rien à faire »Le serveur scanne la bibliothèque à son démarrage, puis :
- quelques secondes après un changement dans le dossier de musique (fichier ajouté, modifié, déplacé ou supprimé) : il surveille le dossier et attend 5 secondes sans changement, si bien que copier un album entier donne un seul scan, pas un par fichier ;
- à intervalle régulier, toutes les 60 minutes par défaut, pour rattraper ce que la surveillance aurait manqué ;
- quand vous le demandez, depuis la console ou un client Subsonic.
Deux scans ne se chevauchent jamais : une demande faite pendant un scan en relance un autre juste après.
Chaque scan parcourt ensuite les dossiers (en sautant ceux qui n’ont pas changé), ne lit que les fichiers changés (tous les fichiers pour un scan complet), puis met à jour les titres, albums, artistes, pochettes et paroles dans la base du serveur (musonic.db).
Lancer un scan depuis la console
Section intitulée « Lancer un scan depuis la console »-
Ouvrez l’adresse de votre serveur dans un navigateur et connectez-vous avec un compte administrateur.
La console d’administration s’ouvre sur le tableau de bord.
-
Cliquez sur « Bibliothèque » dans la partie « Musique » du menu.
Le haut de la page indique le nombre de titres et l’heure du dernier scan (par exemple « 35 titres · dernier scan il y a 9 minutes »), avec les boutons Scan rapide et Scan complet en haut à droite.
-
Cliquez sur « Scan rapide » (ou « Scan complet », voir plus bas lequel choisir).
La ligne sous le titre affiche « Scan en cours… » et les deux boutons restent grisés jusqu’à la fin.
-
Lisez le bilan du scan.
Il se trouve sous la ligne du titre, par exemple « 35 fichiers · 0 titre ajouté · 0 manquant · 0 erreur · 0 s » : le nombre de fichiers, de titres ajoutés, de fichiers manquants, d’erreurs et la durée.
Scan rapide ou scan complet ?
Section intitulée « Scan rapide ou scan complet ? »| Scan rapide | Scan complet | |
|---|---|---|
| Ce qu’il lit | Seulement les dossiers dont le contenu a changé (noms, tailles, dates de modification), et dedans seulement les fichiers audio qui ont changé | Tous les fichiers audio, à nouveau |
| Quand il tourne | Au démarrage, après des changements, à intervalle régulier, au bouton | Seulement quand vous le demandez |
| Durée | Quelques secondes sur une bibliothèque inchangée | À peu près celle du premier scan |
| À utiliser | Presque toujours | Après avoir ajouté ou remplacé une image de pochette ou un fichier de paroles à côté de titres inchangés ; après avoir modifié des tags avec un outil qui garde la date de modification du fichier ; quand quelque chose semble faux |
En ligne de commande ou depuis un client Subsonic
Section intitulée « En ligne de commande ou depuis un client Subsonic »docker compose exec musonic-server musonic-server scan # rapidedocker compose exec musonic-server musonic-server scan --full # completmusonic-server scan # rapidemusonic-server scan --full # completLancez-le avec les mêmes réglages que le serveur (mêmes MUSONIC_DATA_DIR et MUSONIC_MUSIC_DIR).
musonic-server scan scanne une fois, affiche un bilan et s’arrête. Il sert aux scripts et au premier scan avant un import depuis Navidrome ; quand le serveur tourne, préférez les boutons de la console, qui passent par la file de scans du serveur lui-même.
Les clients Subsonic qui ont un bouton « scanner la bibliothèque » utilisent startScan (fullScan=true pour un scan complet) ; seuls les comptes administrateurs peuvent en lancer un.
Changer le scan automatique
Section intitulée « Changer le scan automatique »-
Dans la console, ouvrez « Bibliothèque ».
-
Choisissez la fréquence dans « Scan automatique », en bas de la page, sous la liste des titres.
C’est une liste déroulante à droite du bloc, sous la note « Les changements du dossier sont vus tout de suite ; un scan régulier rattrape le reste. »
Les choix sont « Aux changements seulement », « Et toutes les heures » (par défaut), « Et toutes les 6 heures » et « Et une fois par jour ».
-
Cliquez sur « Redémarrer maintenant » dans le bandeau qui apparaît.
La nouvelle valeur s’applique une fois le serveur redémarré. La musique s’arrête quelques secondes, puis les applis se reconnectent seules.
Le même réglage s’appelle scan_interval_minutes dans le fichier de configuration, ou MUSONIC_SCAN_INTERVAL_MINUTES (en minutes, 0 = seulement aux changements ; de 0 à 10080 dans la console). Une valeur enregistrée dans la console l’emporte sur le fichier de configuration et sur l’environnement.
Quand les changements ne sont pas vus tout seuls
Section intitulée « Quand les changements ne sont pas vus tout seuls »Si le serveur ne peut pas surveiller le dossier, il écrit cette ligne dans ses journaux au démarrage et ne compte plus que sur les scans réguliers :
cannot watch /music: …; relying on scheduled scansLa surveillance repose sur les notifications du système. Elles n’arrivent pas pour tous les types de dossiers : les changements faits depuis une autre machine sur un partage réseau ne sont souvent pas signalés. Sous Linux, une très grosse bibliothèque peut aussi dépasser le nombre de dossiers qu’un utilisateur peut surveiller ; augmenter fs.inotify.max_user_watches avec sysctl règle ce cas.
Dans ces situations, gardez un scan régulier (toutes les heures, ou plus souvent avec MUSONIC_SCAN_INTERVAL_MINUTES), ou lancez un scan rapide à la main après avoir ajouté de la musique.
Likes et playlists quand les fichiers changent
Section intitulée « Likes et playlists quand les fichiers changent »Chaque titre a un identifiant qui ne change pas : donné une fois, il est gardé à travers les rescans, les déplacements et les imports. Likes, playlists, nombres d’écoutes et téléchargements des applis pointent vers cet identifiant. Quand un fichier change, le scanner cherche le titre auquel il appartient, dans cet ordre :
- Le même chemin : un fichier retagué sur place reste le même titre, avec ses nouveaux tags.
- La même identité : un fichier déplacé ou renommé est reconnu par son identifiant d’enregistrement MusicBrainz, sinon par artiste de l’album + album + disque + numéro de piste + titre. Il garde son titre, ses likes et ses playlists.
- Un titre vu d’abord en ligne, encore sans fichier, avec le même ISRC, ou le même nom, les mêmes artistes et la même durée (à 3 secondes près) : un fichier importé rejoint le titre déjà liké ou en playlist.
- Sinon, un nouveau titre.
| Ce que vous faites | Ce qui se passe |
|---|---|
| Modifier les tags d’un fichier, sur place | Même titre, nouveaux tags. |
| Déplacer ou renommer un fichier ou un dossier | Même titre (retrouvé par son identité). |
| Déplacer tout le dossier de musique (autre disque, autre montage Docker) | Rien à refaire : les chemins sont gardés relatifs au dossier de musique. |
| Déplacer un fichier et changer en même temps son titre, son album ou son numéro de piste | Un nouveau titre : l’ancien apparaît en fichier manquant et garde ses likes. Faites l’un, scannez, puis l’autre ; ou donnez des identifiants MusicBrainz à vos fichiers, qui survivent à tout changement. |
| Supprimer un fichier | Son titre est marqué « fichier manquant » : masqué dans les applis (sauf s’il est aussi connu du catalogue en ligne), gardé avec ses likes et ses playlists. Si le fichier revient, le titre revient tel quel. |
Le serveur ne supprime jamais de lui-même les titres dont le fichier manque.
Les listes de la console
Section intitulée « Les listes de la console »La page Bibliothèque a des onglets pour vérifier votre bibliothèque, sous le bilan du dernier scan. Chaque onglet indique combien de titres il contient (par exemple « Fichiers manquants 0 ») :
| Onglet | Ce qu’il liste |
|---|---|
| Titres | Tous les titres, avec leur fichier, format, débit et taille. Recherche par titre, artiste, album ou chemin de fichier. |
| Fichiers manquants | Les titres dont le fichier n’est plus dans le dossier de musique (déplacé sans être reconnu, ou supprimé). |
| Doublons | Le même titre deux fois : deux fichiers pour un titre (deux copies aux mêmes tags), ou deux titres avec le même nom et les mêmes artistes. |
| Sans pochette | Les titres sans aucune image : ni dans le fichier, ni dans leur dossier, ni en ligne. |
| En ligne | Les titres en ligne likés ou ajoutés à une playlist qui n’ont pas encore de fichier (pas importés). |
Cliquez sur un titre pour ouvrir sa fiche : tags, fichiers (avec Écouter pour vérifier, pour entendre le fichier dans le navigateur), catalogues en ligne qui le connaissent, ISRC, genres, écoutes et likes. En haut : le titre, puis artiste · album · année · numéro de piste · durée, et Écouter pour vérifier à droite. Le bloc Fichiers donne pour chaque fichier son chemin dans le dossier de musique, son format, son débit, sa fréquence d’échantillonnage, ses canaux et sa taille, avec un bouton Écouter. ‹ Bibliothèque, en haut à gauche, ramène à la liste.
Performances
Section intitulée « Performances »- Le scanner lit les tags de plusieurs fichiers à la fois, un par fil d’exécution du processeur.
- Un dossier dont le contenu n’a pas changé (mêmes noms, tailles et dates) n’est pas rouvert : un scan rapide d’une bibliothèque inchangée ne fait que parcourir les dossiers.
- Les changements sont écrits par lots de 200 fichiers, si bien que les applis continuent de fonctionner pendant un long premier scan.
- Sur une grosse bibliothèque, la mise en place de la surveillance prend un moment : le serveur répond aux requêtes pendant ce temps.
Réglages liés au scan
Section intitulée « Réglages liés au scan »| Réglage (fichier) | Environnement | Par défaut | Rôle |
|---|---|---|---|
music_dir |
MUSONIC_MUSIC_DIR |
aucun (/music dans l’image Docker) |
Le dossier de musique. Sans lui, le serveur démarre avec une bibliothèque vide. |
scan_interval_minutes |
MUSONIC_SCAN_INTERVAL_MINUTES |
60 |
Minutes entre deux scans réguliers ; 0 = seulement au démarrage, aux changements et sur demande. Aussi dans la console. |
Et ensuite
Section intitulée « Et ensuite »- Ranger vos fichiers de musique : formats, tags, pochettes et paroles.
- Catalogue en ligne et imports : les titres qui entrent dans la bibliothèque depuis le catalogue en ligne.