Ligne de commande
Cette page recense toutes les commandes du programme musonic-server, pour les administrateurs qui font tourner le serveur avec Docker ou en programme seul.
Ce qu’il vous faut
- Un Musonic Server installé avec Docker ou en programme seul.
- Un terminal sur la machine qui le fait tourner.
| Commande | Ce qu’elle fait |
|---|---|
musonic-server |
Lance le serveur (c’est ce que lancent Docker et votre gestionnaire de services). |
musonic-server scan [--full] |
Scanne une fois le dossier de musique, affiche un bilan et s’arrête. |
musonic-server user add <nom> [--admin] |
Crée un compte. |
musonic-server import-navidrome <navidrome.db> [--replace-playlists] [--new-ids] |
Importe playlists, « j’aime », notes et écoutes depuis une copie de la base de Navidrome. |
<nom>: le nom d’utilisateur du nouveau compte (de 1 à 64 caractères).<navidrome.db>: le chemin d’une copie du fichier de base de données de Navidrome.
Il n’y a pas d’option --help : une commande inconnue affiche la liste des commandes et se termine en erreur.
Error: unknown command "--help" (expected: scan [--full], user add <name> [--admin], import-navidrome <navidrome.db>)Lancer une commande
Section intitulée « Lancer une commande »Chaque commande lit la même configuration que le serveur : les variables d’environnement (MUSONIC_DATA_DIR, MUSONIC_MUSIC_DIR…) et le fichier TOML indiqué par MUSONIC_CONFIG. Une commande doit donc voir le même dossier de données que le serveur en marche, sinon elle travaille sur une autre base, vide.
Lancez la commande dans le conteneur en marche, depuis le dossier qui contient compose.yml :
docker compose exec musonic-server musonic-server <commande>Le premier musonic-server est le nom du service dans compose.yml, le second est le programme. Dans le conteneur, le dossier de données est /data et le dossier de musique /music, déjà réglés par l’image.
Lancez le programme avec le même environnement que votre service, par exemple :
MUSONIC_DATA_DIR=/var/lib/musonic MUSONIC_MUSIC_DIR=/srv/music ./musonic-server <commande>Sans MUSONIC_DATA_DIR (ni data_dir dans le fichier de configuration), le dossier de données est data, relatif au dossier courant.
musonic-server (lancer le serveur)
Section intitulée « musonic-server (lancer le serveur) »Sans commande, le programme lance le serveur : il ouvre la base (en appliquant les migrations nécessaires), démarre la surveillance de la bibliothèque et les scans programmés, et écoute sur bind (127.0.0.1:4533 par défaut ; 0.0.0.0:4533 dans l’image Docker). Ctrl+C l’arrête proprement.
Tant qu’aucun compte n’existe, le journal le signale : créez l’administrateur dans le client web, avec POST /v1/setup, ou avec user add … --admin.
Scanne une fois le dossier de musique, affiche en JSON ce qu’il a fait, puis s’arrête.
| Option | Effet |
|---|---|
| (aucune) | Scan rapide : seuls les dossiers et fichiers modifiés sont lus. |
--full |
Relit tous les fichiers. |
docker compose exec musonic-server musonic-server scan --fullMUSONIC_DATA_DIR=/var/lib/musonic MUSONIC_MUSIC_DIR=/srv/music ./musonic-server scan --fullChamps de la sortie : full, folders, folders_changed, files, files_read, files_missing, tracks_added, errors (liste de messages), duration_ms.
La commande échoue avec no music folder configured (MUSONIC_MUSIC_DIR) si aucun dossier de musique n’est défini.
user add
Section intitulée « user add »Crée un compte. Avec --admin, le compte est administrateur.
-
Lancez la commande avec le nouveau nom d’utilisateur.
Fenêtre de terminal docker compose exec musonic-server musonic-server user add <nom> --adminAvec le programme seul :
./musonic-server user add <nom> --admin, avec le même environnement que votre service. -
Tapez le mot de passe, puis appuyez sur Entrée.
L’invite est
Password for <nom>:. Le mot de passe doit faire au moins 8 caractères. -
Lisez la confirmation.
created <nom> (administrator)oucreated <nom> (user).
Erreurs possibles : usage: user add <name> [--admin] (nom absent), invalid username, the password needs at least 8 characters, this username is taken.
Pour votre famille et vos amis, préférez les liens d’invitation de la console : chacun choisit son nom et son mot de passe.
import-navidrome
Section intitulée « import-navidrome »Importe depuis une copie de la base de Navidrome : playlists, « j’aime », notes, compteurs et historique d’écoute. Les mots de passe ne sont jamais repris.
| Option | Effet |
|---|---|
| (aucune) | Les titres sont retrouvés par leur fichier et gardent leurs identifiants Navidrome, comme les playlists : ce que les clients ont enregistré continue de fonctionner. Relancer l’import n’ajoute rien en double. |
--new-ids |
Donne de nouveaux identifiants aux titres et aux playlists au lieu de ceux de Navidrome. |
--replace-playlists |
Réimporte les playlists importées auparavant, en les remplaçant. |
-
Créez d’abord les comptes dans Musonic, avec les mêmes noms que dans Navidrome.
Les comptes Navidrome sans compte du même nom sont ignorés (listés dans
users_skipped). -
Faites une copie cohérente de la base de Navidrome dans le dossier de données de Musonic.
Fenêtre de terminal sqlite3 -readonly /chemin/vers/navidrome.db ".backup ./data/navidrome-copy.db"./dataest le dossier monté sur/datadanscompose.yml. Le conteneur Docker est en lecture seule, sauf/dataet/music. -
Scannez la bibliothèque, pour que les titres soient retrouvés par leurs fichiers.
Fenêtre de terminal docker compose exec musonic-server musonic-server scan -
Lancez l’import.
Fenêtre de terminal docker compose exec musonic-server musonic-server import-navidrome /data/navidrome-copy.db -
Redémarrez le serveur.
Fenêtre de terminal docker compose restart musonic-serverL’import écrit dans la base depuis un autre processus : le redémarrage garantit que le serveur ne sert plus les réponses qu’il avait gardées d’avant.
Champs de la sortie : users, users_skipped, files_matched, files_not_found, ids_kept, playlists, playlists_already_there, playlist_entries, playlist_entries_missing, track_annotations, album_annotations, artist_annotations, plays.
Le guide complet de migration se trouve dans Venir de Navidrome.
Variables d’environnement lues par les commandes
Section intitulée « Variables d’environnement lues par les commandes »Tous les réglages de configuration s’appliquent. Ceux-ci comptent le plus en ligne de commande :
| Variable | Utilisée par | Rôle |
|---|---|---|
MUSONIC_DATA_DIR |
toutes | Dossier de données (base musonic.db, caches, sauvegardes). data par défaut ; /data dans Docker. |
MUSONIC_MUSIC_DIR |
serveur, scan |
Dossier de musique. /music dans Docker. |
MUSONIC_CONFIG |
toutes | Chemin d’un fichier de configuration TOML. |
MUSONIC_PASSWORD |
user add |
Le mot de passe, au lieu de le taper. |
MUSONIC_SECRET_KEY |
serveur, user add |
Clé (64 caractères hexadécimaux) qui chiffre les mots de passe gardés pour la connexion Subsonic par jeton. Par défaut : secret.key dans le dossier de données, créé au premier démarrage. |
RUST_LOG |
toutes | Niveau de journalisation, par exemple info ou debug (info par défaut). |