Executable Commands
Picard can accept commands for processing by specifying them on the command line using
the -e
option or loading them from a text file. Commands are case-insensitive, and
are processed sequentially in the order that they are received. The executable commands
that Picard recognizes are:
FINGERPRINT
Calculate acoustic fingerprints for all (matched) files in the album pane.
FROM_FILE
Load commands from a file. The file path can be either an absolute or relative
path to a text file containing the commands to be executed. Each command to be
processed must be on a separate line along with its arguments (if applicable). Blank
lines and lines beginning with an octothorpe (#) are ignored. Command files can
include other command files by specifying them with another FROM_FILE
command.
Circular references (by including a command file that is currently being processed)
are ignored and will be logged as a warning.
LOAD
Load one or more files/directories/MBIDs/URLs to Picard. This is similar to including the file, directory path, URL or MBID on the command line.
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"
.
LOOKUP
Lookup files in the clustering pane. Options are clustered files, unclustered files or all files. If not specified, the command defaults to all files.
LOOKUP_CD
Read CD from the selected drive or ripper log file, and looks it up on MusicBrainz. If no argument is specified, it defaults to the first (alphabetically) available disc drive.
PAUSE
Pause executable command processing for the specified number of seconds.
QUIT
Exits the running instance of Picard. Once a QUIT
command has been queued, Picard will
not queue any further executable commands.
REMOVE
Removes the specified file(s) from Picard. Does nothing if no arguments provided.
REMOVE_SAVED
Removes all saved files from the album pane.
REMOVE_UNCLUSTERED
Removes all unclustered files from the cluster pane.
SAVE_MATCHED
Saves all matched files from the album pane.
SAVE_MODIFIED
Saves all modified files from the album pane.
SUBMIT_FINGERPRINTS
Submits outstanding acoustic fingerprints for all (matched) files in the album pane.
WRITE_LOGS
Writes the Picard logs to the specified output file.