notes liste les notes et peut filtrer les entités portant --tag ÉTIQUETTE. CSV/JSON exportent les lignes montrées, pagination incluse. --export écrit plutôt le document personnel portable complet ; --import le fusionne avec les données actuelles sans vider le magasin.
En conflit, la note la plus récente gagne et les remplacements sont signalés ; le plus grand compteur d’écoutes est conservé. Importer deux fois le même fichier n’ajoute rien. L’export dépasse le simple texte Markdown car il garde la structure d’annotation permettant le rattachement.
note TYPE NOM lit/écrit une note précise ; backup sauvegarde l’ensemble des données ; rules les décisions reproductibles de sources/graphe. Garder les exports privés : notes et références peuvent être personnelles. L’import utilise la même limite de 64 Mio d’octets bruts et la même validation que le magasin personnel, espaces compris.
Le déplacement automatique d’une référence de piste exige des preuves d’identité concordantes, dont les tags d’artiste et d’artiste d’album au singulier comme au pluriel. Une ancienne preuve incomplète ne démontre pas un déplacement : la référence reste en attente jusqu’à concordance ou rattachement explicite. Une réconciliation au chemin d’origine actualise les preuves avant un déplacement ultérieur.
Syntaxe et arguments#
aede notes
Aucun argument positionnel ; --import fournit un JSON personnel portable.
Options de cette commande#
| Option | Effet |
|---|---|
--csv | Produire un tableau CSV de ce résultat pour un tableur ; choisir un seul format de sortie. |
--output FILE / -o FILE | Écrire l’export dans FICHIER plutôt que dans le terminal. Une sélection exige --csv, --json ou --m3u ; les exports propres à une commande suivent leurs règles. |
--limit N | Afficher au plus N lignes ; entier strictement positif. La limite par défaut dépend de la page, généralement 50. |
--offset N | Ignorer N lignes avant le résultat ; N commence à 0. L’ordre reste déterministe. |
--all | Afficher toutes les lignes. Incompatible avec --limit. Certaines commandes incluent aussi des catégories habituellement masquées, précisées ci-dessous. |
--json / -j | Produire le résultat structuré JSON. Avec analyze, enregistrer des rapports plutôt que changer l’affichage du terminal. |
--separator ";" / --separator tab | Uniquement avec --csv : virgule par défaut, un caractère comme ;, ou tab pour des tabulations. Entourer ; de guillemets dans le terminal. |
--waiting | Lister les références personnelles sans cible actuelle, écoutes et relations comprises. |
--relink REFERENCE --to TYPE:NOM | Rattacher explicitement une référence en attente à une cible existante de même type ; accepter un nom unique ou une référence exacte, refuser ambiguïtés et conflits. |
--dry-run | Prévoir un rattachement ou son annulation sans modifier les données. |
--relinks | Lister les décisions de rattachement et leurs identifiants. |
--undo-relink ID | Annuler un rattachement inchangé ; refuser les modifications ultérieures et conflits. |
--export | Écrire le document personnel portable complet, pas seulement les notes paginées. |
--import FILE | Fusionner un export personnel JSON compatible : note récente et compteur maximal conservés ; import identique sans doublon. |
--tag LABEL[,LABEL] | Avec notes/relations, filtrer une étiquette personnelle ; avec relation, ajouter les étiquettes séparées par des virgules, ou les retirer avec --remove. |
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 notes --tag jazz
aede notes --export --output personal.json
aede notes --import personal.json
aede notes --waiting
aede notes --relink "track:/old/01.flac" --to "track:So What" --dry-run
aede notes --relinks
aede notes --undo-relink 1
Résultat et erreurs#
La sortie décrit l’opération ou les données choisies. Lire avertissements et bilan du travail conservé ; finir le processus ne garantit ni intégrité indépendante ni qualité sonore. Erreurs de syntaxe/options : généralement code 2 ; échecs de traitement : généralement code 1. Une interruption locale diffère d’une tâche serveur déléguée, comme expliqué dans cancel.
Copier la référence source exacte depuis --waiting. --to accepte type:nom, par exemple "album:Legion", ou une référence exacte ; entourer de guillemets les valeurs contenant des espaces. Une annulation conserve le texte original et empêche le rattachement automatique ultérieur de cette ancienne piste. --dry-run exige --relink ou --undo-relink ; les modes import/export, attente, historique et rattachement sont distincts. Les filtres de liste sont refusés lors des écritures/exports. Les références en attente n’acceptent pas --search ; l’historique des rattachements n’accepte ni --tag ni --search.
Pour continuer#
Guide détaillé existant : annotating.md.