Appendix B: Command Line Options

Picard kan vanuit een opdrachtregel worden opgestart, waarbij je de volgende argumenten kan gebruiken:

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 ...]

De opties zijn:

-h, --help: Een hulpbericht tonen en afsluiten.

-a AUDIT, --audit AUDIT: Auditgebeurtenissen, geleverd als een door komma’s gescheiden lijst, met ondersteuning voor prefixen; gebruik ‘all’ om alle soorten gebeurtenissen te selecteren. Zie de Python-documentatie voor meer informatie.

-c CONFIG_FILE, --config-file CONFIG_FILE: De locatie van het te gebruiken configuratiebestand.

-d, --debug: Logboekregistratie op debugniveau inschakelen.

--debug-opts [OPTIONS]

comma-separated list of debug options. Use –debug-opts without value to list available options

Notitie

The plugin_development debug option has been specifically designed to assist plugin developers by allowing detailed logging of plugin-related events that would not normally be included in the debug log. This can help developers identify issues and understand the behavior of their plugins within Picard. Debug log entries are useful when a user is trying to understand which plugin is making changes to metadata and such, but extensive debug logging such as that required for troubleshooting a specific plugin can be overwhelming. If detailed debug logging is included, it should be used with the api.logger.debug_if() method so that it is only logged when the plugin_development debug option is specified on the command line. For example:

# 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: execute one or more COMMANDs at start-up (see Opdrachtregelopdrachten for more information)

-M, --no-player: De ingebouwde mediaspeler uitschakelen.

-N, --no-restore: De vensterposities en -afmetingen niet herstellen.

-P, --no-plugins: Geen plug-ins laden.

--no-crash-dialog: Het crashvenster uitschakelen.

-s, --stand-alone-instance: Picard dwingen om een nieuw en onafhankelijk exemplaar te creëren.

-v, --version: De versiegegevens weergeven en afsluiten.

-V, --long-version: Uitgebreide versiegegevens weergeven en afsluiten.

FILE_OR_URL: Eén of meer bestanden, mappen, URL’s en MBID’s laden.

Notitie

Bestanden en mappen kunnen worden opgegeven met het pad (zowel absoluut als relatief) naar het bestand of de map, eventueel met stationaanduidingen. Ze kunnen ook met de prefix file:// worden opgegeven. URL’s moeten worden opgegeven met de prefix http:// of https://. MBID’s moeten worden opgegeven in de indeling mbid://<entity_type>/<mbid>, waarbij <entity_type> ‘release’, ‘artist’ of ‘track’ is en <mbid> de MusicBrainz-ID van het object is.

Als je iets met een spatie opgeeft, moet je het geheel tussen aanhalingsteken zetten (zoals "/home/user/music/mijn hitje.mp3").