1OPERON(1) OPERON(1)
2
6 operon - command line music tagger
7
9 operon [--version] [--help] [-v | --verbose] <command> [<argument>...]
10 operon help <command>
11
14 -h, --help
15 Display help and exit
16 --version
18 Print the program version
19 -v, --verbose
21 Verbose mode
22
24 Edit Tags
25 add Add a tag value
26 remove Remove a tag value
27 set Set a tag and remove existing values
28 clear Remove tags
29 copy Copy tags from one file to another
30 edit Edit tags in a text editor
31 fill Fill tags based on the file path
32 Show file metadata
35 list List tags
36 info List file information
37 print Print tags based on the given pattern
38 Edit Embedded Images
41 image-extract Extract embedded images
42 image-set Set embedded image
43 image-clear Remove embedded images
44 Miscellaneous
47 tags List all common tags
48 help Display help information
49
52 add
53 Add a new tag <tag> with the value <value> to all files.
54 operon add [-h] <tag> <value> <file>...
56 -h, --help
58 Display help and exit
59 Example:
61 operon add artist 'The Beatles' song1.ogg song2.ogg
62 remove
64 Remove all values from the tag <tag> that match either <value> or the
65 regular expression <pattern> from all files.
66 operon remove [-h] [--dry-run] <tag> (-e <pattern> | <value>) <file>...
68 -h, --help
70 Display help and exit
71 --dry-run
73 Print the results without changing any files
74 -e,--regexp <regexp>
76 Remove all tag values that match the given regular expression
77 Example:
79 operon remove artist 'The Beatles' song.ogg
80 set
82 Replace all values of the tag <tag> by <value> in all files.
83 operon set [-h] [--dry-run] <tag> <value> <file>...
85 -h, --help
87 Display help and exit
88 --dry-run
90 Print the results without changing any files
91 Example:
93 operon set artist 'The Beatles' song.ogg
94 clear
96 Remove all tags that match <tag> or the regular expression <pattern>
97 from all files. If --all is specified, all known tags will be removed.
98 operon clear [-h] [--dry-run] (-a | -e <pattern> | <tag>) <file>...
100 -h, --help
102 Display help and exit
103 --dry-run
105 Print the results without changing any files
106 -a, --all
108 Remove all tags
109 -e,--regexp <regexp>
111 Remove all tags that match the given regular expression
112 Example:
114 operon clear -a song.ogg
115 operon clear -e 'musicbrainz_.*' song.ogg
117 operon clear date song.ogg
119 copy
121 Copy all tags from the file <source> to <dest>. All tags in <dest> will
122 be preserved. In case the destination format doesn't support setting a
123 tag from source, no tags will be copied. To ignore tags that aren't
124 supported by the destination format pass --ignore-errors.
125 operon copy [-h] [--dry-run] [--ignore-errors] <source> <dest>
127 -h, --help
129 Display help and exit
130 --dry-run
132 Print the results without changing any files
133 --ignore-errors
135 Skip tags which the target file does not support
136 Example:
138 operon copy song.flac song.ogg
139 edit
141 Shows all tags in a text editor and will apply any changes made to the
142 text to the tags. operon will use the editor specified in the VISUAL or
143 EDITOR environment variables and if those are not set fall back to
144 'nano'.
145 operon edit [-h] [--dry-run] <file>
147 -h, --help
149 Display help and exit
150 --dry-run
152 Print the results without changing any files
153 Example:
155 VISUAL=vi operon edit song.flac
156 fill
158 Fill tags based one file paths and a given pattern.
159 operon fill [-h] [--dry-run] <pattern> <file>...
161 -h, --help
163 show this help message and exit
164 --dry-run
166 show changes, don't apply them
167 Example:
169 operon fill --dry-run "<tracknumber>. <title>" "01. Was Ist
170 Ist.flac"
171
173 list
174 Lists all tags, values and a description of each tag in a table.
175 operon list [-h] [-a] [-t] [-c <c1>,<c2>...] <file>
177 -h, --help
179 Display help and exit
180 -a, --all
182 Also list programmatic tags
183 -t, --terse
185 Output is terse and suitable for script processing
186 -c, --columns <name>,...
188 Defines which columns should be printed and in which order
189 Example:
191 operon list -a song.flac
192 operon list -t -c tag,value song.ogg
194 info
196 Lists non-tag metadata like length, size and format.
197 operon info [-h] [-t] [-c <c1>,<c2>...] <file>
199 -h, --help
201 Display help and exit
202 -t, --terse
204 Output is terse and suitable for script processing
205 -c, --columns <name>,...
207 Defines which columns should be printed and in which order
208 Example:
210 operon info a.ogg
211 print
213 Prints information per file built from tag values. The pattern can be
214 customized by passing a pattern string (See quodlibet(1) for the pat‐
215 tern format)
216 operon print [-h] [-p <pattern>] <file>...
218 -h, --help
220 Display help and exit
221 -p,--pattern <pattern>
223 Use a custom pattern
224 Example:
226 operon print -p "<album> - <artist>" a.ogg
227
229 image-extract
230 Extract all embedded images to the current working directory or the
231 specified destination directory.
232 operon image-extract [-h] [--dry-run] [--primary] [-d <destination>]
234 <file>...
235 -h, --help
237 Display help and exit
238 --dry-run
240 Print the found images and resulting file paths but don't save
241 them
242 --primary
244 Only extract the primary images for each file
245 -d,--destination <destination>
247 Save all images to the specified destination
248 Example:
250 operon image-extract asong.mp3 anotherone.ogg
251 image-set
253 Set the provided image as primary embedded image and remove all other
254 embedded images.
255 operon image-set <image-file> <file>...
257 -h, --help
259 Display help and exit
260 Example:
262 operon image-set cover.jpg song.mp3
263 image-clear
265 Remove all embedded images from all specified files.
266 operon image-clear <file>...
268 -h, --help
270 Display help and exit
271 Example:
273 operon image-clear song.mp3
274
276 tags
277 List all common tags
278 operon tags [-h] [-a] [-t] [-c <c1>,<c2>...]
280 -h, --help
282 Display help and exit
283 -a, --all
285 Also list programmatic tags
286 -t, --terse
288 Output is terse and suitable for script processing
289 -c, --columns <name>,...
291 Defines which columns should be printed and in which order
292 Example:
294 operon tags -a
295 operon tags -t -c tag
297 help
299 operon help [<command>]
300 Example:
302 operon help list
303
305 regex(7)
306 exfalso(1)
307 quodlibet(1)
308 OPERON(1)