Aller au contenu
Documentation
Le projet

CLI — Commandes

artists — Lister les artistes

Lister les artistes.

artists liste les artistes locaux et les comptes/durées de leurs participations. --role filtre les crédits, --query projette une expression de pistes sur les artistes, --country utilise l’origine MusicBrainz récupérée, pas un tag deviné. Récupérer ces données avant ; countries montre les noms disponibles. Tris : name/title, tracks, albums, duration/length, size.

Cette commande de liste n’accepte pas de nom d’entité en argument. Ouvrir une entité via sa commande de détail, pas en ajoutant son nom à la liste. L’ordre est déterministe. Si disponible, --offset compte les lignes sautées depuis zéro, --limit est positif, --all est incompatible avec --limit. CSV/JSON exportent le résultat filtré/paginé, pas automatiquement toute la bibliothèque. Ajouter --all si disponible pour tout exporter. La liste reste en lecture seule.

Syntaxe et arguments#

aede artists

Aucun argument positionnel. Employer les filtres ci-dessous.

Options de cette commande#

OptionEffet
--csvProduire 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.
--role ROLEGarder les personnes ou contributions portant ce rôle ; avec credit, définir le nouveau rôle.
--country NAMEFiltrer selon le nom de pays/zone MusicBrainz, pas un code ni un tag déduit. Récupérer les données des artistes auparavant.
--limit NAfficher au plus N lignes ; entier strictement positif. La limite par défaut dépend de la page, généralement 50.
--offset NIgnorer N lignes avant le résultat ; N commence à 0. L’ordre reste déterministe.
--allAfficher toutes les lignes. Incompatible avec --limit. Certaines commandes incluent aussi des catégories habituellement masquées, précisées ci-dessous.
--json / -jProduire le résultat structuré JSON. Avec analyze, enregistrer des rapports plutôt que changer l’affichage du terminal.
--separator ";" / --separator tabUniquement avec --csv : virgule par défaut, un caractère comme ;, ou tab pour des tabulations. Entourer ; de guillemets dans le terminal.
--sort ORDERChoisir une colonne disponible ; ajouter - pour décroître, par exemple duration-. Les valeurs de cette commande figurent ci-dessous.
--query EXPRESSIONFournir une expression relationnelle. Selon la commande : l’enregistrer, sélectionner des pistes ou garder les albums/artistes correspondants.

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 artists --limit 20
aede artists --country France --all
aede artists --role producer
aede artists --query "loved"

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.

Pour continuer#

artist, query.

Guide détaillé existant : browsing.md.