--- name: "operon" section: "1" platform: "linux" package: "quodlibet" version: "4.7.1-3" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/operon" --- # operon(1) command line music tagger ## 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 \,\...\] \ - **-h, --help** Display help and exit - **-a, --all** Also list programmatic tags - **-t, --terse** Output is terse and suitable for script processing - **-c, --columns \,...** 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 \,\...\] \ - **-h, --help** Display help and exit - **-t, --terse** Output is terse and suitable for script processing - **-c, --columns \,...** 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)](/quodlibet/1.md) for the pattern format) operon print \[-h\] \[-p \\] \... - **-h, --help** Display help and exit - **-p,***--pattern* **\** Use a custom pattern - **Example:** operon print -p "\ - \" 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 \\] \... - **-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* **\** 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 \ \... - **-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 \... - **-h, --help** Display help and exit - **Example:** operon image-clear song.mp3 ## MISCELLANEOUS ### tags List all common tags operon tags \[-h\] \[-a\] \[-t\] \[-c \,\...\] - **-h, --help** Display help and exit - **-a, --all** Also list programmatic tags - **-t, --terse** Output is terse and suitable for script processing - **-c, --columns \,...** Defines which columns should be printed and in which order - **Example:** operon tags -a operon tags -t -c tag ### help operon help \[\\] - **Example:** operon help list ## SEE ALSO ``` regex(7) exfalso(1) quodlibet(1) ```