Recommandations de configuration avancées

Mise à jour : 19.10.2026

Les paramètres de serveur requis et les guides d'installation supplémentaires sont rassemblés ici. Les liens de configuration dans la liste de compatibilité mènent aux sections pertinentes.

Navidrome : regroupez les albums quelle que soit la date de sortie

Navidrome 0.64.2 regroupe également les albums par date de sortie par défaut. Si les balises de date dans différents formats de fichier sont interprétées comme une année d’enregistrement ou de sortie, le même album peut apparaître plus d’une fois.

Pour ignorer les dates de sortie lors du regroupement d'albums, définissez la règle suivante dans Navidrome. Remplacez une règle existante plutôt que d'ajouter une clé TOML en double. Si vous ajoutez une nouvelle règle, placez-la au niveau supérieur avant les sections du tableau.

PID.Album = "musicbrainz_albumid|albumartistid,album,albumversion"

L'ID de l'album MusicBrainz, l'artiste de l'album, le nom de l'album et la version de l'album déterminent toujours le regroupement. La règle s'applique à l'ensemble de la bibliothèque. Les versions ne différant que par la date peuvent être combinées. Aucune modification des balises de fichiers multimédias n’est requise.

Navidrome puis redémarrez. La règle d'album modifiée déclenche une analyse complète. Rechargez ensuite la vue de l'album dans les clients. Une variable d'environnement ND_PID_ALBUM a priorité sur le fichier de configuration et peut devoir être ajusté en conséquence.

Source : Navidrome : identifiants d'album et de piste configurables.

Navidrome : privilégier les pochettes intégrées

Lorsque des titres de différents albums partagent un dossier, un fichier Folder.jpg commun peut remplacer toutes leurs pochettes. Cette priorité privilégie une pochette intégrée disponible ; sinon, les autres sources restent disponibles en remplacement.

Dans navidrome.toml, remplacer la valeur existante ou ajouter le réglage au niveau principal avant les sections de table. Ne pas créer la clé en double.

CoverArtPriority = "embedded, cover.*, folder.*, front.*, external"

Redémarrer ensuite Navidrome. Le redémarrage seul ne recalcule pas les pochettes enregistrées. Dans Navidrome 0.64.2, la commande officielle artwork permet de résoudre à nouveau les albums concernés individuellement :

navidrome -c /pfad/navidrome.toml artwork refresh al ALBUM_ID_1 ALBUM_ID_2

Remplacer le chemin d’exemple et les identifiants d’album. Exécuter la commande avec le même utilisateur de service, le même répertoire de travail, la même configuration, le même environnement et la même base de données que Navidrome. Il n’est nécessaire ni de modifier les fichiers ou leurs tags, ni de supprimer la base de données.

Synchroniser ensuite la bibliothèque du client, par exemple Amperfy, pour récupérer les nouveaux identifiants de pochette. Il n’est pas nécessaire de réinstaller l’application ni de vider tout le cache des pochettes.

Ampache et LMS : connexion avec clé API

Ampache 7, Ampache 8 et LMS nécessitent une clé API pour la connexion. Créez une clé pour votre propre compte sur le serveur et utilisez-la lors de la connexion à MusicServer Connect. Gardez-le confidentiel.

Ampache 7.10.2 : importer des titres sans les artistes du titre

Symptôme et cause

Les fichiers sans artiste de piste peuvent être omis lors de l'importation du catalogue. La correction de la base de données ci-dessous permet leur importation. La connexion Ampache nécessite une clé API ; voir Connectez-vous avec une clé API.

Portée

Cette correction s'applique à Ampache 7.10.2 avec MariaDB et à la définition de colonne indiquée ci-dessous. Pour les autres versions, vérifiez d'abord si la même cause s'applique.

Qu'est-ce qui a changé

Seul song.artist dans la base de données Ampache sélectionnée est modifié pour autoriser NULL. Son type de données, sa valeur par défaut 0 et les index existants sont conservés. Le code source et les fichiers musicaux du Ampache sont inchangés. Aucun nom d'artiste n'est inventé et aucune balise de fichier n'est remplacée. Les autres bases de données et les paramètres globaux de MariaDB ne sont pas affectés.

Correction générale de la base de données

Exigences

Exécutez ces commandes sur le serveur MariaDB, à l'intérieur de son conteneur le cas échéant. Le compte de base de données a besoin d'un accès en lecture pour la vérification et de l'autorisation ALTER sur la chanson. L'exemple utilise la connexion locale root. Pour un autre compte de base de données, utilisez votre configuration client sécurisée existante ; ne mettez pas de mot de passe dans la commande.

Identifiez d’abord le nom réel de la base de données, répertorié comme database_name dans la configuration Ampache. Utilisez votre propre nom de base de données dans chaque commande.

AMPACHE_DB='DEIN_AMPACHE_DATENBANKNAME'
mariadb --database="$AMPACHE_DB" -e \
  "SHOW COLUMNS FROM song LIKE 'artist';"

Pour le problème confirmé, la sortie affiche Type=int(11) unsigned, Null=NO et Default=0. Si Null=YES, la correction est déjà appliquée. Ne modifiez pas une définition différente sans la vérifier.

Recommandé : le script ci-joint Télécharger ampache7-null-artist.sh sur le serveur de base de données. Il vérifie la colonne, accepte uniquement le type INT non signé attendu et n'apporte aucune autre modification si NULL est déjà autorisé. Un schéma inattendu le fait s'arrêter sans changement.

sh /pfad/zum/ampache7-null-artist.sh "$AMPACHE_DB"

Le noyau SQL concret du correctif pour la définition confirmée ci-dessus est :

ALTER TABLE song
  MODIFY COLUMN artist INT(11) UNSIGNED NULL DEFAULT 0;

Importez les fichiers manquants et vérifiez le résultat

Après avoir modifié le schéma, importez les fichiers manquants. Utilisez le chemin d’accès à l’application, le nom du catalogue et le compte de service de votre propre installation. La version PHP doit correspondre à la version Ampache.

AMPACHE_APP='/pfad/zur/ampache-installation'
AMPACHE_CATALOG='DEIN_KATALOGNAME'
runuser -u www-data -- php "$AMPACHE_APP/bin/cli" \
  run:updateCatalog "$AMPACHE_CATALOG" -a

mariadb --database="$AMPACHE_DB" -e \
  "SELECT COUNT(*) AS Titel FROM song;
   SELECT id, title, artist, enabled FROM song
   WHERE artist IS NULL;"

-a ajoute de nouveaux fichiers multimédias. Il ne demande pas de nettoyage du catalogue, d'importation de playlist ou de nouvelle analyse des balises de fichiers existantes. Ampache peut alors mettre à jour les mappages et compteurs internes.

Mettez ensuite à jour le plugin, ouvrez tous les titres et vérifiez les titres précédemment manquants. Puis les titres ci-dessus Tous les titres → tout marquer → rechercher dans la base de données → ajouter à la base de données dans la base de données de recherche VirtualDJ. Voir Rechercher dans les nœuds de l'arborescence.

Fonctionnement et mises à jour ultérieures

Il s'agit d'un ajustement local du schéma de base de données, et non d'une migration générale Ampache officiellement confirmée. Après une mise à jour de la base de données Ampache, vérifiez à nouveau song.artist et l'import des fichiers sans artistes des pistes : une migration peut modifier la définition. Le script peut être vérifié à plusieurs reprises.

Pour restaurer NOT NULL, les entrées NULL existantes devraient d'abord nécessiter une manipulation délibérée ; réinitialiser aveuglément la colonne n’est pas une restauration appropriée. La correction cochée préserve les artistes des pistes manquantes comme informations manquantes.

Gonic 0.22.0 : un album par dossier musical

Symptôme et cause

Gonic nécessite un dossier distinct pour chaque album. Conservez les fichiers d’un album ensemble ; ne mélangez pas différents albums dans un même dossier. Un dossier partagé pour des célibataires sans lien de parenté ne répond pas à cette exigence. Gonic peut ensuite appliquer les métadonnées de l'album du premier fichier, y compris l'artiste de l'album, à tous les autres fichiers de ce dossier.

Structure de dossier recommandée

Pour les titres isolés aussi, crée un sous-dossier par album, par exemple «Einzeltitel/Alter Ego - Betty Ford (Bonus Remixes Version)» / «Einzeltitel/Homie Isback - Cherrymoon». Les deux versions de Cherrymoon peuvent partager un dossier si elles appartiennent au même album. Sépare les éditions différentes. Place les fichiers musicaux dans des sous-dossiers du chemin musical configuré : Gonic 0.22.0 ignore les fichiers directement dans le dossier racine.

Si plusieurs serveurs partagent une bibliothèque, vous pouvez créer une vue de dossier distincte pour Gonic à l'aide de liens symboliques. Donnez-y également à chaque album son propre dossier. Configurez les chemins musicaux pour que chaque piste ne soit indexée qu'une seule fois. Le compte de service Gonic doit accéder à la fois aux liens et à leurs cibles.

Vérifier après le changement

Analysez à nouveau entièrement Gonic, puis actualisez la liste des pistes du plugin. Vérifiez les totaux, le regroupement d'albums, les nœuds d'artistes et la lecture. Les modifications apportées aux chemins d'importation peuvent créer de nouveaux identifiants de serveur, alors vérifiez ensuite les favoris, les listes de lecture et les paramètres VirtualDJ existants. Enregistrez à nouveau les pistes si nécessaire. Ajouter à la base de données de recherche VirtualDJ. Les pistes individuelles nouvellement ajoutées doivent également être fournies dans la structure de dossiers d'album appropriée.

Fournir des listes de lecture basées sur des fichiers à l'utilisateur

Gonic lit les listes de lecture à partir de son playlists-path et un sous-dossier nommé d'après l'ID utilisateur numérique. Placez-y les fichiers M3U/M3U8 avec les chemins multimédias résolus pour Gonic. Une analyse musicale normale n'importe pas automatiquement les listes de lecture d'autres dossiers de bibliothèque. Notre configuration crée des vues dérivées sans modifier les originaux partagés. Actualisez ces vues après avoir modifié les sources.

Documentation du projet Gonic

Gerbera 3.3.0-77 : BPM, clé, UTF-8 et Inotify

Ajoutez les mappages suivants pour BPM et la clé. Les fichiers musicaux doivent contenir les balises BPM et KEY ou INITIALKEY correspondantes. Conservez les mappages existants tels que PERFORMER.

Lignes supplémentaires : Tag Name et Upnp metadata entry
Bibliothèque	Tag Name	Upnp metadata entry
taglib	BPM	upnp:beatsPerMinute
taglib	KEY	upnp:key
taglib	INITIALKEY	upnp:initialKey
ffmpeg	bpm	upnp:beatsPerMinute
ffmpeg	clé	upnp:key
ffmpeg	clé initiale	upnp:initialKey

Pour une installation basée sur XML, ajoutez les entrées sous import → options de bibliothèque → id3 → métadonnées et ffmpeg → métadonnées. Gerbera étiquette le groupe XML id3 comme taglib Library Options dans son interface Web. Définissez charset sur UTF-8 dans les deux bibliothèques ; conservez ou définissez également filesystem-charset, metadata-charset et playlist-charset sur UTF-8. Enregistrez et redémarrez Gerbera. Des mappages de balises supplémentaires prennent effet lorsque les fichiers sont à nouveau importés ; une nouvelle analyse normale peut ignorer les fichiers inchangés. Pour une nouvelle installation, configurez ces options avant d'importer de la musique.

MP4, M4A et M4V : préférez un tag BPM plus précis

Disponible à partir de la version Git 3.3.0-77 : L'extension BPM Gerbera-PR #3993 a été fusionné et est inclus dans l’image officielle. Une précision plus élevée est facultative et doit être activée avec prefer_highest_bpm_accuracy="yes" être allumé. Sans cet attribut reste no la valeur par défaut.

L'attribut MP4 tmpo contient un entier. De plus, une balise iTunes BPM supplémentaire peut contenir une valeur plus précise. Dans l'élément XML existant import → library-options → id3 sa préférence peut-elle être activée ; conserver les mappages de balises existants :

<id3 prefer_highest_bpm_accuracy="yes" prefer_ambigous_bpm_value="bpm_tag">
  <metadata>
    <add-data tag="BPM" key="upnp:beatsPerMinute" />
  </metadata>
</id3>

Si manquant prefer_highest_bpm_accuracy ou s'il est réglé sur no, le comportement précédent est conservé. Pour yes Gerbera lit tmpo et la balise BPM supplémentaire séparément. Si la distance est inférieure à 1 BPM, la valeur du tag est reprise, par exemple 123,5 à la place 123. Si les valeurs diffèrent d'au moins 1 BPM, la sélection est déterminée par prefer_ambigous_bpm_value: tmpo préfère le nombre entier, bpm_tag la balise supplémentaire. Si le deuxième attribut est absent, bpm_tag. La notation d'attribut est explicite prefer_ambigous_bpm_value.

Seuls les nombres finis positifs sont valables pour cette sélection ; utilisez un point décimal dans la balise du fichier. Si une seule source est valide, elle est utilisée. Les valeurs des mi-temps ou des doubles-temps ne sont pas corrigées automatiquement. Les autres tags, genres, clés et couvertures sont lus comme avant. Redémarrez Gerbera après avoir modifié la configuration et réimportez les fichiers concernés ; une nouvelle analyse normale peut ignorer les fichiers inchangés.

AIFF : BPM, clé et lecture de plusieurs genres

S'il manque des fichiers AIFF, BPM ou une clé malgré les balises ID3 existantes, dans les Gerbera Config → Expert → Importer → Mappages → Mimetype-Contenttype le mappage du type MIME reconnu au type de contenu aiff supplément. Pour audio/x-aiff et audio/aiff chacun aiff entrez. Cela permet à Gerbera d'utiliser le lecteur TagLib correspondant ; les mappages BPM/touches du tableau ci-dessus sont toujours requis.

Dans la configuration XML, les lignes suivantes dans la section existante import → mappings → mimetype-contenttype avec les ajouts suivants, en conservant les mappages existants :

<treat mimetype="audio/x-aiff" as="aiff" />
<treat mimetype="audio/aiff" as="aiff" />

Redémarrez Gerbera ou son conteneur et importez à nouveau les fichiers concernés. Une nouvelle analyse normale peut ignorer les fichiers inchangés ; aucun changement de nom ou d’horodatage n’est requis.

OGV : adopter les balises des pistes audio et vidéo

Avec OGV, le titre, l'artiste, l'album, le genre, BPM et la clé peuvent figurer dans les pistes audio et vidéo individuelles. Activer dans les Gerbera Configuration → Expert → Library Options → ffmpeg Library Options l'option streams-enabled. Ceci est disponible dans la configuration XML import → library-options → ffmpegélément, l'attribut streams-enabled="yes" mettre; Conservez les attributs existants et les attributions de balises.

Redémarrez Gerbera ou son conteneur, puis réimportez les fichiers OGV existants. Les mappages BPM/touches dans le tableau ci-dessus sont toujours requis. Si l'analyse des métadonnées du flux n'est pas activée, ces valeurs peuvent être absentes malgré les balises de fichier correctement enregistrées.

WebM et WMV : adoptez plusieurs genres avec le bon lecteur

Depuis Git build 3.3.0-62 et aussi dans l'actuel 3.3.0-77 peut lire plusieurs balises de genre à partir de WebM et WMV. Les mises à jour conservent la configuration existante, de sorte que les mappages de lecteurs ajoutés dans la nouvelle version peuvent toujours être manquants. Dans Config → Expert → Importer → Mappages → Mimetype-Contenttype Ajoutez les mappages suivants ou dans la section XML existante import → mappings → mimetype-contenttype entrez :

<treat mimetype="video/webm" as="mkv" />
<treat mimetype="video/x-ms-wmv" as="asf" />

Conservez les mappages existants et les paramètres BPM/key, redémarrez Gerbera et réimportez les fichiers concernés. Cela modifie le lecteur de métadonnées utilisé, et non le type MIME de la vidéo renvoyée. Les fichiers ne nécessitent aucune conversion ni renommage. La base est la Mappages par défaut de cette version source Gerbera.

Détecter automatiquement les modifications de fichiers et d'attributs

Inotify détecte les événements du système de fichiers. inotify-attrib="yes" surveille en outre les modifications d'attributs, y compris les horodatages modifiés au toucher. Pour une installation Linux, étendez la section d'analyse automatique existante dans /etc/gerbera/config.xml tout en préservant le chemin musical :

<autoscan use-inotify="yes" inotify-attrib="yes">
  <directory location="/srv/music" mode="inotify" recursive="yes" hidden-files="no" />
</autoscan>

Utilisez ensuite le service Linux systemctl restart gerbera redémarrer.

Inotifier dans le conteneur officiel Gerbera

L'image officielle active déjà Inotify pour le dossier de musique monté, mais la surveillance des attributs supplémentaires est initialement désactivée. Utiliser Inotify et surveiller les modifications d'attribut Inotify apparaissent sous Gerbera Config → Expert → Import, mais ne peuvent pas être modifiées via cette vue dans l'image cochée. Les paramètres sont stockés dans /var/run/gerbera/autoscan.xml.

Sur QNAP, ouvrez gerbera-qnap dans Container Station et démarrez son terminal ou sa console. Sur Synology, sélectionnez gerbera-synology dans Container Manager, ouvrez son terminal et démarrez /bin/sh.. Exécutez la commande suivante dans le conteneur.
Insérez le bloc suivant. Il complète l'attribut et affiche le fichier d'analyse ; Le chemin musical et les paramètres existants sont conservés.

test -f /var/run/gerbera/autoscan.xml &&
sed -i -e 's/inotify-attrib="no"/inotify-attrib="yes"/g' \
  -e '/<autoscan/ { /inotify-attrib=/! s/<autoscan/<autoscan inotify-attrib="yes"/; }' \
  /var/run/gerbera/autoscan.xml &&
cat /var/run/gerbera/autoscan.xml

La sortie doit afficher l'analyse automatique avec inotify-attrib="yes". Redémarrez le conteneur, puis vérifiez que Monitor Inotify Attribute Changes est sélectionné dans Gerbera Config. Si autoscan.xml est manquant, identifiez d'abord le fichier de configuration réellement utilisé. Cette commande s'applique à la version officielle spécifiée dans les guides NAS.

Les balises de genre distinctes ne nécessitent aucun paramètre supplémentaire. MusicServer Connect utilise tous les champs de genre fournis par UPnP. Depuis la version 1.5, les genres combinés séparés par des points-virgules ou des barres obliques sont également attribués à leurs vues de genre individuelles. Les balises du serveur et des fichiers restent inchangées.

Sources : Analyse automatique et surveillance des attributs Gerbera, Configuration initiale de l'image officielle du conteneur.

Gerbera 3.3.0-77 : noms de titres purs dans les résultats de recherche

Gerbera combine M_ARTIST et M_TITLE pour les titres de pistes dans les réponses de recherche UPnP par défaut. MusicServer Connect importe via cette interface, donc « Speedy J - Electric Deluxe » apparaît dans la colonne de titre même si la balise du fichier TITLE ne contient que « Electric Deluxe ».

Sous serveur → upnp, configurez le résultat de l'élément de recherche pour utiliser uniquement M_TITLE. extend="no" remplace la liste par défaut au lieu d'ajouter des entrées :

<search-item-result extend="no">
  <add-data tag="M_TITLE" />
</search-item-result>

Le Script de configuration gerbera-suchtitel.py définit cette option dans une configuration XML existante. Le chemin par défaut est /etc/gerbera/config.xml ; un autre chemin peut être fourni comme argument. Les espaces de noms, commentaires et autres paramètres existants sont conservés. Si la structure du serveur est ambiguë, le script s'arrête avant d'écrire.

Alternativement dans l'interface Web de Gerbera à l'adresse Config → Serveur → UPnP → Résultat de l'élément de recherche l'entrée M_ARTIST supprimer et seulement M_TITLE pour le conserver. Vérifiez les paramètres déjà enregistrés dans l'interface Web, car ceux-ci peuvent remplacer les valeurs XML. Ce paramètre s'applique également à Gerbera 3.3. L'artiste reste disponible dans un champ de métadonnées distinct.

Redémarrez Gerbera et rechargez la connexion du plugin. Ce paramètre modifie les titres des pistes dans les résultats de recherche ; aucune modification de plugin ou de fichier musical n’est nécessaire. Vérifiez également l'affichage des pistes déjà stockées dans le VirtualDJ. La détection facultative des artistes FRITZ!Box est indépendante de ce paramètre.

Gerbera : vues de playlist et importation

Pourquoi la même playlist apparaît plusieurs fois

Gerbera peut afficher la même liste de lecture sous Listes de lecture → Toutes les listes de lecture et Listes de lecture → Répertoires. Cela ne signifie pas que le fichier de liste de lecture existe plus d'une fois.

MusicServer Connect combine des vues de playlist identiques. Si leur contenu diffère ou si une requête est incomplète, plusieurs vues peuvent rester visibles.

Vérifier les importations de playlists incomplètes

Vérifiez les entrées de la playlist. Les chemins relatifs font référence à leur dossier.
Vérifiez que tous les fichiers musicaux référencés existent et sont lisibles par le compte de service de Gerbera.
Relisez la playlist après les modifications. Si l'importation est incomplète, redémarrez le service Gerbera et attendez l'analyse.
Mettez ensuite à jour la vue dans le plugin et vérifiez la playlist.

Pour détecter automatiquement les modifications apportées aux horodatages des fichiers, utilisez Surveillance des attributs Inotify activer.

Références de playlist obsolètes et jeu de caractères M3U

Vérifier de nouveau le contenu des listes après toute modification des fichiers multimédias référencés. Un réexamen normal peut laisser les vues existantes inchangées. Actualiser ensuite la bibliothèque dans MusicServer Connect. Les identifiants du catalogue peuvent changer.

Pour partager les mêmes fichiers de playlist avec MinimServer, nous enregistrons les M3U en Windows-1252 et les M3U8 en UTF-8. Dans la version vérifiée 3.3.0-77, l’importateur standard de Gerbera ne résolvait pas correctement le chemin contenant un tréma dans le fichier M3U Windows-1252. Les Téléchargez l'extension d'importation M3U vérifiée et enregistrez-le dans le répertoire de script personnalisé configuré. Il détecte UTF-8 valide dans les lignes M3U et utilise autrement Windows-1252. Les listes de lecture M3U8, PLS et XML continuent d'utiliser l'importateur standard. Conservez les scripts personnalisés existants.

Dans la configuration Gerbera existante sous import/scripting/import-function le nom de la fonction playlist de importPlaylist sur mscImportPlaylist changer. Sous import/scripting/script-folder/custom Le répertoire configuré doit contenir le fichier téléchargé et être stocké de manière permanente pour les installations de conteneurs. Au banc d'essai, c'est inférieur /var/run/gerbera/custom-js. Redémarrez ensuite Gerbera et importez à nouveau les enregistrements de la playlist. L'extension nécessite l'importateur JavaScript.

MiniDLNA / ReadyMedia 1.3.3 : extensions de fichiers de liste de lecture

MiniDLNA 1.3.3 reconnaît les listes de lecture avec .m3u et .pls. Les fichiers avec .m3u8 ne sont pas lus.

Recommandation : renommer M3U si possible

Si aucune autre configuration d'application ou de serveur ne dépend du nom de fichier M3U8 actuel, remplacez l'extension .m3u8 par .m3u. Il s'agit de la solution la plus simple pour MiniDLNA. Conservez le contenu, l'encodage UTF-8 et l'emplacement inchangés afin que les chemins musicaux relatifs continuent de fonctionner. Mettez à jour toutes les références au nom du fichier de liste de lecture. Demandez ensuite à MiniDLNA d'importer à nouveau la liste de lecture et d'actualiser le plugin.

Alternative : conserver une source M3U8 partagée

Si d'autres serveurs ont besoin du fichier M3U8, créez un fichier M3U supplémentaire pour MiniDLNA. S'il se trouve dans un autre dossier, ajustez les chemins musicaux relatifs ou utilisez des chemins absolus.

Le Script de configuration minidlna-playlist-view.py vérifie la source et la destination, crée le M3U dérivé et ajoute media_dir=A,/media3 à la configuration existante de MiniDLNA. Cela ne modifie pas la source M3U8 ni les entrées media_dir existantes. Sur un conflit de destination, ça s'arrête. Rechargez MiniDLNA et actualisez le plugin. Après avoir modifié la liste de lecture source, exécutez le script et redémarrez à nouveau MiniDLNA pour conserver la vue dérivée à jour. Aucun observateur de modifications n'est installé.

Autorisations de cache lors de la reconstruction

Si MiniDLNA ne parvient pas à nettoyer son cache de couverture lors de la reconstruction, vérifiez les autorisations d'écriture sur le cache et ses sous-répertoires.

Pour les autres installations, identifiez d'abord le compte de service réel et le chemin de cache configuré. Après avoir reconstruit la bibliothèque, actualisez le plugin. Si nécessaire, enregistrez à nouveau la liste complète des titres en utilisant « Recherche dans la base de données → Ajouter à la base de données ».

Partager de l'audio et de la vidéo

Un partage avec media_dir=A,/srv/music est limité à l'audio. Pour les deux types de médias, ouvrez cette ligne existante media_dir=AV,/srv/music modifier, obtenir des approbations supplémentaires et redémarrer le service. Les limites du codec et des métadonnées restent indépendantes de cela.

Serviio 2.5 : libérer les vues requises

Pour que les artistes de l'album et la commande originale des albums soient disponibles, affichez les catégories requises dans la console Serviio.

Ordre des titres

Pour la commande originale des morceaux, ouvrez un seul album. Un tri de colonne sélectionné dans VirtualDJ peut modifier l'ordre visible.

Dans la console Serviio, sous Présentation → Audio, définissez Musique, Albums, Titres et Listes de lecture sur « Catégorie d'affichage ». D'autres catégories audio peuvent utiliser « Afficher le contenu uniquement ». La vue album doit être disponible pour la requête supplémentaire. Aucune modification du fichier musical n’est nécessaire.

Différents artistes d'albums enregistrés

Si les métadonnées de l'album ou de l'artiste de Serviio diffèrent des balises de fichier, relisez les métadonnées sur le serveur, puis actualisez le plugin.

S’il existe plusieurs balises de genre, seule la première est adoptée.

Si un fichier comporte plusieurs balises de genre, seule la première est utilisée. Les genres restants sont absents des métadonnées et de l’arborescence des genres renvoyées. Cette limitation de compatibilité n'est pas spécifique à un format de fichier.

Lisez aussi les vidéos

Sous Bibliothèque → Dossiers partagés modifier le dossier bibliothèque existant et en plus de Audio aussi Vidéo pour l'activer. Enregistrez le partage et Forcer l'actualisation exécuter. Les listes de lecture de fichiers mixtes sont fournies par Serviio dans des vues audio et vidéo distinctes.

Serveur Twonky 8.5.2 : récupération complète des titres et des albums

Lorsqu'il détecte la structure Twonky, MusicServer Connect utilise les vues natives complètes des pistes et des albums. Lors de nos vérifications, la recherche globale du serveur a omis sept pistes accessibles sous W et Y. La solution de secours automatique récupère également ces pistes et préserve l'ordre des albums. Aucun paramètre de plugin supplémentaire n'est nécessaire. Les pages natives incomplètes ou incohérentes sont toujours rejetées.

La vérification de suivi a porté sur les fichiers multimédias 149 (audio 139, dix vidéos) et sur toutes les vues proposées sans erreurs de récupération. La prise en charge, les formats et les métadonnées manquants de ASX/XSPF restent des limitations du serveur. Twonky peut nécessiter une nouvelle connexion du fournisseur après le redémarrage ; un avis de connexion n'est pas un catalogue de musique.

Universal Media Server 15.8.2 : service Linux et affichage de l'album

Pour un service Linux, définissez l'environnement sur UTF-8 afin que les chemins musicaux contenant des trémas et d'autres caractères Unicode puissent être traités.

Avec systemctl edit DIENSTNAME.service Configurez l'ajout suivant pour votre propre service UMS. Après ça systemctl daemon-reload Exécutez, redémarrez ce service et attendez l'analyse de la bibliothèque.

[Service]
Environment=LANG=C.UTF-8
Environment=LC_ALL=C.UTF-8

Les paramètres régionaux C.UTF-8 doivent être disponibles sur le système. La configuration de Java file.encoding à elle seule ne remplace pas les paramètres régionaux utilisés pour les noms de fichiers. Une commande Java lancée à partir d'un shell interactif peut utiliser des paramètres différents de ceux du service en cours d'exécution.

L'accès direct au dossier de musique sur Linux évite les restrictions de partage Windows sur les noms de fichiers, tels que les noms contenant un point d'interrogation.

Artistes d'album et recherche dans la base de données

Pour obtenir des informations complètes sur l'artiste de l'album dans UMS.conf, activez la recherche dans la base de données intégrée et redémarrez UMS :

search_lucene_use_engine = false

Le paramètre remplace la recherche en texte intégral Lucene par la recherche de base de données intégrée.

Commande d'album original

Pour la commande originale des morceaux, ouvrez un seul album. Un tri de colonne sélectionné dans VirtualDJ peut modifier l'ordre visible.

UMS combine plusieurs balises de genre en un seul texte séparé par « / ». MusicServer Connect crée des nœuds de genre individuels à partir de celui-ci ; le morceau apparaît sous chaque genre répertorié. Gérer plusieurs genres.

Fichiers ASX et recherche de catalogue incomplète

UMS 15.8.2 peut compter les fichiers de liste de lecture ASX comme des dossiers vidéo sans renvoyer les objets correspondants. La recherche audio peut également annoncer plus de correspondances qu'elle n'en renvoie et peut omettre OGG des recherches de classe audio. MusicServer Connect détecte ces incohérences et complète le catalogue à l'aide de véritables dossiers de fichiers. La collection vérifiée de fichiers audio et de dix fichiers vidéo 141 apparaît dans son intégralité, avec les identifiants audio et les métadonnées existants conservés. Aucun paramètre supplémentaire n’est nécessaire.

Le plugin découvre les vrais sous-dossiers indépendamment de la recherche SQL incomplète. Les pages de recherche précédemment cochées sont utilisées uniquement pour mapper les alias. Il compare deux inventaires complets de fichiers avant de les accepter et vérifie à nouveau les modifications apportées à l'état de recherche. Il ne traverse pas les combinaisons de filtres virtuels. Si une future version d'UMS fournit des résultats de recherche complets avec les classes de médias correctes, le plugin utilise à nouveau automatiquement cette recherche directe. Les fichiers sources de la bibliothèque restent inchangés.

Cette solution de secours ne répare pas les métadonnées de serveur ou les entrées de playlist manquantes : ASX, WPL et XSPF sont toujours absents des vues de playlist. UMS a omis la première piste des anciennes listes M3U/PLS vérifiées ici. Les trois listes de formats mixtes contiennent cependant les six positions, y compris les entrées audio et vidéo répétées.

Conversion audio et streaming WAV

UMS peut transcoder l'audio en 16-bit WAV en fonction du profil du client. Quatre échantillons contenaient de l'audio complet lors de la vérification de suivi, bien que les longueurs illimitées de WAV n'aient pas échoué à la validation stricte des fichiers. Le décodage normal et la comparaison après normalisation sur le bit 16 ont réussi. Cela ne prouve pas la préservation d’une résolution originale en bits 24. De très petites requêtes de plage pourraient revenir vides lors de la conversion ; les téléchargements normaux et les requêtes KiB 64 ont fonctionné.

Masquer le dossier de transcodage supplémentaire

show_transcode_folder = false masque le dossier virtuel pour les paramètres de transcodage alternatifs. Le transcodage lui-même et les balises multimédia enregistrées sont conservés. Cette option d'affichage à elle seule ne corrige pas le nombre de pages UPnP incohérent.

MinimServer : BPM/Mise à jour des clés et de la bibliothèque

Lire BPM et la clé à partir de fichiers musicaux

Pour fournir des balises supplémentaires, vous avez besoin d’une licence MinimServer complète ou d’essai. Les fichiers musicaux doivent contenir des balises BPM et KEY ou INITIALKEY.

Sur la page de configuration MinimServer, ouvrez Propriétés.
Sous itemTags les noms BPM,KEY,INITIALKEY supplément. Conserver les entrées existantes ; les balises doivent correspondre à vos propres fichiers musicaux. KEY et INITIALKEY considérer : le champ MP3 TKEY est traité par MinimServer comme INITIALKEY est lu.
Enregistrez les modifications et effectuez le redémarrage du serveur demandé.
Exécutez une nouvelle analyse sous Statut. Mettez ensuite à jour la bibliothèque dans MusicServer Connect.

Informations complémentaires : MinimServer : métadonnées supplémentaires et Portée de la licence. Le Advanced Mode de WiiM est une fonctionnalité de l'application WiiM ; l'exigence de licence complète concerne ici les métadonnées supplémentaires du serveur.

Les valeurs déjà stockées dans VirtualDJ peuvent rester après une modification. Pour relire les balises BPM/clés intégrées, sélectionnez les pistes concernées et choisissez « Lire BPM et la clé à partir du fichier musical » dans le menu contextuel. Pour une nouvelle analyse audio, utilisez « Analyser BPM et les balises » ; avec plusieurs pistes sélectionnées, cette action se trouve sous « Batch ».

Relire après modifications

Analysez à nouveau MinimServer après avoir modifié les fichiers musicaux, les balises ou les heures de modification. Ouvrez sa page de configuration, choisissez l'onglet État et cliquez sur Rescan. Actualisez l'état jusqu'à ce qu'il indique « En cours d'exécution », puis actualisez MusicServer Connect. Le redémarrage de MinimServer seul ne déclenche généralement pas une nouvelle analyse.

Un index de serveur obsolète peut renvoyer des espaces réservés « Élément modifié ou supprimé » sans métadonnées de piste ni fichiers audio. Ces espaces réservés peuvent toujours être inclus dans le total déclaré. Le plugin affiche alors moins de pistes utilisables, bien que les artistes et les albums des albums restent connus des conteneurs de serveurs existants.

Voir Page de configuration MinimServer et nouvelle analyse ainsi que API Web officielle pour les nouvelles analyses automatisées.

Combinez un album à partir de plusieurs dossiers

Si les pistes du même album se trouvent dans plusieurs dossiers, MinimServer peut diffuser plusieurs albums portant le même nom. Le paramètre sous Propriétés mergeFolderAlbums sur true à la valeur indiquée, enregistrez et redémarrez MinimServer. Le nom de l'album et l'artiste de l'album doivent correspondre. Ce paramètre s'applique à l'ensemble de la bibliothèque et peut également combiner d'autres albums correspondants provenant de plusieurs dossiers. Les fichiers multimédias sont inchangés.

Lors de notre vérification, cela combinait « MSC Format Tests 1.3 » des sous-dossiers Audio et Vidéo en un seul album avec les pistes 13 reconnues par MinimServer. Auparavant, les deux groupes contenaient onze et deux titres. Ensuite, ouvrez le serveur dans WiiM Home et … → Réanalyser le serveur de musique pour mettre à jour le propre index de l’application. L'étiquette peut différer selon la langue de l'application. Par la suite, WiiM Home n'a affiché qu'une seule copie de l'album exemple dans notre chèque.

Voir MinimServer : albums et dossiers et WiiM Home : relire la bibliothèque multimédia.

M3U/M3U8 : jeu de caractères et entrées manquantes

MinimServer attend .m3u avec Windows-1252 ou ISO-8859-1 et .m3u8 avec encodage UTF-8. Un fichier UTF-8 avec l'extension .m3u peut donc omettre les pistes dont les chemins contiennent des caractères accentués. Utilisez M3U8 pour les chemins Unicode. Si M3U est également nécessaire, enregistrez une copie distincte dans le codage approprié. Ne remplacez pas les caractères que cet encodage ne peut pas représenter.

Dans la collection vérifiée, une nouvelle analyse a réparé la référence obsolète « Betty Ford » précédemment renvoyée comme « Élément modifié ou supprimé » sans audio utilisable. Le codage Windows-1252 correct du Sven Väth M3U supplémentaire a également restauré la référence du chemin accentué à « W.I.R. » Les deux listes ont ensuite fourni les quatre titres dans l'ordre des sources, sans reconstruction complète du catalogue. Les listes de formats mixtes fournissaient cinq des six positions, y compris les rediffusions ; MKV est resté exclu car le format n'est pas pris en charge.

Après la nouvelle analyse, mettez à jour la bibliothèque dans le plugin. Source : MinimServer : formats de liste de lecture et jeux de caractères.

JRiver : importer des listes de lecture et autoriser l'accès en lecture

Importez des listes de lecture dans la bibliothèque JRiver. Si l'importation automatique de musique ignore une liste de lecture, importez-la séparément, puis actualisez la vue du plugin.

L'écriture via l'interface de service Web de JRiver nécessite l'activation de l'authentification. L'accès anonyme en lecture doit rester autorisé : MusicServer Connect l'utilise pour distinguer les playlists régulières et intelligentes. L'accès en lecture n'accorde pas l'autorisation de modifier la liste de lecture.

Vous pouvez afficher ou masquer les listes de lecture intelligentes dans le plugin. Le contenu masqué de la liste de lecture intelligente n'est pas demandé lors de la construction de l'arborescence ; ils sont chargés lorsque vous les montrez. Les listes vides et les listes sans pistes audio n'apparaissent pas comme listes de lecture musicale.

Synology : configurer le serveur multimédia par défaut

Le serveur standard de Synology prend en charge WiiM Home Advanced Mode. Il est également suffisant pour MusicServer Connect si VirtualDJ calcule BPM et se saisit lui-même. Pour les valeurs BPM/clés stockées, vous pouvez utiliser Gerbera dans le conteneur . Les deux serveurs peuvent lire les mêmes fichiers musicaux.

Installez Media Server dans Package Center et copiez votre bibliothèque musicale dans le dossier musical partagé. Un pool de stockage et un volume doivent déjà exister.

Paramètres généraux : langue du menu DMA au choix, style de menu DMA Style simple ; Laissez l’intervalle de rapport SSDP à la valeur par défaut.
Paramètres de recherche : définissez le format d'affichage de la musique sur « Titre uniquement » ; autorisez les fichiers de couverture supplémentaires avec « Image de couverture pour les fichiers audio/vidéo » et conservez les noms de fichiers par défaut.
Compatibilité DMA : laissez le transcodage audio et les types MIME personnalisés désactivés. Autorisez l’accès aux appareils souhaités.
Après la copie, éjectez en toute sécurité la clé USB. Les albums, les pistes individuelles et les dossiers de listes de lecture se trouvent directement sous la musique.

Le serveur multimédia Synology combine plusieurs balises de genre en une seule valeur séparée par « ; ». MusicServer Connect crée des nœuds de genre individuels, de sorte que chaque piste apparaisse sous chaque genre répertorié. Gérer plusieurs genres.

Enregistrez des listes de lecture avec l'extension .m3u. Dans File Station, renommez un fichier .m3u8 sous musique/listes de lecture en .m3u, en conservant le contenu UTF-8 et les chemins relatifs. Si d'autres serveurs ont besoin de M3U8, créez une copie M3U distincte.

FRITZ!Box : formats audio et artistes de piste

Configurer le serveur multimédia

Connectez le stockage USB contenant la bibliothèque musicale. Dans l'interface FRITZ!Box, activez Media Server sous Home Network → Media Server, sélectionnez le stockage USB comme source multimédia et appliquez. Créez ou mettez à jour son index de fichiers sous Réseau domestique → USB/Stockage ou Stockage (NAS) et attendez l'indexation. Sélectionnez ensuite le serveur multimédia FRITZ!Box dans MusicServer Connect.

Formats audio et métadonnées

FRITZ!Box peut diffuser de nombreux formats audio mais ne lit que certaines de leurs balises. Sans prise en charge des balises, l'artiste de l'album, l'album et le genre sont absents de l'arborescence de la bibliothèque. Lorsque la détection d'artiste de piste est activée, MusicServer Connect peut dériver un artiste à partir des noms du modèle « Artiste - Nom de la piste ». Les fichiers restent accessibles via Toutes les pistes, dossiers et listes de lecture prises en charge.

Évaluation des tags selon le tableau de format FRITZ!Box
Formats audio	Lecture des étiquettes
MP3, WMA, ASF	Oui ; aucune garantie de tous les champs de métadonnées individuels.
FLAC	Non
AAC, M4A	Non
WAV, FIA/AIFF, LPCM	Non
Ogg Vorbis, APE, WavPack, MPC	Non
3GP, AC3, MKA, MPA, MP1, MP2, Real Audio, Karaoké CDG/BIN	Non

Pour MP3/WMA, la documentation du fournisseur répertorie le titre, l'artiste, l'album, le genre et le numéro de piste ainsi que l'ID3 v2.3 ou version antérieure. L'artiste de l'album, BPM et la clé ne sont donc pas confirmés comme champs pris en charge. VirtualDJ ou le lecteur doit prendre en charge le format audio pour la lecture.

Recommandation : utiliser des artistes de piste

Pour les bibliothèques avec FLAC ou d'autres formats sans évaluation de balise, même lorsqu'elles sont mélangées avec MP3, la vue Artiste du titre si les noms de fichiers suivent le modèle "Artiste - Titre Nom" correspondre. Pour ce faire dans le menu contextuel de la source MusicServer Connect en premier "Déterminer l'artiste titre à partir des noms de fichiers" allumer. Sélectionnez ensuite « Afficher les artistes » et « Passer aux artistes en titre » si cette vue n'est pas déjà active.

Cette détection est désactivée par défaut pour les nouvelles connexions au serveur et est enregistrée par connexion. Pour le désactiver, choisissez « Désactiver la détection des artistes des pistes à partir des noms de fichiers » dans le même menu. Laissez-le désactivé si vos noms de fichiers ne suivent pas « Artiste - Nom de la piste » : le plugin ne peut pas déterminer si le texte avant un trait d'union est un artiste ou une partie du titre.

Lorsque la détection est activée, l'artiste est manquant et le nom correspond au motif, MusicServer Connect se divise au premier « - ». Par exemple, « 1st Bass - Slam Me Down » devient l'artiste « 1st Bass » et le titre « Slam Me Down ». Les autres tirets restent dans le titre ; les métadonnées existantes sur les artistes sont prioritaires. Lorsqu'elle est désactivée, ce fractionnement n'est pas effectué et le titre fourni par le serveur reste inchangé à cet effet. La détection de remix est un paramètre distinct.

Lors du changement, MusicServer Connect met également à jour les affichages des titres enregistrés si le titre et l'artiste correspondent toujours à l'une des deux variantes générées par le plugin. Les autres modifications manuelles sont conservées. Ce commutateur ne modifie pas les valeurs de BPM, de clé, de remix ou d'analyse.

Cette détection remplit le champ de l'artiste et la vue de l'artiste de la piste. Il ne remplace pas les balises d’album, d’artiste d’album ou de genre. Si votre bibliothèque contient uniquement MP3, WMA ou ASF, les balises fournies par le serveur peuvent être utilisées et la vue artiste de piste n'est pas nécessaire comme solution de secours. La vue album-artiste n'est utile que si le serveur fournit réellement les informations requises.

Pour les formats dont les balises ne sont pas lues, FRITZ!Box ne peut pas non plus fournir les valeurs BPM/clés stockées. VirtualDJ peut les calculer lui-même. Pour une navigation complète dans la bibliothèque basée sur des balises, utilisez un serveur de musique qui prend en charge les métadonnées de vos formats.

Listes de lecture

Utilisez M3U ou PLS. WPL est reconnu mais peut omettre des pistes, alors choisissez M3U ou PLS pour des listes complètes fiables. M3U8, ASX et XSPF ne sont pas reconnus comme listes de lecture. Conservez le contenu UTF-8 et les chemins musicaux relatifs valides. MusicServer Connect supprime l'extension de fichier et le nom de dossier ajouté du nom de liste de lecture affiché.

Documentation du fabricant : Formats audio, lecture de tags et formats de playlist, Versions de tri et de balises ainsi que Configurer le serveur multimédia et créer un index de fichiers.

QNAP : exécutez le serveur multimédia standard et Gerbera en parallèle

Le module complémentaire Media Streaming standard de QNAP prend en charge WiiM Home Advanced Mode. Il est également suffisant pour MusicServer Connect si VirtualDJ calcule BPM et que l'ordre des touches et une liste de lecture incorrecte est acceptable. Pour les valeurs BPM/clés stockées, les genres séparés et l'ordre correct de la liste de lecture, vous pouvez utiliser Gerbera avec station à conteneurs être complétée.

Installez la console multimédia et le module complémentaire Media Streaming dans App Center. Placez les dossiers de musique sous Public/musique. Dans Console multimédia → Gestion de contenu, sélectionnez Module complémentaire Media Streaming et ajoutez Public/musique comme source de contenu.

Indexation : Activer les informations multimédia ; Priorité normale. Pour la bibliothèque UTF-8, sélectionnez UTF-8 si elle est proposée, sinon laissez la valeur par défaut.
Ouvrez les paramètres du module complémentaire Media Streaming séparément. Sélectionnez votre propre compte utilisateur NAS et l'interface réseau appropriée ; utilisez le port par défaut 8200.
Sous DLNA Media Renderer, autorisez l'accès au PC ou au client souhaité.
Sous Paramètres de navigation, définissez le style de menu par défaut sur Toutes les catégories. Sous DLNA Media Renderer, sélectionnez également Toutes les catégories et votre propre profil utilisateur pour le client. Appliquez les deux modifications.
Arrêtez et démarrez le module complémentaire Media Streaming dans l’App Center. Vérifiez ensuite à nouveau le déverrouillage de l'appareil et réglez-le à nouveau si nécessaire.
Les listes de lecture sont disponibles sous les noms M3U, PLS ou WPL ; M3U8 n'est pas pris en charge. Utilisez UTF-8 et des chemins relatifs valides. L'ordre de suivi reste incorrect dans les trois formats.

Les noms de fichiers contenant un point d'interrogation peuvent provoquer des problèmes lors de la copie via Windows/SMB. Copiez les fichiers concernés directement depuis le stockage USB dans le dossier de musique approprié à l'aide de QNAP File Station.

Pour la commande des albums, conservez la musique de chaque album dans un seul dossier. Pour plusieurs disques, utilisez des sous-dossiers tels que CD 1 et CD 2, avec des numéros de piste positifs et uniques. QNAP utilise uniquement le premier genre. L'ordre des listes de lecture reste incorrect avec M3U, PLS et WPL ; basculer entre eux ne résout pas ce problème.

Ajouter Gerbera pour MusicServer Connect

Continuez à utiliser la bibliothèque existante sous Public/music et Gerbera après la en suivant les instructions étape par étape . Connectez-vous ensuite à l'URL de l'appareil Gerbera dans le plugin et vérifiez les pistes, les balises et l'ordre. Gardez le module complémentaire Media Streaming en cours d’exécution pour WiiM Home Advanced Mode ou d’autres appareils, en y sélectionnant le serveur standard de QNAP. Utilisez Gerbera dans MusicServer Connect pour BPM/clé et corrigez l'ordre de la liste de lecture. Si WiiM Home a également besoin de listes de lecture fiables provenant du même serveur, MinimServer est une solution partagée adaptée. Les deux services lisent les mêmes fichiers musicaux.

Notes du fournisseur : Format M3U, UTF-8 et chemins relatifs ainsi que Partage manuel d'appareils dans le module complémentaire de streaming multimédia.

QNAP : Configurez Gerbera avec la correction WavPack étape par étape

Gerbera est un logiciel de serveur multimédia supplémentaire pour votre QNAP. Son principal avantage pour MusicServer Connect est l'accès aux valeurs déjà stockées dans vos fichiers musicaux : BPM et métadonnées des clés musicales: Le serveur multimédia UPnP intégré de QNAP ne fournit pas ces informations. Les étapes suivantes configurent les mappages de métadonnées requis.

Le support de la playlist peut également parler pour Gerbera : Le serveur UPnP standard QNAP décrit ici n'affiche pas les listes de lecture M3U8. Pour les formats M3U, PLS, ASX et WPL reconnus, l'ordre des pistes n'est pas conservé. Renommer M3U8 en M3U ne corrige donc pas l'ordre. Gerbera est une alternative si vous avez besoin de M3U8 ou d'un ordre de lecture exact.

Quand n’avez-vous pas besoin de Gerbera ? Si vos fichiers n'ont pas de valeur BPM/clé stockée et que l'ordre de la liste de lecture n'a pas d'importance, vous n'avez pas besoin de Gerbera à ces fins. VirtualDJ peut calculer BPM et la clé musicale en analysant les fichiers sans serveur de musique. Vous pouvez conserver le serveur multimédia intégré de QNAP et laisser VirtualDJ les calculer.

Le propre serveur multimédia de QNAP peut continuer à fonctionner aux côtés de Gerbera, par exemple pour WiiM Home Advanced Mode. Gerbera ne prend pas en charge ce mode WiiM. Votre musique reste dans son dossier existant ; Gerbera obtient un accès en lecture seule. Ce guide permet également la détection automatique des fichiers nouveaux et modifiés.

Version recommandée : Ce guide utilise la version officielle de Gerbera Git 3.3.0-77 à partir de la révision source 245e723. L'image Docker est définie avec la balise et la somme de contrôle SHA-256 ; il contient les corrections déjà demandées WavPack et titres de playlist répétés ainsi que plusieurs genres dans WebM/WMV et précision BPM plus élevée. Dans le cas d'une mise à jour avec une configuration existante, cela aussi Ajouter des mappages de lecteurs. Il s'agit d'un état de développement selon 3.3.0, et non d'une nouvelle version stable.

Gerbera 3.3.0 est incorrect lors de l'importation WavPack : L'image 3.3.0 inchangée peut être lue lors de la lecture à partir de .wvfichiers. Dans la version utilisée ici, la mémoire affectée est allouée sur le tas. WavPack reste entièrement utilisable ; aucun script de correctif supplémentaire n'est requis. Utilisez la référence d’image complète indiquée ci-dessus.

1. Préparer les dossiers, les utilisateurs et les fichiers

Connectez-vous à QTS avec un compte administrateur actif dont vous connaissez le mot de passe. Le compte intégré admin il n'est pas nécessaire de l'activer pour cela ; un autre compte administrateur autorisé suffit.
Installer dans Centre d'applications la demande Station à conteneurs. Ouvrez-le et terminez la configuration initiale. La console multimédia et le module complémentaire Media Streaming ne sont pas requis pour Gerbera.
Créer sous Panneau de configuration → Autorisation → Utilisateurs → Créer l'utilisateur gerbera . Cet utilisateur n'a pas besoin de droits d'administrateur. Accordez-lui un accès en lecture au partage de musique, y compris à ses dossiers et fichiers. Continuez à utiliser votre compte administrateur pour SSH.
Les exemples utilisent le dossier musique Public/music, sur le NAS /share/Public/music. Pour un autre partage, utilisez votre chemin actuel. Votre musique existante peut y rester. Supprimez les caractères illégaux Windows comme ? à partir des noms de fichiers et ajuster les références de playlist si nécessaire ; les balises de titre peuvent toujours contenir ces caractères.
Créer dans Station de fichiers sous Public le dossier gerbera-qnap et son sous-dossier vide empty .
Téléchargez le Composer le fichier sous la forme compose.yaml . Téléchargez-le directement via File Station sur Public/gerbera-qnap à côté du dossier empty. Le nom du fichier doit compose.yaml sans supplément .txt.

2. Activez SSH et obtenez l'accès à root

Ouvrir dans QTS Panneau de configuration → Services réseau et fichiers → Telnet/SSH.
Activer Autoriser la connexion SSH, quittez le port à 22 et cliquez sur Postuler. Si Modifier les autorisations d'accès est proposé, autorisez l'accès de votre compte administrateur à ce site. Si le pare-feu NAS est actif, le port SSH de votre ordinateur doit être autorisé sur le réseau local.
Ouvrez le terminal sur le Windows-PC ou PowerShell sur le terminal Mac. Remplacer dans la commande suivante DEIN_QTS_KONTO via votre compte administrateur et NAS_IP avec l'adresse IP QNAP.

ssh DEIN_QTS_KONTO@NAS_IP

Lors de la première connexion, vérifiez l'adresse de destination affichée et confirmez la requête avec yes. Entrez le mot de passe de votre compte QTS. Aucun caractère ni astérisque n'apparaît lors de la saisie. À utiliser si un autre port SSH est utilisé ssh -p PORTNUMMER DEIN_QTS_KONTO@NAS_IP.

Passez ensuite aux droits root :

sudo -i
id

Si vous demandez à nouveau votre mot de passe, utilisez le même mot de passe de votre compte QTS enregistré. Un mot de passe root spécial n'est pas nécessaire. La sortie de id doit uid=0 inclus; sur QNAP, le nom d'utilisateur associé peut être trouvé admin . Si un menu de gestion apparaît, quittez-le en utilisant son option Shell ou Quitter. Laissez le terminal ouvert pendant l'installation : toutes les commandes de terminal suivantes s'exécutent sur le QNAP.

Déterminez les identifiants de l'utilisateur créé pour l'accès à la musique :

id gerbera

Si la sortie montre uid=1001(gerbera) gid=100(everyone) est UID 1001 et GID 100. Notez vos propres numéros pour le fichier de composition.

3. Personnaliser le fichier de composition

Ouvrez celui téléchargé compose.yaml à l'aide d'un éditeur de texte, remplacez les exemples de valeurs pour UID et GID à travers les numéros de l'étape 2 et rechargez le fichier enregistré Public/gerbera-qnap élevé. Le mappage musical pointe initialement vers le dossier vide. La musique existante n'est importée qu'après la configuration des métadonnées.

services:
  gerbera:
    image: gerbera/gerbera:sha-245e723@sha256:b4463e92ee6cc0c6338b91d822904cb894dd66480e4eed60930fad1b69378e09
    container_name: gerbera-qnap
    network_mode: host
    restart: unless-stopped
    environment:
      # Beispielwerte: durch UID und GID aus "id gerbera" ersetzen.
      UID: "1001"
      GID: "100"
    command:
      - gerbera
      - --interface
      - eth0
      - --port
      - "49494"
      - --config
      - /var/run/gerbera/config.xml
    volumes:
      - gerbera-data:/var/run/gerbera
      # Zuerst den leeren Ordner verwenden; in Schritt 7 auf /share/Public/music aendern.
      - /share/Public/gerbera-qnap/empty:/mnt/content:ro

volumes:
  gerbera-data:

L'image officielle sélectionne la variante ARM64 ou AMD64 appropriée pour les modèles NAS pris en charge. Le modèle ne contient pas d'adresse IP NAS fixe. --interface eth0 utilise l'adresse de cette interface réseau. Pour les appareils dotés de plusieurs ports, de commutateurs virtuels ou d'un regroupement de ports, remplacez eth0 via l'interface réellement utilisée pour le réseau domestique. network_mode: host permet la détection UPnP dans le réseau NAS.

/mnt/content:ro reste inchangé en tant que chemin de conteneur et permet uniquement la lecture de la musique. Le volume gerbera-data enregistre les paramètres et la base de données en permanence. restart: unless-stopped redémarre le conteneur après un redémarrage de NAS s'il n'a pas été arrêté manuellement au préalable.

4. Démarrer l'application avec une bibliothèque vide

Ouvert Container Station → Applications → Créer. Utilisez le nom gerbera-qnap.
Ajoutez le contenu complet de votre personnalisé compose.yaml dans le champ YAML. Gardez les retraits avec des espaces et cliquez Valider.
Créez et lancez l'application. Le premier téléchargement de l'image peut prendre un certain temps. Attendez que gerbera-qnap est affiché comme actif.
Ouvert http://NAS_IP:49494/ dans votre navigateur. Une URL Web manquante dans Container Station n’empêche pas l’accès direct. A ce stade, la bibliothèque Gerbera est volontairement vide.

5. Configurer BPM, affichage des touches et du titre

Ouvrir dans Gerbera Configuration et choisissez à Liste de mode la vue Expert. Sous Library Options → taglib Library Options → métadonnées et sous ffmpeg Library Options → Métadonnées les mappages suivants. Conserver les autres lignes existantes.

Tag Name et Upnp metadata entry
Bibliothèque	Tag Name	Upnp metadata entry
taglib	BPM	upnp:beatsPerMinute
taglib	KEY	upnp:key
taglib	INITIALKEY	upnp:initialKey
ffmpeg	bpm	upnp:beatsPerMinute
ffmpeg	clé	upnp:key
ffmpeg	clé initiale	upnp:initialKey

Sous Serveur → Nom le nom Gerbera QNAP une. De cette façon, le serveur pourra ensuite être distingué des autres serveurs de musique.
Pour AIFF ci-dessous Importer → Mappages → Mimetype-ContentType les deux missions audio/x-aiff → aiff et audio/aiff → aiff supplément. Sans ces affectations, BPM, la clé et d'autres genres pourraient manquer malgré les balises existantes. Configuration AIFF.
Pour OGV ci-dessous ffmpeg Library Options l'option streams-enabled Activez pour que les balises soient lues à partir des pistes audio et vidéo. Configuration OGV.
Définir le champ pour taglib et ffmpeg charset sur UTF-8. Aussi filesystem-charset, metadata-charset et playlist-charset devrait UTF-8 utiliser.
Sous UPnP → Titre Élément de résultat vider le champ avec M_ARTIST et recevoir M_TITLE. Cela fournit le titre simple de la piste.
Sous WavPack Library Options reste Activé allumé.
Cliquez sur Enregistrer la configuration, redémarrez le conteneur vide dans Container Station et après avoir rouvert la configuration, vérifiez que les valeurs sont enregistrées.

BPM et Key doivent déjà être enregistrés dans les fichiers musicaux ; Gerbera ne calcule pas ces valeurs. Pour MP4/M4A/M4V dans l'existant id3élément prefer_highest_bpm_accuracy="yes" et prefer_ambigous_bpm_value="bpm_tag" selon Configurer la précision BPM aux valeurs indiquées. Sans la première option, le comportement précédent est conservé. Une nouvelle analyse normale peut ignorer les fichiers déjà importés et qui n'ont pas été modifiés. Configurez ces options avant d'importer de la musique pour la première fois. Les balises de genre distinctes ne nécessitent aucun paramètre supplémentaire.

6. Activer les mises à jour automatiques

Gerbera surveille déjà automatiquement les fichiers nouveaux et modifiés. Ajoutez la détection des modifications d'attributs de fichier avec ce bloc complet dans le terminal racine ouvert :

docker exec -i -u 0 gerbera-qnap /bin/sh <<'GERBERA'
set -eu
file=/var/run/gerbera/autoscan.xml
test -f "$file"
sed -i -e 's/inotify-attrib="no"/inotify-attrib="yes"/g' \
  -e '/<autoscan/ { /inotify-attrib=/! s/<autoscan/<autoscan inotify-attrib="yes"/; }' \
  "$file"
cat "$file"
GERBERA

Au début de la section d'analyse automatique de sortie, vous devez inotify-attrib="yes" debout. Le paramètre se trouve dans le volume de données persistantes et sera chargé au démarrage suivant.

7. Montez le dossier de musique et démarrez Gerbera

Arrêter le projet ou l'application gerbera-qnap dans la station à conteneurs.
Ouvert Public/gerbera-qnap/compose.yaml dans FileStation. Remplacez uniquement le mappage du dossier vide par votre dossier de musique réel, par exemple :

- /share/Public/music:/mnt/content:ro

Enregistrez le fichier sur le NAS, puis copiez l'intégralité du bloc suivant dans le terminal root ouvert. Il applique le fichier Compose modifié, réutilise le volume de données existant et démarre Gerbera. Si le chemin de votre projet diffère, ajustez la première ligne cd … sur. Le processus s'applique également aux fichiers WavPack.

cd /share/Public/gerbera-qnap &&
PROJECT=$(docker inspect --format '{{index .Config.Labels "com.docker.compose.project"}}' gerbera-qnap) &&
case "$PROJECT" in ''|'<no value>') printf 'Compose-Projekt nicht gefunden.\n' >&2; false ;; *) true ;; esac &&
if docker compose version >/dev/null 2>&1; then
  docker compose -p "$PROJECT" -f compose.yaml create --force-recreate gerbera
elif command -v docker-compose >/dev/null 2>&1; then
  docker-compose -p "$PROJECT" -f compose.yaml create --force-recreate gerbera
else
  COMPOSE_BIN=
  for candidate in /share/*/.qpkg/container-station/bin/docker-compose; do
    if [ -x "$candidate" ]; then COMPOSE_BIN=$candidate; break; fi
  done
  if [ -n "$COMPOSE_BIN" ]; then
    "$COMPOSE_BIN" -p "$PROJECT" -f compose.yaml create --force-recreate gerbera
  else
    printf 'Docker Compose wurde nicht gefunden. Container Station pruefen.\n' >&2
    false
  fi
fi &&
docker start gerbera-qnap

Puis ouvre-le http://NAS_IP:49494/ et attendez que la bibliothèque se charge. Vous pouvez voir les progrès ci-dessous Container Station → Conteneur → gerbera-qnap → Protocole. Continuez à copier uniquement les fichiers entièrement préparés dans le dossier de musique. Les listes de lecture nécessitent des chemins de fichiers relatifs valides et un encodage UTF-8.

8. Connectez MusicServer Connect

Dans MusicServer Connect, sélectionnez le serveur Gerbera QNAP. Utiliser pour une connexion manuelle http://NAS_IP:49494/description.xml. Vérifiez l'inventaire des pistes, les valeurs BPM/clés enregistrées et l'ordre de vos listes de lecture.

Si vous rencontrez des problèmes de connexion, vérifiez l'état du conteneur, l'adresse IP NAS, l'interface réseau et les éventuels conflits de ports. Pour la détection UPnP, il faut UDP 1900, pour l'interface web et l'accès aux médias TCP 49494 être accessible sur le réseau local. À Permission denied contrôler UID, GID et les autorisations de lecture de l'utilisateur Gerbera. Le chemin /content dans le protocole Gerbera est normal pour l'image officielle.

Quittez le terminal avec exit; après sudo -i cela est généralement requis deux fois. Si vous n'avez pas besoin de SSH, supprimez-le dans QTS Panneau de configuration → Services réseau et fichiers → Telnet/SSH la case à cocher pour Autoriser la connexion SSH et cliquez sur Postuler.

9. Redémarrages et versions plus récentes de Gerbera

Pour un redémarrage normal, sélectionnez Container Station → Conteneur → gerbera-qnap → Redémarrer. Les paramètres et la base de données restent dans le volume de données nommé gerbera-data reçu. Lors de la reconstruction du conteneur, l'exécutable inchangé de l'image officielle est utilisé.

Passage à partir d'une installation 3.3.0 existante

Utilisez la référence complète de l'image de ce guide et préservez les paramètres musicaux, les identifiants utilisateur, les noms de projets et les volumes de données. Recréez le conteneur comme indiqué ci-dessous. Un simple redémarrage n'installe pas une image différente. Le remplacement du conteneur supprime tout correctif binaire local précédent.

Mettre à niveau vers une version stable plus tard

Choisissez sur le page de sortie officielle de Gerbera une version stable qui inclut le correctif WavPack PR #3981 . Lisez les notes de configuration et de base de données. En attendant qu'une telle version soit disponible, la version de Git explicitement spécifiée ici est une version intermédiaire corrigée. N'utilisez pas un outil de déménagement latest- ou edgeétiquette.
Ouvert Public/gerbera-qnap/compose.yaml. Remplacez ça la valeur complète après image: à travers gerbera/gerbera:NEUE_VERSION. Cela inclut également la suppression des précédents @sha256:…référence, puisqu’elle appartient à l’ancienne image. Remplacer NEUE_VERSION avec le numéro de version sélectionné. Vous pouvez également utiliser la référence d’image complète du guide mis à jour. Gardez tous les autres paramètres inchangés.
Si nécessaire, activez SSH comme décrit ci-dessus et connectez-vous au terminal racine. Téléchargez l'image sélectionnée :

docker pull gerbera/gerbera:NEUE_VERSION

Arrêtez le projet ou l'application existant dans Container Station. Exécutez le bloc de commande complet Étape 7 dehors. Le volume de données existant ne doit pas être supprimé.
Attendez la fin du démarrage et de toute mise à niveau de la base de données. Vérifiez la version, le nom et le protocole du serveur, ainsi que les paramètres BPM/clés enregistrés. Connectez MusicServer Connect et vérifiez plusieurs pistes, fichiers WavPack et listes de lecture.

Guides des fournisseurs : Modifications de QNAP Container Station et YAML, Activer SSH sur QNAP, Créer un utilisateur QTS, Image Docker officielle de Gerbera.

Synology : Configurez Gerbera avec la correction WavPack étape par étape

Gerbera est un logiciel de serveur multimédia supplémentaire pour votre Synology. Son principal avantage pour MusicServer Connect est l'accès aux valeurs déjà stockées dans vos fichiers musicaux : BPM et métadonnées des clés musicales: Le serveur multimédia UPnP intégré de Synology ne fournit pas ces informations. Les étapes suivantes configurent les mappages de métadonnées requis.

Quand n’avez-vous pas besoin de Gerbera ? Si vos fichiers musicaux ne contiennent aucune valeur BPM/clé stockée, vous n'avez pas besoin de Gerbera à cette fin. VirtualDJ peut calculer BPM et la clé musicale en analysant les fichiers sans serveur de musique. Vous pouvez continuer à utiliser le serveur multimédia intégré de Synology et laisser VirtualDJ les calculer.

Le propre serveur multimédia de Synology peut continuer à fonctionner aux côtés de Gerbera, par exemple pour WiiM Home Advanced Mode. Gerbera ne prend pas en charge ce mode WiiM. Votre musique reste dans son dossier existant ; Gerbera obtient un accès en lecture seule. Ce guide permet également la détection automatique des fichiers nouveaux et modifiés.

1. NAS et préparer les utilisateurs

Connectez-vous à l'interface Synology DSM avec un compte appartenant au groupe administrateur entendu. Il s'agit d'un compte autorisé à gérer les packages et les utilisateurs. Il n'est pas nécessaire que le nom du compte admin lire. Si votre compte ne dispose pas de ces droits, vous aurez besoin de la personne qui gère le NAS.
Ouvre ceci Centre de colis et installer Gestionnaire de conteneurs. Si ce package n'est pas disponible pour votre modèle, ce guide ne s'y applique pas. Pour modifier le fichier YAML, vous pouvez également installer le package Synology Éditeur de texte installer.
Ouvert Panneau de configuration → Utilisateurs et groupe → Utilisateurs → Créer. Créer l'utilisateur gerbera sur. Il ne nécessite pas de droits d'administrateur. Attribuez votre propre mot de passe ; Vous continuerez à utiliser votre compte administrateur DSM pour les commandes de terminal suivantes.
Ouvert Panneau de configuration → Dossier partagé, sélectionnez votre dossier de musique, par exemple music, et choisissez Modifier → Autorisations. Donner à l'utilisateur gerbera autorisation Lecture seule. L'accès doit également s'appliquer aux dossiers et fichiers musicaux inclus.

Les exemples utilisent /volume1/music comme dossier de musique et /volume1/docker pour les fichiers conteneurs. Si ces dossiers se trouvent sur un volume différent, utilisez leurs chemins NAS réels aux emplacements appropriés. Les chemins des conteneurs /mnt/content et /var/run/gerbera reste le même.

2. Créer des dossiers et copier des fichiers

Ouvert Station de fichiers. Dans le dossier partagé, créez docker le sous-dossier gerbera-synology . Si le dossier partagé docker est manquant, créez-le sous Panneau de configuration → Dossier partagé → Créer .
Créez un autre sous-dossier nommé empty sur. Ce dossier reste vide. Il sert de dossier musical temporaire afin que l'importation ne commence qu'une fois les métadonnées définies.
Téléchargez le Composer le fichier sous la forme compose.yaml à votre ordinateur.
Téléchargez le fichier en utilisant File Station → Télécharger directement dans docker/gerbera-synology à côté du dossier empty. Le nom du fichier doit être exactement compose.yaml sans supplément .txt être attaché.

Le dossier du projet contient ces deux entrées :

gerbera-synology/
├── compose.yaml
└── empty/

3. Activez SSH, connectez-vous à NAS et déterminez vos identifiants

Vous avez besoin d'un accès terminal au NAS pour rechercher les ID utilisateur et exécuter les commandes Docker suivantes. Vous pouvez copier les commandes affichées ici ; des connaissances en programmation ne sont pas requises.

Vérifiez le compte DSM et le mot de passe

Ouvrir dans DSM Panneau de configuration → Utilisateur et groupe → Utilisateur. Mettez en surbrillance le compte que vous souhaitez utiliser pour vous connecter ultérieurement via SSH et cliquez sur Modifier.
Le compte doit être activé : Si nécessaire, supprimez la sélection Désactiver ce compte utilisateur. Après l'enregistrement, la liste des utilisateurs doit afficher le statut Normale à la place Désactivé sont affichés.
Sous Groupes d'utilisateurs le compte doit appartenir à administrateur groupe. Vous avez besoin du mot de passe de ce compte pour vous connecter et passer ultérieurement à root. Si vous ne le connaissez pas, définissez et confirmez un nouveau mot de passe dans les paramètres du compte. Enregistrez les modifications.

Vous pouvez utiliser votre compte administrateur DSM existant pour ce faire. Voulez-vous spécifiquement le compte intégré admin Pour l'utiliser, activez ce compte comme décrit et attribuez un mot de passe connu. Le compte intégré admin n'a pas besoin d'être activé si vous avez un autre compte actif du groupe administrators utiliser. L'utilisateur créé à l'étape 1 gerbera est utilisé exclusivement pour l'accès à la musique et ne nécessite pas ces droits d'administrateur.

Activez le service SSH sur le NAS

Dans DSM, ouvrez le Panneau de configuration et là Terminal et SNMP. Sélectionnez l'onglet Borne.
Cochez la case pour Activer le service SSH. Pour ce guide, quittez le port à 22 sont affichés.
Cliquez sur Postuler. Ce n'est qu'alors que le NAS acceptera les connexions SSH. Si le pare-feu DSM est actif, il doit autoriser le port SSH défini pour votre ordinateur sur le réseau local.

Connectez-vous depuis votre ordinateur et passez à root

Vous pouvez trouver l'adresse IP NAS sur Panneau de configuration → Réseau → Interface réseau. Ouvrir sur le PC Windows Borne ou PowerShell; sur un Mac, l'application Borne.
Entrez cette commande. Remplacer DEIN_DSM_KONTO avec votre compte administrateur DSM et NAS_IP avec votre adresse IP NAS. Ne pas utiliser l'utilisateur nouvellement créé gerbera.

ssh DEIN_DSM_KONTO@NAS_IP

Lorsque la connexion est établie pour la première fois, une requête concernant l'identité du NAS peut apparaître. Vérifiez l'adresse de destination affichée et confirmez la connexion avec yes. Saisissez ensuite le mot de passe de votre compte DSM. Aucun caractère ni astérisque n'apparaît lorsque vous saisissez le mot de passe ; c'est normal. Si vous utilisez un autre port SSH, ajoutez-le lors de la connexion. -p PORTNUMMER.

Basculez ensuite vers les droits requis pour Docker avec cette commande :

sudo -i

Si on vous demande à nouveau un mot de passe, utilisez le même mot de passe de votre compte DSM. Un mot de passe root spécial n'est pas requis. L'invite se termine généralement par #. Gardez cette fenêtre de terminal ouverte pendant l'installation. Toutes les commandes de terminal suivantes y sont exécutées sur le NAS.

Pour Connection refused Vérifiez d'abord si vous utilisez le service SSH Postuler allumés et utilisent l’adresse IP et le numéro de port corrects. Si le mot de passe est rejeté, vérifiez le nom du compte, le mot de passe et le statut. Normale et l'adhésion à administrateur. Guide de Synology sur la connexion SSH avec les privilèges root décrit également ce processus.

Afficher les ID utilisateur Gerbera :

id gerbera

Sortie telle que uid=1030(gerbera) gid=100(users) signifie : UID est 1030, GID est 100. Notez les numéros de votre propre sortie : ils identifient l'utilisateur et le groupe.

4. Personnaliser le fichier de composition

Dans File Station, ouvrez le fichier docker/gerbera-synology/compose.yaml avec Éditeur de texte. Vous pouvez également le modifier sur votre ordinateur et le télécharger à nouveau. Pour UID et GID entrez les chiffres que vous venez de noter ; vous devez remplacer les exemples de valeurs ci-dessous. Si nécessaire, ajustez le chemin NAS vers le dossier de projet vide. Enregistrez le fichier.

services:
  gerbera:
    image: gerbera/gerbera:sha-245e723@sha256:b4463e92ee6cc0c6338b91d822904cb894dd66480e4eed60930fad1b69378e09
    container_name: gerbera-synology
    network_mode: host
    restart: unless-stopped
    environment:
      # Beispielwerte: durch UID und GID aus "id gerbera" ersetzen.
      UID: "1026"
      GID: "100"
    command:
      - gerbera
      - --port
      - "49494"
      - --config
      - /var/run/gerbera/config.xml
    volumes:
      - gerbera-synology-data:/var/run/gerbera
      # Zuerst den leeren Ordner verwenden; in Schritt 8 auf /volume1/music aendern.
      - /volume1/docker/gerbera-synology/empty:/mnt/content:ro

volumes:
  gerbera-synology-data:

network_mode: host permet la détection dans le réseau domestique sans adresse IP fixe dans le YAML. La fin :ro Gerbera permet uniquement de lire le dossier musical. En volumes gerbera-synology-data Les paramètres et la base de données sont enregistrés de manière permanente. restart: unless-stopped permet au conteneur NAS de redémarrer après un redémarrage de NAS, à condition que vous ne l'ayez pas arrêté manuellement au préalable.

5. Démarrer le projet avec une bibliothèque vide

Ouvert Gestionnaire de conteneurs → Projet → Créer. Utilisez exactement ce nom de projet : gerbera-synology et le dossier préparé comme chemin docker/gerbera-synology.
Choisissez celui préparé compose.yaml en tant que fichier Compose existant. Si la boîte de dialogue propose un éditeur YAML, vous pouvez y insérer le contenu.
Pour Paramètres du portail Web reste Configurer le portail Web via Web Station éteint. Cliquez sur Suivant et créer et démarrer le projet. Le premier téléchargement de l'image peut prendre un certain temps.
Sous Conteneur → gerbera-synology doit être le statut Courir ou Courir apparaître.
Ouvrir dans le navigateur http://NAS_IP:49494/, par exemple http://192.168.1.10:49494/. Remplacez l'exemple d'adresse par votre IP NAS. Vous voyez la surface de Gerbera ; la bibliothèque musicale est intentionnellement vide à ce stade.

6. Configurer BPM, affichage des touches et du titre

Ouvrir dans Gerbera Configuration et sélectionnez la vue Expert. Sous Library Options → taglib Library Options → métadonnées ainsi que sous ffmpeg Library Options → Métadonnées ajoutez les lignes suivantes, en conservant les autres mappages existants.

Tag Name et Upnp metadata entry
Bibliothèque	Tag Name	Upnp metadata entry
taglib	BPM	upnp:beatsPerMinute
taglib	KEY	upnp:key
taglib	INITIALKEY	upnp:initialKey
ffmpeg	bpm	upnp:beatsPerMinute
ffmpeg	clé	upnp:key
ffmpeg	clé initiale	upnp:initialKey

Sous Serveur → Nom le nom Gerbera Synology une. De cette façon, le serveur pourra ensuite être distingué des autres serveurs de musique.
Pour AIFF ci-dessous Importer → Mappages → Mimetype-ContentType les deux missions audio/x-aiff → aiff et audio/aiff → aiff supplément. Sans ces affectations, BPM, la clé et d'autres genres pourraient manquer malgré les balises existantes. Configuration AIFF.
Pour OGV ci-dessous ffmpeg Library Options l'option streams-enabled Activez pour que les balises soient lues à partir des pistes audio et vidéo. Configuration OGV.
Définir le champ charset pour taglib et ffmpeg à UTF-8. Aussi filesystem-charset, metadata-charset et playlist-charset devrait UTF-8 utiliser.
Sous UPnP → Titre Élément de résultat vider le champ avec M_ARTIST et recevoir M_TITLE. Le nom du titre pur est transféré comme titre au lieu de « Artiste – Titre ».
Sous WavPack Library Options reste Activé allumé.
Cliquez sur Enregistrer la configuration, redémarrez le conteneur dans Container Manager et vérifiez que les valeurs sont enregistrées après la réouverture de la configuration Gerbera.

BPM et Key doivent déjà être enregistrés dans les fichiers musicaux ; ces paramètres ne calculent pas les valeurs. Pour MP4/M4A/M4V dans l'existant id3élément prefer_highest_bpm_accuracy="yes" et prefer_ambigous_bpm_value="bpm_tag" selon Configurer la précision BPM aux valeurs indiquées. Sans la première option, le comportement précédent est conservé. Importez ensuite à nouveau les fichiers concernés.

7. Activer les mises à jour automatiques

Gerbera surveille déjà automatiquement les fichiers nouveaux et modifiés. Avec le bloc suivant, vous pouvez ajouter la détection des modifications des attributs du fichier. Copiez l'intégralité du bloc dans le terminal NAS encore ouvert :

docker exec -i -u 0 gerbera-synology /bin/sh <<'GERBERA'
set -eu
file=/var/run/gerbera/autoscan.xml
test -f "$file"
sed -i -e 's/inotify-attrib="no"/inotify-attrib="yes"/g' \
  -e '/<autoscan/ { /inotify-attrib=/! s/<autoscan/<autoscan inotify-attrib="yes"/; }' \
  "$file"
cat "$file"
GERBERA

La sortie doit être au début de la section d'analyse automatique inotify-attrib="yes" debout. Le fichier se trouve dans le volume de données permanent. Le paramètre sera chargé avec le dossier de musique lorsque vous le démarrerez ensuite.

8. Montez le dossier de musique et démarrez Gerbera

Arrêter le projet ou l'application gerbera-synology dans le gestionnaire de conteneurs.
Ouvert docker/gerbera-synology/compose.yaml dans FileStation. Remplacez uniquement le mappage du dossier vide par votre dossier de musique réel, par exemple :

- /volume1/music:/mnt/content:ro

cd /volume1/docker/gerbera-synology &&
if docker compose version >/dev/null 2>&1; then
  docker compose -p gerbera-synology -f compose.yaml create --force-recreate gerbera
elif command -v docker-compose >/dev/null 2>&1; then
  docker-compose -p gerbera-synology -f compose.yaml create --force-recreate gerbera
elif [ -x /var/packages/ContainerManager/target/usr/bin/docker-compose ]; then
  /var/packages/ContainerManager/target/usr/bin/docker-compose \
    -p gerbera-synology -f compose.yaml create --force-recreate gerbera
else
  printf 'Docker Compose wurde nicht gefunden. Container Manager pruefen.\n' >&2
  false
fi &&
docker start gerbera-synology

Puis ouvre-le http://NAS_IP:49494/ et attendez que la bibliothèque se charge. Vous pouvez voir les progrès ci-dessous Gestionnaire de conteneurs → Conteneur → gerbera-synology → Protocole. Continuez à copier uniquement les fichiers entièrement préparés dans le dossier de musique. Les listes de lecture nécessitent des chemins de fichiers relatifs valides et un encodage UTF-8.

9. Connectez-vous avec MusicServer Connect

Dans MusicServer Connect, sélectionnez le serveur Gerbera Synology. Si une URL d'appareil est nécessaire, utilisez http://NAS_IP:49494/description.xml. Vérifiez vos chansons, albums et listes de lecture et ouvrez certaines chansons avec BPM et valeurs clés enregistrées.

Si l'interface n'est pas accessible ou si le serveur est introuvable, vérifiez d'abord l'état du conteneur et l'adresse IP du NAS. Si le pare-feu DSM est activé TCP 49494 et pour la détection UPnP UDP 1900 depuis votre réseau local. Si le journal indique Permission denied pour le dossier de musique, vérifiez l'autorisation de lecture de l'utilisateur gerbera et les UID et GID de l'étape 3. Le chemin /content dans le protocole, c'est normal pour l'image officielle ; il fait référence au dossier de musique intégré.

Ensuite, quittez le terminal avec exit partir; après sudo -i est généralement deux fois exit nécessaire. Si vous n'avez pas besoin de SSH, ouvrez-le dans DSM Panneau de configuration → Terminal et SNMP → Terminal, décochez la case correspondant à Activer le service SSH et cliquez sur Postuler.

10. Redémarrages et versions plus récentes de Gerbera

Pour un redémarrage normal, sélectionnez Gestionnaire de conteneurs → Conteneur → gerbera-synology → Redémarrer. Les paramètres et la base de données restent dans le volume de données nommé gerbera-synology-data reçu. Lors de la reconstruction du conteneur, l'exécutable inchangé de l'image officielle est utilisé.

Passage à partir d'une installation 3.3.0 existante

Mettre à niveau vers une version stable plus tard

Choisissez sur le page de sortie officielle de Gerbera une version stable qui inclut le correctif WavPack PR #3981 . Lisez les notes de configuration et de base de données. En attendant qu'une telle version soit disponible, la version de Git explicitement spécifiée ici est une version intermédiaire corrigée. N'utilisez pas un outil de déménagement latest- ou edgeétiquette.
Ouvert docker/gerbera-synology/compose.yaml. Remplacez ça la valeur complète après image: à travers gerbera/gerbera:NEUE_VERSION. Cela inclut également la suppression des précédents @sha256:…référence, puisqu’elle appartient à l’ancienne image. Remplacer NEUE_VERSION avec le numéro de version sélectionné. Vous pouvez également utiliser la référence d’image complète du guide mis à jour. Gardez tous les autres paramètres inchangés.
Si nécessaire, activez SSH comme décrit ci-dessus et connectez-vous au terminal racine. Téléchargez l'image sélectionnée :

docker pull gerbera/gerbera:NEUE_VERSION

Arrêtez le projet ou l'application existant dans Container Manager. Exécutez le bloc de commande complet Étape 8 dehors. Le volume de données existant ne doit pas être supprimé.
Attendez la fin du démarrage et de toute mise à niveau de la base de données. Vérifiez la version, le nom et le protocole du serveur, ainsi que les paramètres BPM/clés enregistrés. Connectez MusicServer Connect et vérifiez plusieurs pistes, fichiers WavPack et listes de lecture.

Guides des fournisseurs : Projets de gestionnaire de conteneurs, Modèles NAS disponibles pour Container Manager, Connexion SSH avec droits d'administrateur, Image officielle du Gerbera.

WiiM Home : médiathèque étendue

WiiM Home Advanced Mode fournit sa propre vue de bibliothèque avec des catégories d'album, d'artiste et de piste. Les serveurs pris en charge incluent MinimServer, le serveur standard de Synology, le serveur standard de QNAP et Serviio. Gerbera fournit actuellement la vue des dossiers dans WiiM Home.

Dans Advanced Mode, WiiM importe les métadonnées du serveur dans son propre index, puis crée des vues uniformes d'album, d'artiste, de piste, de liste de lecture et de genre ainsi que sa propre recherche. Dans Legacy Mode, il affiche à la place la navigation du serveur. Ces termes décrivent les modes de fonctionnement du WiiM Home.

Recommandation de partage

Les serveurs standard Synology et QNAP prennent en charge WiiM Home Advanced Mode, qui n'a pas besoin de BPM ni de métadonnées clés. L'ordre incorrect des listes de lecture de QNAP reste également une limitation dans WiiM Home.

Si VirtualDJ calcule BPM et se clé lui-même, le serveur multimédia standard de Synology est suffisant pour MusicServer Connect. La même chose s'applique à QNAP si son ordre de liste de lecture incorrect est acceptable. Une installation supplémentaire du Gerbera est inutile dans ces cas.

Pour utiliser les valeurs BPM/clés stockées ou conserver l'ordre de la liste de lecture QNAP dans MusicServer Connect, vous pouvez ajouter Gerbera avec la correction WavPack dans Docker. Sélectionnez Gerbera dans le plugin et le serveur standard dans WiiM Home Advanced Mode. Les deux peuvent lire la même bibliothèque musicale. MinimServer reste une solution à serveur unique couvrant ces exigences et WiiM Home Advanced Mode ; il a toujours besoin de la configuration supplémentaire BPM/key tag. L'exécution de Gerbera sur Synology nécessite un gestionnaire de conteneurs disponible.

Informations complémentaires : WiiM Home : bibliothèque multimédia et serveurs pris en charge.

Ampache 7/8 : lire des vidéos et des listes de lecture de fichiers

Un catalogue musical n'importe pas de vidéos dans Ampache. Pour la vidéothèque, un catalogue local supplémentaire avec le type de média Vidéo et scannez-le. Les chemins du catalogue ne doivent pas se chevaucher. Notre configuration utilise donc une vue supplémentaire du répertoire Linux en lecture seule pointant vers les mêmes fichiers vidéo ; les fichiers de la bibliothèque partagée restent inchangés.

Importez explicitement des listes de lecture basées sur des fichiers. La commande CLI officielle est php bin/cli run:updateCatalog -i "Katalogname"; utilisez la version PHP et le compte de service appropriés à votre installation. Une nouvelle analyse des métadonnées à elle seule ne suffit pas. Les deux versions fournissaient des entrées audio avec des répétitions dans notre comparaison ; les entrées vidéo étaient absentes des listes de lecture de fichiers mixtes.

Livrer MP3 inchangé

Si la conversion automatique MP3 est autorisée mais qu'aucun convertisseur n'est configuré, Ampache 8 peut renvoyer HTTP 500 lors de la diffusion. Pour une livraison inchangée dans la configuration existante, transcode_mp3 = "false" à la valeur indiquée. Vous pouvez également configurer un transcodeur fonctionnel. Avec la conversion MP3 désactivée, le streaming et le téléchargement ont été vérifiés octet par octet lors de nos contrôles.

LMS : listes de lecture avec des morceaux du même album

Dans les paramètres LMS sous Divers l'option Ignorer les listes de lecture contenant des morceaux du même album si vous souhaitez que ces listes de lecture apparaissent. Rechargez ensuite la bibliothèque. La comparaison a confirmé que les pistes audio répétées étaient fournies dans leur ordre d'origine.

Asset UPnP : dossiers multimédia et playlist

Dans l'interface Web de l'actif à l'adresse Dossiers → Dossiers multimédias ajoutez le dossier de la bibliothèque. Sous Dossiers de liste de lecture spécifiez chaque dossier contenant des fichiers de liste de lecture individuellement ; Les dossiers de playlist subordonnés n'y sont pas automatiquement inclus. Ceux-ci sont en cours de test /srv/music/Playlists et /srv/music/Format-Test-1.3/Playlists.

Sous Options → Paramètres d'affichage Désactivez les préfixes pour les numéros de piste, les artistes avant les pistes de compilation et les artistes après les titres de playlist si vous souhaitez des noms de piste simples. Ces paramètres modifient l'affichage, pas les fichiers musicaux. Le fournisseur d'actifs utilise la branche intégrée Listes de lecture pour les listes de lecture de fichiers. Cette requête ne traverse pas de manière récursive les combinaisons de filtres dynamiques ou la radio Internet. La navigation par défaut cochée, y compris la navigation dynamique, peut être conservée. Les vues du catalogue, de l'artiste, de l'album et du genre ont été vérifiées sans erreurs de récupération après cet ajustement. Fournitures d'actifs M3U, M3U8 et PLS ; Les titres des pistes PLS renvoyés par le serveur peuvent contenir un préfixe d'artiste.

Guide des actifs

Jellyfin 12.2.0 : DLNA et profil client

Jellyfin nécessite celui officiel pour MusicServer Connect Plugin DLNA. Installez-le depuis le catalogue officiel des plugins dans l'administration du serveur et redémarrez Jellyfin. DLNA 14.0.0.0 a été vérifié. Dans ses paramètres, choisissez le compte dont les bibliothèques doivent être exposées via DLNA. MusicServer Connect utilise UPnP/DLNA, indépendamment de la connexion à la propre interface Web de Jellyfin.

Bibliothèques et métadonnées

Fichiers audio en tant que type de bibliothèque Musique, des vidéos comme Vidéoclips comme bibliothèques. Rendez les dossiers multimédias et de playlist pertinents lisibles, puis analysez les deux bibliothèques. Pour utiliser uniquement les balises de fichiers, désactivez les fournisseurs de métadonnées et d'images externes ; vérifiez également les paramètres globaux de l’artiste et de l’album. Gardez les titres intégrés et les images locales activés. Notre configuration accède à la bibliothèque musicale partagée en lecture seule.

Profil client pour MusicServer Connect

Le Téléchargez un profil client DLNA vérifié et comme MusicServer Connect.xml Enregistrez dans le dossier du profil utilisateur du plugin DLNA. C'est plus faible pour l'installation native de Debian /var/lib/jellyfin/plugins/configurations/dlna/user/; pour les autres installations, utilisez le répertoire de données Jellyfin actuel. Le service Jellyfin doit être capable de lire le fichier. Redémarrez Jellyfin, puis actualisez la bibliothèque du plugin.

Le profil identifie MusicServer Connect par son User-Agent. Il fournit des URL de ressources stables et des types de médias corrects pour l'audio M4A et la vidéo OGV, gardant les vues d'album accessibles et ces formats visibles dans le catalogue. Il est stocké séparément des profils système fournis.

Restrictions restantes

Toutes les sources audio et vidéo ainsi que les vues du plugin 195 ont été récupérées sans erreurs lors de la vérification avec les fichiers 125. Sur DLNA, Jellyfin ne fournit aucune clé BPM et ne met pas à l'échelle les débits binaires. ASX/XSPF sont absents ; Les M3U, M3U8, PLS et WPL perdent les pistes répétées. Certaines anciennes listes M3U/M3U8 sont également incomplètes. Certains artistes d'album sont mal attribués et les dossiers de musique plats peuvent ne pas avoir de vue d'album native. WMA n’a pas son deuxième genre ; les vidéos manquent d'artiste, d'album et de genre. Le profil client ne corrige pas ces limitations.

Installation officielle du Linux · Documentation officielle DLNA

WiiM Home, Mezzmo et Windows Media Player

Avec ces serveurs Windows, MusicServer Connect utilise automatiquement les dossiers de pistes ou de fichiers vérifiés pour éviter des réponses de recherche globale incorrectes ou très lentes. Aucun paramètre de plugin supplémentaire n'est nécessaire. Les recherches de plugins sont ensuite exécutées sur le catalogue importé.

Les réponses UPnP peuvent prendre jusqu'à 30 secondes, ou 60 secondes pour Windows Media Player. Les demandes restent annulables. Les pages invalides ou changeantes sont toujours rejetées ; attendre plus longtemps ne peut pas fournir les fichiers ou métadonnées manquants.

WiiM Home Media Server 0.2.10.5

Les serveurs de musique et VirtualDJ peuvent fonctionner sur le même PC Windows, y compris plusieurs serveurs à la fois. La liste des serveurs combine la découverte UPnP normale avec une vérification supplémentaire des serveurs locaux pris en charge. Il identifie leurs ports réellement ouverts et vérifie les descriptions des périphériques UPnP. Les différents identifiants d'appareil restent séparés ; plusieurs points de terminaison pour un serveur ne créent pas d'entrées en double. Les droits d'administrateur ne sont pas requis.

La découverte UPnP normale de Windows n'a pas trouvé WiiM Home sur le même PC lors de notre vérification, bien que la description de son appareil soit accessible. La découverte supplémentaire du plugin le trouve comme WiiM Home: LaptopAcer — sur un autre PC, utilisez plutôt son nom. Dans la boîte de dialogue de connexion, cliquez sur Rechercher à nouveau et sélectionnez le serveur WiiM. Cette connexion UPnP ne nécessite aucun nom d'utilisateur ni mot de passe. WiiM Home, Mezzmo et Windows Media Player ont été vérifiés en fonctionnement simultané.

Pour une ancienne version du plugin, l'adresse de description complète peut être temporairement enregistrée dans URL du serveur ici. Par exemple, le chemin local vérifié est http://127.0.0.1:22346/upnp/DeviceDescription.xml. Le port et le chemin doivent appartenir au serveur en cours d'exécution ; le plugin ne suppose pas de port fixe. Sur cet ordinateur, le port 22345 exposait également le même serveur WiiM. Le nom d'hôte écrit localhost a retourné HTTP 404 par chèque direct et n'a pas été accepté comme remplacement équivalent. L'échec de la découverte ne peut être attribué de manière concluante ni à WiiM Home ni à Windows.

Ajoutez le dossier musical à la bibliothèque multimédia locale et activez le partage DLNA. La source originale a été utilisée dans le test \\smbserver\music . Cette interface ne fournit ni listes de lecture ni vidéos basées sur des fichiers ; AAC ADTS, Opus et WavPack sont également absents. Les listes de lecture enregistrées dans l'application WiiM ne démontrent pas la prise en charge de l'importation de fichiers de listes de lecture externes.

Mezzmo 6.0.6.0

Ajoutez le dossier Bibliothèque comprenant les sous-dossiers. Listes de lecture de fichiers externes séparées via Créer une playlist → Playlist connectée . « Ajouter des fichiers à partir d'une liste de lecture externe » importe les médias référencés et constitue une opération différente. Pour conserver les balises du fichier d'origine, laissez la récupération et l'écriture automatiques des métadonnées Internet désactivées.

Offre de propriétés de dossier Vérifiez les dossiers pour les nouveaux fichiers chaque. Les listes déjà chaînées ont des résultats distincts. La surveillance des dossiers à elle seule n'a pas permis de créer des listes chaînées à partir de fichiers de playlist, même avec des extensions de playlist supplémentaires configurées. La mise à jour d'un lien existant et la découverte de nouveaux fichiers de playlist sont des fonctionnalités différentes. Les listes vérifiées séparément perdent les répétitions avec M3U/PLS/WPL ; M3U8/XSPF restent vides et les deux exemples ASX signalent un nombre de pages incohérent. Les playlists intelligentes ne peuvent pas remplacer un ordre externe fixe par des répétitions.

Le filtre par défaut inclut .aif mais pas .aiff. L'ajout de *.aiff a indexé l'échantillon uniquement en tant que type de fichier inconnu sans flux, cette modification a donc été annulée. WavPack n'a pas non plus été exposé comme jouable pour le client vérifié. Une entrée dans la base de données ne prouve pas à elle seule la jouabilité.

Windows Media Player Héritage / Partage 12.0

Sous Panneau de configuration → Centre Réseau et partage → Options de diffusion multimédia sur Autoriser tout cliquez et avec OK sauvegarder. Cela permet aux appareils du réseau local, y compris WiiM et au téléphone portable avec WiiM Home, d'accéder à la médiathèque. À Accès refusé Vérifiez l'approbation de cet appareil : L'accès au plugin fonctionnel sur le même PC ne signifie pas que les appareils externes sont autorisés.

Activez le streaming multimédia pour le réseau local et ajoutez des dossiers de musique et de vidéo locaux à leurs bibliothèques Windows. Vous pouvez désactiver la récupération et l'écriture automatiques des métadonnées Internet pour préserver les fichiers source. La comparaison locale complète a renvoyé des fichiers multimédias réels 146 et a entièrement décodé tous les échantillons de format proposés par 20. OGG, Opus, WavPack, WebM et OGV étaient absents ; BPM et la clé n'ont pas été fournis. Après avoir reconstruit le catalogue WMP, six listes de lecture non vides ont été renvoyées. Certains noms diffèrent des listes importées ; deux anciennes listes M3U perdent une piste à cause du codage des caractères. Leurs équivalents WPL contiennent les quatre pistes.

Utilisez des noms de playlist sans points, par exemple MSC Mixte 1-3 à la place MSC Mixte 1.3. Dans la comparaison ciblée WPL, M3U et M3U8, WMP a tronqué les noms de copie d'importation enregistrée au premier point ; le nom abrégé est également apparu sur UPnP. Un trait d'union préservait le nom complet.

Pour WMP, le plugin demande des listes de structure uniquement avec un petit filtre de métadonnées. Les métadonnées complètes des pistes, les ressources et le contenu des listes de lecture sont toujours lus, les contrôles de pagination et de cohérence étant conservés. Pour cette bibliothèque, le nettoyage et l'optimisation du plug-in ont réduit la première demande de catalogue mesurée d'environ 22 secondes à 4.3–4.6 secondes. Il s'agit d'une mesure du fournisseur pour la bibliothèque vérifiée, et non d'une promesse générale pour l'interface de VirtualDJ ou des bibliothèques plus grandes.

Si votre collection contient également des fichiers de liste de lecture, ajoutez uniquement les sous-dossiers audio réels à la bibliothèque musicale Windows et ajoutez les dossiers vidéo séparément. Importez explicitement des listes de lecture dans WMP. L'ajout de l'intégralité du dossier parent a amené WMP à exposer certains fichiers de liste de lecture sous forme de pistes audio ou de listes vides. Les importations répétées ont créé des copies WPL supplémentaires dans le dossier Windows. Musique → Listes de lecture. Avant la reconstruction, sauvegardez le catalogue WMP et archivez les anciennes copies d'importation clairement identifiées en dehors des dossiers surveillés ; la reconstruction de la base de données seule les indexerait à nouveau. Les médias et listes de lecture originaux sont conservés.

Les fichiers multimédias sur le partage SMB ne fonctionnaient pas comme bibliothèque WMP DLNA lors de notre test, même via le lecteur réseau Y:. Le service pouvait lire un fichier original et Samba permettait déjà la lecture et l'écriture, mais le catalogue multimédia partagé restait vide. Ce résultat s'applique à la source réseau vérifiée ici, et non à toutes les configurations SMB. Les fichiers locaux sont couverts par la vérification locale distincte.

Les fichiers hors ligne Windows n'ont pas été utilisés car ils créent une copie locale synchronisée. Après le redémarrage du service, la description de l'appareil WMP et UPnP root étaient à nouveau accessibles en trois secondes environ lors de notre vérification. Une entrée de serveur manquante initialement ne nécessite pas automatiquement de reconstruire sa bibliothèque.

Documentation du fabricant

Configuration Gerbera

Gonic : dossiers de musique

MinimServer : Configuration

MariaDB : modifier les colonnes de la base de données