.\" Man page generated from reStructuredText. . .TH OPERON 1 "" "" "" .SH NAME operon \- command line music tagger . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .SH SYNOPSIS .nf \fBoperon\fP [\-\-version] [\-\-help] [\-v | \-\-verbose] <\fIcommand\fP> [<\fIargument\fP>...] \fBoperon help\fP <\fIcommand\fP> .fi .sp .SH OPTIONS .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .TP .B \-\-version Print the program version .TP .B \-v\fP,\fB \-\-verbose Verbose mode .UNINDENT .SH COMMAND-OVERVIEW .SS Edit Tags .nf \fIadd\fP Add a tag value \fIremove\fP Remove a tag value \fIset\fP Set a tag and remove existing values \fIclear\fP Remove tags \fIcopy\fP Copy tags from one file to another \fIedit\fP Edit tags in a text editor \fIfill\fP Fill tags based on the file path .fi .sp .SS Show file metadata .nf \fIlist\fP List tags \fIinfo\fP List file information \fIprint\fP Print tags based on the given pattern .fi .sp .SS Edit Embedded Images .nf \fIimage\-extract\fP Extract embedded images \fIimage\-set\fP Set embedded image \fIimage\-clear\fP Remove embedded images .fi .sp .SS Miscellaneous .nf \fItags\fP List all common tags \fIhelp\fP Display help information .fi .sp .SH EDIT TAGS .SS add .sp Add a new tag \fB\fP with the value \fB\fP to all files. .sp operon add [\-h] ... .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .UNINDENT .INDENT 0.0 .TP .B Example: operon add artist \(aqThe Beatles\(aq song1.ogg song2.ogg .UNINDENT .SS remove .sp Remove all values from the tag \fB\fP that match either \fB\fP or the regular expression \fB\fP from all files. .sp operon remove [\-h] [\-\-dry\-run] (\-e | ) ... .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .TP .B \-\-dry\-run Print the results without changing any files .TP .BI \-e\fP,\fB \-\-regexp \ Remove all tag values that match the given regular expression .UNINDENT .INDENT 0.0 .TP .B Example: operon remove artist \(aqThe Beatles\(aq song.ogg .UNINDENT .SS set .sp Replace all values of the tag \fB\fP by \fB\fP in all files. .sp operon set [\-h] [\-\-dry\-run] ... .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .TP .B \-\-dry\-run Print the results without changing any files .UNINDENT .INDENT 0.0 .TP .B Example: operon set artist \(aqThe Beatles\(aq song.ogg .UNINDENT .SS clear .sp Remove all tags that match \fB\fP or the regular expression \fB\fP from all files. If \fI\-\-all\fP is specified, all known tags will be removed. .sp operon clear [\-h] [\-\-dry\-run] (\-a | \-e | ) ... .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .TP .B \-\-dry\-run Print the results without changing any files .TP .B \-a\fP,\fB \-\-all Remove all tags .TP .BI \-e\fP,\fB \-\-regexp \ Remove all tags that match the given regular expression .UNINDENT .INDENT 0.0 .TP .B Example: operon clear \-a song.ogg .sp operon clear \-e \(aqmusicbrainz_.*\(aq song.ogg .sp operon clear date song.ogg .UNINDENT .SS copy .sp Copy all tags from the file \fI\fP to \fI\fP\&. All tags in \fB\fP will be preserved. In case the destination format doesn\(aqt support setting a tag from source, no tags will be copied. To ignore tags that aren\(aqt supported by the destination format pass \fI\-\-ignore\-errors\fP\&. .sp operon copy [\-h] [\-\-dry\-run] [\-\-ignore\-errors] .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .TP .B \-\-dry\-run Print the results without changing any files .TP .B \-\-ignore\-errors Skip tags which the target file does not support .UNINDENT .INDENT 0.0 .TP .B Example: operon copy song.flac song.ogg .UNINDENT .SS edit .sp Shows all tags in a text editor and will apply any changes made to the text to the tags. \fIoperon\fP will use the editor specified in the VISUAL or EDITOR environment variables and if those are not set fall back to \(aqnano\(aq. .sp operon edit [\-h] [\-\-dry\-run] .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .TP .B \-\-dry\-run Print the results without changing any files .UNINDENT .INDENT 0.0 .TP .B Example: VISUAL=vi operon edit song.flac .UNINDENT .SS fill .sp Fill tags based one file paths and a given pattern. .sp operon fill [\-h] [\-\-dry\-run] ... .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help show this help message and exit .TP .B \-\-dry\-run show changes, don\(aqt apply them .UNINDENT .INDENT 0.0 .TP .B Example: operon fill \-\-dry\-run ". " "01. Was Ist Ist.flac" .UNINDENT .SH SHOW FILE METADATA .SS list .sp Lists all tags, values and a description of each tag in a table. .sp operon list [\-h] [\-a] [\-t] [\-c <c1>,<c2>...] <file> .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .TP .B \-a\fP,\fB \-\-all Also list programmatic tags .TP .B \-t\fP,\fB \-\-terse Output is terse and suitable for script processing .UNINDENT .INDENT 0.0 .TP .B \-c, \-\-columns <name>,... Defines which columns should be printed and in which order .TP .B Example: operon list \-a song.flac .sp operon list \-t \-c tag,value song.ogg .UNINDENT .SS info .sp Lists non\-tag metadata like length, size and format. .sp operon info [\-h] [\-t] [\-c <c1>,<c2>...] <file> .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .TP .B \-t\fP,\fB \-\-terse Output is terse and suitable for script processing .UNINDENT .INDENT 0.0 .TP .B \-c, \-\-columns <name>,... Defines which columns should be printed and in which order .TP .B Example: operon info a.ogg .UNINDENT .SS print .sp Prints information per file built from tag values. The pattern can be customized by passing a pattern string (See \fBquodlibet\fP(1) for the pattern format) .sp operon print [\-h] [\-p <pattern>] <file>... .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .TP .BI \-p\fP,\fB \-\-pattern \ <pattern> Use a custom pattern .UNINDENT .INDENT 0.0 .TP .B Example: operon print \-p "<album> \- <artist>" a.ogg .UNINDENT .SH EDIT EMBEDDED IMAGES .SS image\-extract .sp Extract all embedded images to the current working directory or the specified destination directory. .sp operon image\-extract [\-h] [\-\-dry\-run] [\-\-primary] [\-d <destination>] <file>... .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .TP .B \-\-dry\-run Print the found images and resulting file paths but don\(aqt save them .TP .B \-\-primary Only extract the primary images for each file .TP .BI \-d\fP,\fB \-\-destination \ <destination> Save all images to the specified destination .UNINDENT .INDENT 0.0 .TP .B Example: operon image\-extract asong.mp3 anotherone.ogg .UNINDENT .SS image\-set .sp Set the provided image as primary embedded image and remove all other embedded images. .sp operon image\-set <image\-file> <file>... .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .UNINDENT .INDENT 0.0 .TP .B Example: operon image\-set cover.jpg song.mp3 .UNINDENT .SS image\-clear .sp Remove all embedded images from all specified files. .sp operon image\-clear <file>... .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .UNINDENT .INDENT 0.0 .TP .B Example: operon image\-clear song.mp3 .UNINDENT .SH MISCELLANEOUS .SS tags .sp List all common tags .sp operon tags [\-h] [\-a] [\-t] [\-c <c1>,<c2>...] .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help Display help and exit .TP .B \-a\fP,\fB \-\-all Also list programmatic tags .TP .B \-t\fP,\fB \-\-terse Output is terse and suitable for script processing .UNINDENT .INDENT 0.0 .TP .B \-c, \-\-columns <name>,... Defines which columns should be printed and in which order .TP .B Example: operon tags \-a .sp operon tags \-t \-c tag .UNINDENT .SS help .sp operon help [<command>] .INDENT 0.0 .TP .B Example: operon help list .UNINDENT .SH SEE ALSO .nf \fBregex\fP(7) \fBexfalso\fP(1) \fBquodlibet\fP(1) .fi .sp .\" Generated by docutils manpage writer. .