Vous avez déjà copié vos MP3 ou FLAC dans Nextcloud, mais leur lecture dossier par dossier reste peu pratique. En 2026, Nextcloud Music transforme ces fichiers en bibliothèque audio classée par artistes, albums, genres ou répertoires. L'application ajoute un lecteur web, des playlists, des radios internet, des podcasts et des interfaces Ampache et Subsonic pour certains lecteurs externes.
Le stockage reste celui de Nextcloud. Music indexe les métadonnées nécessaires à la navigation sans créer un service séparé. Ce guide couvre l'installation, l'indexation, les lecteurs externes et le dépannage.
Que fait Nextcloud Music avec vos fichiers audio ?
Music est une application communautaire distribuée par l'App Store Nextcloud. Elle analyse les fichiers audio accessibles dans le compte, lit leurs métadonnées et construit une bibliothèque. Les morceaux peuvent ensuite être parcourus par artiste, album, genre ou dossier. Un mini-lecteur apparaît aussi dans l'application Fichiers, tandis qu'un widget peut être ajouté au tableau de bord Nextcloud.
L'application ne remplace pas le gestionnaire de fichiers. Un morceau reste un fichier ordinaire que vous pouvez synchroniser, partager ou restaurer. Music conserve un index en base de données pour retrouver le titre, l'album, l'artiste, la piste et la pochette. Le guide complet de Nextcloud présente le rôle de Files et des autres applications.
Les formats annoncés incluent MP3, FLAC, Vorbis ou Opus dans un conteneur OGG, WAV, AAC, ALAC, M4A, M4B, AIFF, AU et CAF. La lecture réelle dépend du navigateur et du type MIME reconnu par Nextcloud. Pour certains formats non lus nativement, la solution JavaScript du projet limite parfois le déplacement dans la piste ou le réglage de la vitesse.
| Besoin | Fonction de Music | Limite à contrôler |
|---|---|---|
| Parcourir une discothèque | Artistes, albums, genres et dossiers | Qualité des métadonnées |
| Lire dans le navigateur | Lecteur web et mini-lecteur Files | Codecs pris en charge par le navigateur |
| Organiser l'écoute | Playlists, lecture aléatoire et recherche | Index à maintenir après les modifications |
| Écouter ailleurs | Interfaces Ampache et Subsonic | Client compatible et clé dédiée |
| Suivre des contenus externes | Podcasts et radios internet | Disponibilité et politique de la source |
Music n'est pas un service de streaming commercial
L'application lit les fichiers que vous avez le droit de stocker et d'utiliser. Elle ne fournit ni catalogue musical, ni licence de diffusion, ni accès aux morceaux d'une plateforme tierce.
Comment installer Music et préparer la bibliothèque ?
Avant l'installation, ouvrez la fiche Music dans l'App Store depuis l'administration Nextcloud. Vérifiez la version de l'application proposée pour votre serveur et lisez les notes de version. Au 2 octobre 2026, l'App Store affiche Music 3.2.1 comme version stable pour Nextcloud 28 à 35. Le paquet déclare aussi PHP 8.0 à 8.5, mais l'ensemble de l'instance doit respecter les prérequis de sa propre version Nextcloud.
L'administrateur peut ensuite rechercher Music dans Applications, puis l'activer. Chaque utilisateur ouvre l'application depuis le menu Nextcloud. Lors du premier accès, Music détecte les fichiers audio non indexés et propose de les analyser. Pour éviter d'inclure des mémos vocaux, pièces jointes ou sons de projets, choisissez dans les réglages un sous-dossier dédié, par exemple Musique.
Une arborescence du type Artiste/Album/Piste aide lorsque les métadonnées sont absentes. En cas d'échec d'extraction, Music peut déduire le titre depuis le fichier, l'album depuis le dossier parent et l'artiste depuis le dossier supérieur. Cette solution ne corrige pas une discographie mal nommée.
Relisez aussi les tags intégrés. Un même artiste écrit de trois façons crée plusieurs entrées, et des numéros de disque absents peuvent mélanger un double album. Corrigez un petit lot avec un éditeur de métadonnées, envoyez-le dans Nextcloud, puis vérifiez le classement.
Le guide de synchronisation Nextcloud aide à choisir les dossiers synchronisés et à tester les conflits. Une synchronisation n'est toutefois pas une sauvegarde : une suppression propagée peut toucher plusieurs appareils. Conservez une copie indépendante des fichiers et de la base selon la méthode décrite dans notre guide de sauvegarde Nextcloud.
Comment indexer, corriger et maintenir la collection ?
Pour une bibliothèque modeste, l'interface web suffit. Music repère les nouveaux fichiers au démarrage de l'application, puis propose leur analyse. Les suppressions et modifications sont également détectées en arrière-plan afin d'actualiser l'index. Après un déplacement important, contrôlez quelques albums au lieu de supposer que toutes les métadonnées ont été relues.
Sur une grande collection, l'administrateur peut utiliser les commandes occ fournies par l'application. Commencez par afficher l'aide de la version réellement installée :
sudo -u www-data php occ list music
sudo -u www-data php occ help music:scan
Le compte système et le chemin vers occ dépendent de l'installation. La commande music:scan indexe les fichiers nouveaux ou marqués comme modifiés. La version 3.2.1 propose notamment des options pour traiter tous les utilisateurs, limiter le scan à un dossier, rechercher les références obsolètes ou relire les morceaux déjà connus. N'ajoutez pas un --rescan général à chaque tâche planifiée, car relire toute la bibliothèque consomme plus de temps que l'analyse des seuls changements.
sudo -u www-data php occ music:scan --all
Si des albums ont disparu alors que les fichiers existent, vérifiez le sous-dossier configuré, les droits, le type MIME et les journaux. La remise à zéro supprime l'index Music, pas les fichiers, puis impose une nouvelle analyse. Elle efface aussi les artistes, albums, pistes et playlists conservés par l'application.
Les stockages SMB demandent une attention particulière. Le projet explique que l'extraction des tags peut échouer lorsque la fonction de déplacement dans le fichier distant n'est pas disponible avec la bibliothèque SMB utilisée. Dans ce cas, Music retombe sur les noms de fichiers et de dossiers. Testez donc plusieurs albums situés sur le partage externe avant de migrer toute la discothèque.
Comment créer des playlists et conserver une organisation portable ?
Music permet de créer des playlists depuis l'interface et prend en charge l'import de fichiers M3U, M3U8, PLS et WPL selon la description officielle de la version 3.2.1. Une playlist contient des références vers les morceaux, pas une seconde copie de chaque fichier. Déplacer ou renommer massivement les titres peut donc casser certaines correspondances selon le format et les chemins enregistrés.
Testez une playlist courte avec plusieurs albums et formats, puis vérifiez son ordre après reconnexion. Exportez-la si vous voulez la réutiliser ailleurs, tout en sachant qu'un chemin Nextcloud peut différer du chemin local d'un ordinateur.
La recherche avancée combine plusieurs critères, par exemple un genre, une période et un artiste. La qualité du résultat dépend des tags. Corrigez les années, genres et artistes d'album avant de multiplier les listes automatiques.
Les paroles peuvent provenir des métadonnées du morceau ou de fichiers LRC. Un fichier LRC contient des paroles, parfois synchronisées avec le temps de lecture. Sa présence ne prouve pas que vous possédez le droit de publier ou partager ces paroles. Limitez leur usage à votre cadre autorisé et contrôlez les partages appliqués au dossier musical.
Pour écouter sans réseau, ne confondez pas le lecteur web avec une copie locale. La page Music doit accéder au serveur. Un client externe peut proposer un cache ou un téléchargement, mais ce comportement dépend du logiciel choisi. Le guide Nextcloud hors ligne sur mobile détaille les vérifications à effectuer avant de compter sur un fichier pendant un trajet sans connexion.
Comment connecter un lecteur Ampache ou Subsonic ?
Music expose des interfaces compatibles avec une partie des protocoles Ampache et Subsonic. Elles permettent à un lecteur externe de parcourir et lire la bibliothèque sans utiliser directement l'interface web Nextcloud. Le projet parle d'implémentations partielles : une fonction présente dans le protocole d'origine peut donc manquer ou se comporter différemment.
Dans les réglages de Music, générez une clé API dédiée. Cette clé n'est pas le mot de passe principal Nextcloud. L'application l'affiche au moment de sa création, mais ne permet pas de la relire ensuite. Si elle est perdue ou copiée sur un appareil qui ne doit plus accéder à la bibliothèque, supprimez-la et créez-en une nouvelle.
Les adresses habituelles affichées par l'application prennent cette forme :
https://cloud.exemple.fr/index.php/apps/music/ampache
https://cloud.exemple.fr/index.php/apps/music/subsonic
Le lecteur demande aussi un nom d'utilisateur. Il correspond généralement à l'identifiant Nextcloud, mais le projet précise qu'un UUID peut être indiqué lorsque l'authentification repose sur LDAP. Copiez la valeur affichée dans Music plutôt que de la deviner. Pour Ampache, certains clients ajoutent eux-mêmes le chemin final de l'API, tandis que d'autres nécessitent l'adresse longue indiquée dans la documentation du projet.
Testez une clé sur un seul appareil : navigation par albums, recherche, pochette, lecture et passage à la piste suivante. Essayez aussi les formats moins courants de votre collection. Un échec peut venir du client, d'une fonction non implémentée, du codec ou du serveur.
Une clé API reste un secret
N'envoyez pas la clé dans un ticket public ou une capture d'écran. Nommez-la selon l'appareil, révoquez-la après une perte et contrôlez les accès avant de partager le dossier musical.
Quelles limites vérifier avant un usage quotidien ?
La première limite est la taille de la collection. Le projet avertit qu'une bibliothèque de plusieurs dizaines de milliers de titres peut ralentir l'interface. Mesurez le premier scan, l'ouverture des albums, une recherche et le démarrage d'une piste. Les pochettes, les tags, la base et la latence du stockage comptent aussi.
La seconde limite concerne les codecs. Un fichier reconnu comme audio peut rester illisible dans un navigateur donné. Testez chaque famille de formats sur les navigateurs et appareils utilisés. Pour AIFF, AU ou CAF, le projet prévoit la commande music:register-mime-types afin d'ajouter les associations manquantes dans Nextcloud. Exécutez-la uniquement si ces formats sont nécessaires et après lecture de l'aide locale.
La troisième limite vient des services externes facultatifs. Les radios internet et podcasts dépendent de serveurs tiers. La connexion à Last.fm peut transmettre des informations de lecture si le scrobbling est activé. Présentez clairement ces flux aux utilisateurs concernés, désactivez les intégrations inutiles et appliquez les contrôles du guide de sécurité Nextcloud.
Enfin, une mise à jour peut modifier la compatibilité avec Nextcloud, PHP ou un client externe. Vérifiez la fiche App Store, les notes de version et un compte pilote avant la généralisation. Au 2 octobre 2026, la version stable 3.2.1 corrige notamment un problème d'affichage des réglages d'administration apparu dans la version 3.2.0. Cette information vieillira : la version proposée par votre instance reste la référence au moment de l'installation.
Conclusion
Nextcloud Music convient pour transformer un dossier audio en bibliothèque privée avec albums, artistes, playlists et lecture web. La réussite dépend surtout de métadonnées propres, d'un sous-dossier bien choisi, d'une indexation surveillée et de tests sur les codecs réellement utilisés. Pour un lecteur externe, créez une clé Ampache ou Subsonic par appareil et prévoyez sa révocation. Commencez avec quelques albums, mesurez les performances, puis étendez la collection seulement après avoir validé la sauvegarde et la restauration.
Découvrir l'hébergement NextcloudStockage privé et applications selon l'offre