OPERON(1) OPERON(1) NAME operon - command line music tagger SYNOPSIS operon [--version] [--help] [-v | --verbose] [...] operon help OPTIONS -h, --help Display help and exit --version Print the program version -v, --verbose Verbose mode COMMAND-OVERVIEW Edit Tags 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 Show file metadata list List tags info List file information print Print tags based on the given pattern Edit Embedded Images image-extract Extract embedded images image-set Set embedded image image-clear Remove embedded images Miscellaneous tags List all common tags help Display help information EDIT TAGS add Add a new tag with the value to all files. operon add [-h] ... -h, --help Display help and exit Example: operon add artist 'The Beatles' song1.ogg song2.ogg remove Remove all values from the tag that match either or the regular expression from all files. operon remove [-h] [--dry-run] (-e | ) ... -h, --help Display help and exit --dry-run Print the results without changing any files -e,--regexp Remove all tag values that match the given regular expression Example: operon remove artist 'The Beatles' song.ogg set Replace all values of the tag by in all files. operon set [-h] [--dry-run] ... -h, --help Display help and exit --dry-run Print the results without changing any files Example: operon set artist 'The Beatles' song.ogg clear Remove all tags that match or the regular expression from all files. If --all is specified, all known tags will be removed. operon clear [-h] [--dry-run] (-a | -e | ) ... -h, --help Display help and exit --dry-run Print the results without changing any files -a, --all Remove all tags -e,--regexp Remove all tags that match the given regular expression Example: operon clear -a song.ogg operon clear -e 'musicbrainz_.*' song.ogg operon clear date song.ogg copy Copy all tags from the file to . All tags in 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] -h, --help Display help and exit --dry-run Print the results without changing any files --ignore-errors Skip tags which the target file does not support Example: operon copy song.flac song.ogg edit 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] -h, --help Display help and exit --dry-run Print the results without changing any files Example: VISUAL=vi operon edit song.flac fill Fill tags based one file paths and a given pattern. operon fill [-h] [--dry-run] ... -h, --help show this help message and exit --dry-run show changes, don't apply them Example: operon fill --dry-run ". " "01. Was Ist Ist.flac" SHOW FILE METADATA list Lists all tags, values and a description of each tag in a table. operon list [-h] [-a] [-t] [-c <c1>,<c2>...] <file> -h, --help Display help and exit -a, --all Also list programmatic tags -t, --terse Output is terse and suitable for script processing -c, --columns <name>,... Defines which columns should be printed and in which order Example: operon list -a song.flac operon list -t -c tag,value song.ogg info Lists non-tag metadata like length, size and format. operon info [-h] [-t] [-c <c1>,<c2>...] <file> -h, --help Display help and exit -t, --terse Output is terse and suitable for script processing -c, --columns <name>,... Defines which columns should be printed and in which order Example: operon info a.ogg print 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>... -h, --help Display help and exit -p,--pattern <pattern> Use a custom pattern Example: operon print -p "<album> - <artist>" a.ogg EDIT EMBEDDED IMAGES image-extract Extract all embedded images to the current working directory or the specified destination directory. operon image-extract [-h] [--dry-run] [--primary] [-d <destination>] <file>... -h, --help Display help and exit --dry-run Print the found images and resulting file paths but don't save them --primary Only extract the primary images for each file -d,--destination <destination> Save all images to the specified destination Example: operon image-extract asong.mp3 anotherone.ogg image-set Set the provided image as primary embedded image and remove all other embedded images. operon image-set <image-file> <file>... -h, --help Display help and exit Example: operon image-set cover.jpg song.mp3 image-clear Remove all embedded images from all specified files. operon image-clear <file>... -h, --help Display help and exit Example: operon image-clear song.mp3 MISCELLANEOUS tags List all common tags operon tags [-h] [-a] [-t] [-c <c1>,<c2>...] -h, --help Display help and exit -a, --all Also list programmatic tags -t, --terse Output is terse and suitable for script processing -c, --columns <name>,... Defines which columns should be printed and in which order Example: operon tags -a operon tags -t -c tag help operon help [<command>] Example: operon help list SEE ALSO regex(7) exfalso(1) quodlibet(1) OPERON(1)