OPERON(1) OPERON(1)

operon - command line music tagger

operon [--version] [--help] [-v | --verbose] <command> [<argument>...]
operon help <command>

Display help and exit
Print the program version
Verbose mode

add         Add a tag value
remove      Remove a tag value
set         Set a tag and remove existing values
clear       Remove tags
copy        Copy tags from one file to another
edit        Edit tags in a text editor
fill        Fill tags based on the file path

list        List tags
info        List file information
print       Print tags based on the given pattern

image-extract    Extract embedded images
image-set        Set embedded image
image-clear      Remove embedded images

tags        List all common tags
help        Display help information

Add a new tag <tag> with the value <value> to all files.

operon add [-h] <tag> <value> <file>...

Display help and exit
operon add artist 'The Beatles' song1.ogg song2.ogg

Remove all values from the tag <tag> that match either <value> or the regular expression <pattern> from all files.

operon remove [-h] [--dry-run] <tag> (-e <pattern> | <value>) <file>...

Display help and exit
Print the results without changing any files
Remove all tag values that match the given regular expression
operon remove artist 'The Beatles' song.ogg

Replace all values of the tag <tag> by <value> in all files.

operon set [-h] [--dry-run] <tag> <value> <file>...

Display help and exit
Print the results without changing any files
operon set artist 'The Beatles' song.ogg

Remove all tags that match <tag> or the regular expression <pattern> from all files. If --all is specified, all known tags will be removed.

operon clear [-h] [--dry-run] (-a | -e <pattern> | <tag>) <file>...

Display help and exit
Print the results without changing any files
Remove all tags
Remove all tags that match the given regular expression
operon clear -a song.ogg

operon clear -e 'musicbrainz_.*' song.ogg

operon clear date song.ogg

Copy all tags from the file <source> to <dest>. All tags in <dest> will be preserved. In case the destination format doesn't support setting a tag from source, no tags will be copied. To ignore tags that aren't supported by the destination format pass --ignore-errors.

operon copy [-h] [--dry-run] [--ignore-errors] <source> <dest>

Display help and exit
Print the results without changing any files
Skip tags which the target file does not support
operon copy song.flac song.ogg

Shows all tags in a text editor and will apply any changes made to the text to the tags. operon will use the editor specified in the VISUAL or EDITOR environment variables and if those are not set fall back to 'nano'.

operon edit [-h] [--dry-run] <file>

Display help and exit
Print the results without changing any files
VISUAL=vi operon edit song.flac

Fill tags based one file paths and a given pattern.

operon fill [-h] [--dry-run] <pattern> <file>...

show this help message and exit
show changes, don't apply them
operon fill --dry-run "<tracknumber>. <title>" "01. Was Ist Ist.flac"

Lists all tags, values and a description of each tag in a table.

operon list [-h] [-a] [-t] [-c <c1>,<c2>...] <file>

Display help and exit
Also list programmatic tags
Output is terse and suitable for script processing
Defines which columns should be printed and in which order
operon list -a song.flac

operon list -t -c tag,value song.ogg

Lists non-tag metadata like length, size and format.

operon info [-h] [-t] [-c <c1>,<c2>...] <file>

Display help and exit
Output is terse and suitable for script processing
Defines which columns should be printed and in which order
operon info a.ogg

Prints information per file built from tag values. The pattern can be customized by passing a pattern string (See quodlibet(1) for the pattern format)

operon print [-h] [-p <pattern>] <file>...

Display help and exit
Use a custom pattern
operon print -p "<album> - <artist>" a.ogg

Extract all embedded images to the current working directory or the specified destination directory.

operon image-extract [-h] [--dry-run] [--primary] [-d <destination>] <file>...

Display help and exit
Print the found images and resulting file paths but don't save them
Only extract the primary images for each file
Save all images to the specified destination
operon image-extract asong.mp3 anotherone.ogg

Set the provided image as primary embedded image and remove all other embedded images.

operon image-set <image-file> <file>...

Display help and exit
operon image-set cover.jpg song.mp3

Remove all embedded images from all specified files.

operon image-clear <file>...

Display help and exit
operon image-clear song.mp3

List all common tags

operon tags [-h] [-a] [-t] [-c <c1>,<c2>...]

Display help and exit
Also list programmatic tags
Output is terse and suitable for script processing
Defines which columns should be printed and in which order
operon tags -a

operon tags -t -c tag

operon help [<command>]

operon help list

regex(7)
exfalso(1)
quodlibet(1)