Bibliothèque

Votre dossier de musique

Heron lit la musique de HERON_MUSIC_DIR. Il cherche les fichiers au démarrage, à chaque changement de fichier, et toutes les heures par sécurité (HERON_SCAN_INTERVAL). Sur les partages réseau qui ne signalent pas les changements (certains montages NFS ou SMB), réglez HERON_LIBRARY_WATCH=false et comptez sur le parcours périodique.

Formats : MP3, AAC-LC et ALAC en M4A/MP4, FLAC, Ogg Vorbis, WAV et AIFF. Les fichiers HE-AAC et Opus ne peuvent pas encore être décodés.
Déplacements et renommages sont reconnus : la piste garde ses catégories, son historique et son analyse.
Les fichiers supprimés sont marqués manquants et reviennent si le fichier réapparaît. Si tout le dossier semble vide (un disque démonté), rien n’est marqué manquant.
Seul heron-librarian écrit dans la bibliothèque. L’analyse, l’analyseur et le moteur la montent en lecture seule.

Analyse

Chaque piste est analysée avant sa diffusion (heron-analyzer, un processus par cœur moins un, pour que le moteur garde toujours un cœur) :

Mesure	Sert à
Sonie intégrée (EBU R128) et crête vraie	La normalisation du niveau sonore
Point d’entrée et point de sortie	Sauter les silences en début et en fin
Point de fondu	Le départ de la piste suivante
Tempo (BPM)	La programmation ; se corrige à la main
Forme d’onde	Dessinée sur la page de la piste avec les points de cue

Un moment compte comme silence s’il est à la fois bien sous la sonie de la piste et sous −50 dBFS : les intros douces des masters très forts sont gardées. Les clics sont ignorés. Une piste sans rien d’audible n’est jamais diffusée.

Le point de fondu est la fin du dernier passage fort de la piste, entre 150 ms et 2,5 s avant le point de sortie : un long fondu de fin est enchaîné au plus 2,5 s avant la fin, et une fin abrupte garde un court chevauchement.

Vous pouvez faire glisser les points de cue sur la forme d’onde d’une piste ; ils deviennent des réglages propres à cette piste.

Les nouveautés : la zone tampon

Les nouveaux fichiers n’entrent jamais directement dans la bibliothèque. Envoyez-les depuis la page Zone tampon (fichiers ou dossiers, par morceaux qui reprennent après une coupure), ou déposez-les dans HERON_INCOMING_FOLDER. Ils passent dans la zone tampon (HERON_STAGING_FOLDER), où heron-librarian :

lit leurs tags et calcule leur empreinte ;
les identifie avec AcoustID et MusicBrainz, les fichiers d’un même dossier ensemble, pour qu’un album s’accorde sur son édition ;
signale les problèmes : déjà dans la bibliothèque, deux fois dans la zone tampon, même enregistrement qu’une piste de la bibliothèque, illisible, trop court, non pris en charge.

Dans la page Zone tampon, vous pouvez écouter, choisir une autre édition candidate ou garder les tags du fichier, modifier les tags, et préparer les fichiers avec leurs catégories, étiquettes, ambiance et code sonore. Les fichiers sans problème sont déjà sélectionnés : un album propre s’importe en un clic.

L’import écrit les tags, classe chaque piste et enregistre la pochette. Un lien mène ensuite aux nouvelles pistes.

Classement

Les fichiers importés sont classés sous la racine de la bibliothèque selon un modèle. Par défaut :

{album_artist}/{album}/{disc-}{track:02} {title}.{ext}

Les noms sont rendus sûrs pour tous les systèmes de fichiers. Un fichier n’est jamais écrasé : un nom déjà pris reçoit (2), (3)… Chaque déplacement et chaque écriture de tags est journalisé avant de toucher au fichier, survit à un plantage et peut être annulé, à l’octet près.

Votre bibliothèque existante n’est réorganisée qu’à votre demande, après un essai à blanc (Vérifier et ranger, administrateurs), ou en ligne de commande :

docker compose exec heron-librarian heron-librarian organize           # essai à blanc
docker compose exec heron-librarian heron-librarian organize --apply   # appliquer, en un seul lot
docker compose exec heron-librarian heron-librarian undo <lot>         # annuler

La corbeille

Supprimer des pistes (depuis Pistes ou la page d’une piste) déplace leurs fichiers dans une corbeille cachée à la racine de la bibliothèque. Une piste supprimée quitte aussitôt la rotation, mais garde son analyse, ses catégories et son historique : la restaurer depuis la page Corbeille la ramène entière. La corbeille est vidée au bout de 30 jours (trash_days), ou tout de suite par un administrateur.

Droits

heron-librarian et heron-api tournent sous HERON_LIBRARIAN_USER, qui doit être propriétaire des dossiers de musique, d’arrivée et de la zone tampon. Gardez la zone tampon sur le même système de fichiers que la bibliothèque : les imports sont alors de simples renommages.