Les notes personnelles complètent les fichiers audio. Vous pouvez écrire à propos d’une piste, d’un album, d’un artiste, d’un label ou d’un genre.
Une note par entité est conservée telle que saisie, lignes vides comprises. Aède ne reformate pas le texte enregistré, ne supprime pas discrètement les espaces et ne réorganise pas ses lignes.
aede note album "Kind of Blue" --text "the 1997 remaster is the one"
aede note album "Kind of Blue" --file notes/kind-of-blue.md
vim /tmp/note.md && aede note artist "Miles Davis" --file /tmp/note.md
somecommand | aede note artist "Miles Davis" --file - --append
aede note artist "Miles Davis" # relire la note
aede note artist "Miles Davis" --remove
aede note album "Legion" --from album:"Once Upon the Cross"
Avec --file, rédiger dans l’éditeur de votre choix puis fournir le fichier. - permet de lire le texte transmis par un autre programme sur l’entrée standard. --append ajoute un nouveau passage sans remplacer les notes précédentes ; une ligne vide sépare les textes.
À l’affichage, les annotations personnelles sont distinctes des métadonnées techniques :
Yours
★★★★★ ♥ vinyl
Notes
# Kind of Blue
The 1997 remaster is the one: the first three sides
run fast on the original pressings.
written 3 days ago
Markdown et maîtrise du texte#
Markdown est le format de vos notes. Aède conserve le texte fourni et le restitue sans réécriture. Une interface qui l’affiche peut mettre en forme titres, gras et emphase ; cette présentation reste séparée du stockage.
Deux principes en découlent :
- Sécurité : le texte est une entrée utilisateur non fiable. Une interface web doit l’échapper correctement avant de l’insérer dans du HTML.
- Intégrité : le stockage ne doit jamais reformater le texte à votre place. Un changement de présentation ne doit pas modifier la note conservée.
Conserver ses annotations#
aede notes --export -o backup.json
aede notes --import backup.json
Un catalogue perdu peut être reconstruit en scannant la musique. Les annotations personnelles demandent une sauvegarde : les fichiers audio ne contiennent pas ces textes. L’export produit un document lisible, recherchable et modifiable manuellement.
L’import fusionne les données. Importer une sauvegarde partielle ne supprime pas les autres annotations déjà présentes.
Lorsque les deux jeux de données concernent la même entité :
- Notes : la note la plus récente est conservée. Les remplacements sont comptés et signalés dans le bilan.
- Nombre d’écoutes : le plus grand compteur est conservé ; importer une ancienne sauvegarde ne fait pas reculer ce nombre.
Importer une seconde fois la même sauvegarde ne change plus les données : les mêmes éléments ne créent pas de doublons.
Les événements d’écoute sont fusionnés selon leur contenu complet et leur multiplicité : plusieurs écoutes dans la même seconde sont conservées, sans multiplication lors d’un nouvel import identique. Des journaux de rattachement indépendants gardent leurs snapshots distincts même si leurs numéros locaux coïncident. Les tables présentes doivent être des tableaux JSON ; une forme invalide est refusée plutôt que transformée en données vides. L’affichage humain échappe les caractères de contrôle du terminal, tandis que le stockage et les exports JSON/CSV gardent les valeurs originales.
L’adaptateur Subsonic/OpenSubsonic conserve aussi ici les playlists privées ordonnées et les scrobbles déclarés par les clients. L’ordre et les pistes répétées d’une playlist sont préservés ; ces playlists sont distinctes des collections intelligentes et des fichiers M3U exportés. Chaque playlist garde son propriétaire et son identifiant stable ; à l’import, la version complète la plus récente est conservée. À date égale, la version déjà présente est gardée et comptée dans le bilan. Les scrobbles gardent leur date en millisecondes Unix, sans inventer de durée écoutée ni de fin de lecture, et se fusionnent selon contenu et multiplicité. Ces deux tables sont facultatives dans le format personnel 2 : les anciens fichiers restent lisibles. Exports personnels complets et sauvegardes les incluent.
Retrouver les références en attente#
Un scan conserve les données personnelles dont la cible a disparu. Le rattachement automatique exige un candidat unique correspondant aux preuves d’identité déjà capturées ; un nom de fichier seul ne suffit pas. Les anciennes références sans preuves restent en attente.
aede notes --waiting --json
aede notes --relink "track:/ancien/01.flac" --to "track:/nouveau/01.flac" --dry-run
aede notes --relink "track:/ancien/01.flac" --to "track:/nouveau/01.flac"
aede notes --relinks
aede notes --undo-relink 1 --dry-run
aede notes --undo-relink 1
Copiez la référence source affichée par --waiting. Pour --to, utilisez une référence exacte ou un nom unique précédé de son type, par exemple track:So What ou album:Legion. Le déplacement exige une source en attente et une cible actuelle de même type ; les conflits sont refusés. Notes, écoutes, compteurs, extrémités de relations, entrées de playlists et scrobbles sont déplacés uniquement pour le propriétaire choisi. Les bilans comptent les playlists concernées, même si une piste y figure plusieurs fois, et les scrobbles séparément des événements Play portant une durée. L’annulation préserve le texte et l’ordre des playlists ; elle refuse si les données concernées ont été modifiées ou si un nouveau conflit existe. Preuves d’identité et décisions de rattachement font partie des exports et sauvegardes.