Appendix C: Command Line Options

Picard can be started from the command line with the following arguments: [-h] [-a AUDIT] [-c CONFIG_FILE] [-d] [-e COMMAND [COMMAND ...]] [-M] [-N] [-P] [--no-crash-dialog] [-s] [-v] [-V] [FILE_OR_URL ...]

where the options are:

-h, --help

show a help message and exit

-a AUDIT, --audit AUDIT

audit events passed as a comma-separated list, prefixes supported, use “all” to match any event. See the Python Documentation for more information.

-c CONFIG_FILE, --config-file CONFIG_FILE

location of the configuration file to use

-d, --debug

enable debug-level logging


execute one or more COMMANDs at start-up (see Executable Commands for more information)

-M, --no-player

disable built-in media player

-N, --no-restore

do not restore window positions or sizes

-P, --no-plugins

do not load any plugins


disable the crash dialog

-s, --stand-alone-instance

force Picard to create a new, stand-alone instance

-v, --version

display the version information and exit

-V, --long-version

display the long version information and exit


one or more files, directories, URLs and MBIDs to load


Files and directories are specified including the path (either absolute or relative) to the file or directory, and may include drive specifiers. They can also be specified using the file:// prefix. URLs are specified by using either the http:// or https:// prefix. MBIDs are specified in the format mbid://<entity_type>/<mbid> where <entity_type> is one of “release”, “artist” or “track” and <mbid> is the MusicBrainz Identifier of the entity.

If a specified item contains a space, it must be enclosed in quotes such as "/home/user/music/my song.mp3".