Annexe D : Options de ligne de commande

Picard peut être démarré à partir de la ligne de commande avec les arguments suivants :

run_picard.py [-h] [-a AUDIT] [-c CONFIG_FILE] [-d] [-e COMMAND [COMMAND ...]] [-M] [-N] [-P] [--no-crash-dialog] [--debug-opts] [-s] [-v] [-V] [FILE_OR_URL ...]

où les options sont :

-h, --help: affiche un message d’aide et quitte

-a AUDIT, --audit AUDIT: événements d’audit transmis sous la forme d’une liste séparée par des virgules, préfixes supportés, utiliser « all » pour correspondre à n’importe quel événement. Voir la Documentation Python pour plus d’informations.

-c CONFIG_FILE, --config-file CONFIG_FILE: emplacement du fichier de configuration à utiliser

-d, --debug: active la journalisation au niveau du débogage

--debug-opts [OPTIONS]

liste d’options de débogage séparées par des virgules. Utilisez –debug-opts sans valeur pour afficher la liste des options disponibles

Note

L’option de débogage plugin_development a été spécialement conçue pour aider les développeurs de plugins en permettant la journalisation détaillée d’événements liés aux plugins qui ne seraient normalement pas inclus dans le journal de débogage. Cela peut aider les développeurs à identifier les problèmes et à comprendre le comportement de leurs plugins au sein de Picard. Les entrées du journal de débogage sont utiles lorsqu’un utilisateur cherche à déterminer quel plugin modifie les métadonnées, etc., mais une journalisation de débogage exhaustive, telle que celle requise pour le dépannage d’un plugin spécifique, peut s’avérer trop volumineuse. Si une journalisation de débogage détaillée est incluse, elle doit être utilisée avec la méthode api.logger.debug_if() afin qu’elle ne soit enregistrée que lorsque l’option de débogage plugin_development est spécifiée sur la ligne de commande. Par exemple :

# Single message
self.api.logger.debug_if(DebugOpt.PLUGIN_DEVELOPMENT, "Detailed debug message with no parameters")
self.api.logger.debug_if(DebugOpt.PLUGIN_DEVELOPMENT, "Resize: %d x %d", width, height)

# Lazy formatting with msg_func
self.api.logger.debug_if(DebugOpt.PLUGIN_DEVELOPMENT, msg_func=lambda: "Settings: %s" % expensive())

# Block guard to skip expensive code entirely when disabled
if dbg := self.api.logger.debug_if(DebugOpt.PLUGIN_DEVELOPMENT):
    for item in items:
        dbg("item: %r", item)

-e COMMAND, --exec COMMAND: exécuter une ou plusieurs COMMANDs au démarrage (voir Commandes exécutables pour plus d’informations)

-M, --no-player: désactiver le lecteur multimédia intégré

-N, --no-restore: ne restaure pas la position ou la taille des fenêtres

-P, --no-plugins: ne chargent aucun plug-in

--no-crash-dialog: désactiver la boîte de dialogue en cas d’accident

-s, --stand-alone-instance: forcez Picard à créer une nouvelle instance autonome

-v, --version: affiche les informations de version et quitte

-V, --long-version: affiche les informations de la version longue et quitte

FILE_OR_URL: un ou plusieurs fichiers, répertoires, URLs et MBIDs à charger

Note

Les fichiers et les répertoires sont spécifiés en incluant le chemin (absolu ou relatif) vers le fichier ou le répertoire, et peuvent inclure des spécificateurs de lecteur. Ils peuvent également être spécifiés en utilisant le préfixe file://. Les URLs sont spécifiées en utilisant le préfixe http:// ou https://. Les MBID sont spécifiés au format mbid://<type_d'entité>/<mbid> où <type_d'entité> est l’un de « release », « artist » ou « track » et <mbid> est l’identifiant MusicBrainz de l’entité.

Si un élément spécifié contient un espace, il doit être placé entre guillemets, comme par exemple "/home/user/music/my song.mp3".

Annexe D : Options de ligne de commande

Annexe D : Options de ligne de commande