operon - command line music tagger
Contents
Command-Overview
EditTagsadd 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
Showfilemetadatalist List tags
info List file information
print Print tags based on the given pattern
EditEmbeddedImagesimage-extract Extract embedded images
image-set Set embedded image
image-clear Remove embedded images
Miscellaneoustags List all common tags
help Display help information
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
Name
operon - command line music tagger
Options
-h, --help
Display help and exit
--version
Print the program version
-v, --verbose
Verbose mode
See Also
regex(7) exfalso(1) quodlibet(1) OPERON(1)
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
Synopsis
operon [--version] [--help] [-v | --verbose] <command> [<argument>...]
operonhelp <command>
