Provided by: exfalso_4.5.0-3_all bug

NAME

       operon - command line music tagger

SYNOPSIS

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

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 <tag> with the value <value> to all files.

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

       -h, --help
              Display help and exit

       Example:
              operon add artist 'The Beatles' song1.ogg song2.ogg

   remove
       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>...

       -h, --help
              Display help and exit

       --dry-run
              Print the results without changing any files

       -e,--regexp <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 <tag> by <value> in all files.

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

       -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 <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>...

       -h, --help
              Display help and exit

       --dry-run
              Print the results without changing any files

       -a, --all
              Remove all tags

       -e,--regexp <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 <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>

       -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] <file>

       -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] <pattern> <file>...

       -h, --help
              show this help message and exit

       --dry-run
              show changes, don't apply them

       Example:
              operon fill --dry-run "<tracknumber>. <title>" "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)