Pipeline d’importation

L’importation transforme un dossier de fichiers en entrée de catalogue sans modifier un octet des fichiers. Cette page décrit le pipeline du guide d’utilisation.

Analyse

Les dossiers surveillés sont suivis par les événements de système de fichiers de la plateforme, temporisés, puis réanalysés en cas de changement ; les analyses se réconcilient avec la liste de candidats existante au lieu de recommencer. Le scanner classe un dossier comme une seule sortie (audio directement à l’intérieur, ou sous-dossiers en forme de disque comme CD1/CD2), ou descend dedans comme dans une collection. Les fichiers sont classés par extension en audio, illustrations et documents, puis l’audio est sondé : le codec qui compte est celui que FFmpeg trouve dans les octets, pas l’extension de fichier. Les dossiers qui contiennent des marqueurs de téléchargement partiel sont exclus jusqu’à la fin du téléchargement.

Une fiche CUE transforme une image audio en liste de pistes. Le parseur gère pregaps et postgaps, interprètes et ISRC par piste, ainsi que les dispositions CUE à image unique et à un fichier par piste. Les limites de pistes sont converties depuis les frames CUE (1/75e de seconde) vers des positions d’échantillon exactes, qui deviennent ensuite les fenêtres d’octets et d’échantillons utilisées par la lecture.

Projets de métadonnées

Chaque candidat stocke un brouillon de métadonnées modifiable et une provenance optionnelle. Le brouillon peut être vide, rempli directement, rempli à partir d’une version externe ou rempli à partir d’un instantané de balises de fichier stocké. Les enregistrements de provenance indiquent où le brouillon actuel a commencé ; les modifications ultérieures ne l’effacent pas.

L’emplacement de métadonnées supérieur affiche soit le brouillon, soit le navigateur Rechercher en ligne, soit le navigateur Tags des fichiers. L’ouverture ou la fermeture d’un navigateur ne réécrit pas le brouillon. Appliquering une source remplace le brouillon, sa provenance et sa couverture source sélectionnée dans une transaction de base de données tout en conservant les rôles de fichier, les liaisons CUE, les affectations de disque et d’autres décisions de mappage.

Rechercher en ligne

Rechercher en ligne est le seul chemin qui exécute l’identification. Il calcule un ID de disque à partir d’un journal d’extraction ou d’une feuille CUE, reconnaît les codes-barres et le texte du catalogue avec OCR, interroge MusicBrainz et Discogs et fait correspondre les résultats.

Le paramètre Source de métadonnées par défaut comporte trois valeurs. Aucune crée un brouillon vide et ne lance aucun travail de métadonnées. Tags des fichiers lit et applique l’instantané des tags. Rechercher en ligne ouvre le flux de travail en ligne. Mode Rechercher en ligne par défaut choisit Automatique, qui met en file d’attente l’extraction des indices, les requêtes aux fournisseurs et la mise en correspondance, ou Rechercher manuellement, qui ne lance aucune identification. Rechercher en ligne utilise ce mode pour chaque candidat ; Automatique ne relance pas une opération active ou terminée.

Tags des fichiers

Tags des fichiers lit les balises audio intégrées et les métadonnées CUE de manière paresseuse, à moins qu’il ne s’agisse de la valeur par défaut configurée pour un candidat nouvellement découvert. L’aperçu stocke un instantané estampillé avec la génération de numérisation du candidat, la révision d’édition du fichier et les fichiers audio observés. Appliquerl’importer remplace le brouillon de cet instantané exact. L’importation consomme le même instantané et échoue avant que la bibliothèque n’écrive si son tampon ou ses observations ont changé ; elle ne lit pas une réponse différente.

Les champs de sortie et de piste du brouillon vierge sont modifiables immédiatement, et il devient importable lorsque les champs et les mappages requis sont validés. La liste de candidats ne traite pas la provenance manquante comme une erreur ou une demande d’attention.

Sources

MusicBrainz est interrogé anonymement avec un rythme strict d’une requête par seconde. Discogs s’authentifie avec le jeton personnel de l’utilisateur depuis le trousseau, en respectant son débit et en réessayant dans ses limites, et un jeton refusé est signalé comme tel afin que l’interface puisse l’indiquer plutôt que de laisser les recherches échouer en silence. Les réponses sont mises en cache par session, et le JSON brut de la source qui gagne est archivé dans la base de données pour une future réinterprétation.

Validation

Confirmer une importation exécute, dans l’ordre :

1. Vérification du décodage : chaque piste est décodée de bout en bout ; un rip qui ne peut pas se décoder entièrement fait échouer l’importation avant toute écriture (un indicateur de configuration peut désactiver cela).
2. Analyse du niveau sonore : le niveau sonore intégré et le pic vrai sont mesurés par piste et par album pendant cette même passe de décodage, stockés pour l’usage du replay gain.
3. Sélection de la pochette : l’illustration choisie (distante, image du dossier ou intégrée) est rerendue en vignette d’affichage ; l’original est conservé parmi les fichiers de la sortie s’il venait du dossier.
4. Écriture atomique : la sortie, les pistes, les crédits, les identités, les formats, les segments, les fichiers et la pochette sont validés dans une transaction. Il n’existe aucun état à moitié importé.

La sortie arrive en référençant les fichiers de l’utilisateur en place. Si l’utilisateur a choisi une gestion dans le cloud, l’envoi se produit après la validation comme transition de stockage, et les octets originaux des fichiers restent la source de vérité tout du long ; rien de ce que l’utilisateur a donné à bae n’est jamais supprimé ou modifié.

Reconnaître les rips

Chaque sortie enregistre un hash de contenu sur la structure de son dossier importé (chemins relatifs et tailles, indépendant de l’emplacement). Les nouvelles analyses l’utilisent pour marquer les dossiers déjà dans la bibliothèque, et les réimportations du même rip trouvent et remplacent leur sortie précédente au lieu de la dupliquer.