Une option change le comportement d’une commande. Aède distingue options réellement partagées, familles réutilisées à portée limitée et réglages spécialisés. Ne pas supposer qu’une option connue fonctionne partout : le tableau de chaque commande fait référence.
Présentation et données partagées#
| Option | Sens |
|---|---|
--data DOSSIER | Dossier de données Aède, pas dossier musical à scanner. Concerne les opérations utilisant les données mémorisées. |
--no-color | Désactiver les couleurs ANSI du terminal. |
--help, -h | Montrer index ou aide de commande et s’arrêter. |
--version, -v, -V | Afficher la version et s’arrêter. |
Ordre des données : --data, AEDE_HOME, $XDG_DATA_HOME/aede, ~/.local/share/aede, puis .aede du dossier courant si HOME est absent. L’inspection directe n’exige pas de catalogue ; la lecture utilise encore les données pour sélections/historique. Garder le même emplacement avec le serveur.
Saisir les valeurs#
aede albums --limit 10
aede albums --limit=10
aede track "So What" --artist "Miles Davis"
aede play "/path/to/audio.flac" --bass -2
aede note album "Kind of Blue" --file -
aede file -- ./-track.flac
--option valeur et --option=valeur fonctionnent. Chemins/nombres/mots-clés prennent un élément. Les options de noms (--artist, --album, --with, --genre, --label, --comment, --role, --country, --text, --from, --tag, --query, --collection, --instrument) absorbent les mots jusqu’à la prochaine option : placer le nom positionnel d’abord. Citer chemins et noms composés. -- arrête la lecture d’options pour un chemin commençant par tiret. - seul lit l’entrée standard des notes. Graves/aigus acceptent spécialement les nombres négatifs (--bass -2 ou --bass=-2).
Raccourcis séparés : -j signifie --json de portée limitée ; -o FICHIER signifie --output. -o=FICHIER fonctionne. Ne pas combiner les lettres (-jo n’est pas déclaré). Options inconnues/valeurs manquantes sont vérifiées avant aide/version. Répéter une option garde actuellement sa dernière valeur ; l’écrire une fois évite un remplacement involontaire.
Les indicateurs sans valeur comme --yes, --json et --help refusent une valeur accolée, y compris =false, =true et un = vide. Ils agissent par leur présence et ne prennent pas une valeur booléenne. Ce contrôle précède aide/version, confirmation et toute modification ; omettre --yes pour conserver la demande de confirmation.
Familles réutilisées#
Pagination : --limit N, --offset N, --all seulement sur les commandes listées ci-dessous. N entier ; limite positive, décalage depuis zéro ; all et limit incompatibles. Une liste paginée demande généralement 50 lignes, certains rapports moins pour leurs listes secondaires. L’export garde les lignes filtrées/paginées ; demander tout volontairement.
Sortie : choisir CSV, JSON ou M3U si proposé. --output/-o écrit un véritable export, pas toute page humaine. --separator exige CSV ; export --tracks exige CSV. CSV cite les titres contenant des virgules : un outil qui coupe aveuglément à chaque virgule casse ces colonnes. --separator tab convient aux traitements simples à tabulations. M3U garde des chemins, sans copier l’audio.
La destination d’export est contrôlée avant toute modification des données personnelles. Les stores actifs et verrous d’Aède, fichiers audio existants, liens symboliques et cibles non ordinaires sont refusés. Un rapport ordinaire est remplacé atomiquement après écriture complète ; ses dossiers manquants peuvent être créés. L’affichage humain échappe les instructions de contrôle des notes, chemins et métadonnées. Les exports JSON/CSV gardent les valeurs originales ; traiter le texte CSV comme une donnée non fiable à l’ouverture dans un tableur.
Confirmation : --yes existe seulement pour reset, history, fetch, backup, restore. Il accepte leur confirmation réelle, sans ignorer les erreurs. Sans terminal, une confirmation nécessaire refuse sauf acceptation volontaire.
Réutilisation : --full concerne scan/check/spectrum/fetch/fingerprint avec des effets différents ; analyze utilise --force. Ne pas déduire l’effet du nom seul.
Matrice complète des options reconnues#
Cette liste suit répartition et traitements actuels. Elle décrit la portée acceptée, pas toutes les combinaisons valides. Contraintes sur chaque page. Limites actuelles : missing --source et merge --source acceptés sans appliquer le filtre ; sources --source filtre list/forget et choisit la provenance de template, mais résumé/export incluent tout. --compress/--quality relèvent de copy même si la répartition actuelle ne refuse pas ces noms sur toutes les autres commandes. Employer seulement leur portée documentée.