check relit les sommes intégrées aux conteneurs pris en charge : CRC des trames FLAC et des pages Ogg Vorbis/Opus/Speex. Il détecte les dégâts couverts par ces sommes. MP3, MP4, WAV et AIFF ne fournissent pas de somme compatible avec cette vérification : « aucune somme » ne signifie pas « vérifié sain ».
Par défaut, les verdicts des fichiers inchangés sont réutilisés. --full relit tout le périmètre, utile après un soupçon de panne de disque. Si rien n’attend, le rapport courant s’affiche. Un dossier facultatif limite les fichiers catalogués ; scanner la nouvelle musique avant de la vérifier.
Pour le contrôle des conteneurs, --threads est vérifié même si la sélection est vide ou si tous ses verdicts sont en cache. Zéro conserve le choix automatique ; un entier strictement positif demande ce nombre de travailleurs.
Les verdicts sont mémorisés et deviennent obsolètes si la source change. Ce contrôle diffère de la vérification MD5 du FLAC décodé ou de l’analyse d’origine audio de FlacCompagnon. Il ne répare ni ne remplace les fichiers abîmés. Sauvegarder aussi les originaux.
Syntaxe et arguments#
aede check [folder…]
Zéro ou plusieurs dossiers contenant de l’audio catalogué. Sans argument : tout le catalogue.
Options de cette commande#
| Option | Effet |
|---|---|
--full | Relire les sommes de tous les fichiers sélectionnés, même avec verdict existant. |
--threads N | Nombre de traitements parallèles. Un entier positif fixe ce nombre ; 0 ou l’option omise utilise le parallélisme disponible du processeur, avec quatre traitements si cette information est indisponible. |
La référence des options explique --data, --no-color, --help/-h, --version/-v/-V, valeurs et règles d’export/pagination. Elles ne rendent pas CSV/JSON ou pagination disponibles partout.
Exemples#
aede check
aede check "$HOME/Music/Jazz" --full
aede check --threads 4
Résultat et erreurs#
Lire les verdicts, catégories endommagé/sans somme/illisible comprises. Le traitement check actuel peut finir avec code 0 malgré des fichiers illisibles ou verdicts endommagés : la réussite du processus ne prouve pas leur santé. Arguments invalides et erreurs de catalogue/stockage restent refusés.
Le flux complet doit respecter la limite actuelle de lecture de 2 Gio : audio FLAC après les métadonnées, ou fichier Ogg entier. Les flux plus grands et les fichiers dont la taille change pendant la lecture sont signalés en erreur, sans nouveau verdict. Une lecture partielle ne peut pas produire un verdict intact. Les verdicts existants restent réutilisés sans --full.
Une relecture échouée retire l’ancien verdict de ce fichier, pour qu’une prochaine tentative reste possible. Les autres conclusions et les fichiers pas encore tentés sont conservés. Les anciennes versions pouvaient garder un verdict limité au préfixe à la limite de lecture ; utiliser --full sur les dossiers contenant de gros fichiers contrôlés par ces versions.
Pour continuer#
Guide détaillé existant : integrity.md.
Test complet de décodage#
aede check --decode-test [fichier-ou-dossier…] relit et décode toute la sélection sans lecture audio ni écriture des fichiers. Pour le FLAC, le programme installé flac --test est préféré ; seule son absence déclenche le décodeur Rust existant. Les autres formats utilisent le décodeur habituel. Le rapport nomme le vérificateur et distingue le MD5 vérifié de son absence. Un fichier illisible, modifié ou refusé entraîne un échec après le rapport des autres fichiers. Les conclusions CRC et analyses enregistrées ne sont pas remplacées.
--json est disponible uniquement avec --decode-test. La réponse version 1 contient un tableau files : path exact, status (ok pour une empreinte vérifiée, no_hash pour un décodage réussi sans empreinte de référence, ko pour un échec), verifier et éventuellement message pour une erreur. Même en cas de sortie non nulle, le rapport par fichier est complet. Aucun résultat n’est enregistré dans le catalogue.
Les échecs du vérificateur externe incluent son diagnostic en texte, de taille limitée, avec une indication explicite si tronqué. Le flux complet est consommé sans accumulation illimitée en mémoire. Ce diagnostic reste ponctuel.