1OPERON(1)                                                            OPERON(1)
2
3
4

NAME

6       operon - command line music tagger
7

SYNOPSIS

9       operon [--version] [--help] [-v | --verbose] <command> [<argument>...]
10       operon help <command>
11
12

OPTIONS

14       -h, --help
15              Display help and exit
16
17       --version
18              Print the program version
19
20       -v, --verbose
21              Verbose mode
22

COMMAND-OVERVIEW

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
33
34   Show file metadata
35       list        List tags
36       info        List file information
37       print       Print tags based on the given pattern
38
39
40   Edit Embedded Images
41       image-extract    Extract embedded images
42       image-set        Set embedded image
43       image-clear      Remove embedded images
44
45
46   Miscellaneous
47       tags        List all common tags
48       help        Display help information
49
50

EDIT TAGS

52   add
53       Add a new tag <tag> with the value <value> to all files.
54
55       operon add [-h] <tag> <value> <file>...
56
57       -h, --help
58              Display help and exit
59
60       Example:
61              operon add artist 'The Beatles' song1.ogg song2.ogg
62
63   remove
64       Remove  all  values from the tag <tag> that match either <value> or the
65       regular expression <pattern> from all files.
66
67       operon remove [-h] [--dry-run] <tag> (-e <pattern> | <value>) <file>...
68
69       -h, --help
70              Display help and exit
71
72       --dry-run
73              Print the results without changing any files
74
75       -e,--regexp <regexp>
76              Remove all tag values that match the given regular expression
77
78       Example:
79              operon remove artist 'The Beatles' song.ogg
80
81   set
82       Replace all values of the tag <tag> by <value> in all files.
83
84       operon set [-h] [--dry-run] <tag> <value> <file>...
85
86       -h, --help
87              Display help and exit
88
89       --dry-run
90              Print the results without changing any files
91
92       Example:
93              operon set artist 'The Beatles' song.ogg
94
95   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
99       operon clear [-h] [--dry-run] (-a | -e <pattern> | <tag>) <file>...
100
101       -h, --help
102              Display help and exit
103
104       --dry-run
105              Print the results without changing any files
106
107       -a, --all
108              Remove all tags
109
110       -e,--regexp <regexp>
111              Remove all tags that match the given regular expression
112
113       Example:
114              operon clear -a song.ogg
115
116              operon clear -e 'musicbrainz_.*' song.ogg
117
118              operon clear date song.ogg
119
120   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
126       operon copy [-h] [--dry-run] [--ignore-errors] <source> <dest>
127
128       -h, --help
129              Display help and exit
130
131       --dry-run
132              Print the results without changing any files
133
134       --ignore-errors
135              Skip tags which the target file does not support
136
137       Example:
138              operon copy song.flac song.ogg
139
140   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
146       operon edit [-h] [--dry-run] <file>
147
148       -h, --help
149              Display help and exit
150
151       --dry-run
152              Print the results without changing any files
153
154       Example:
155              VISUAL=vi operon edit song.flac
156
157   fill
158       Fill tags based one file paths and a given pattern.
159
160       operon fill [-h] [--dry-run] <pattern> <file>...
161
162       -h, --help
163              show this help message and exit
164
165       --dry-run
166              show changes, don't apply them
167
168       Example:
169              operon  fill  --dry-run  "<tracknumber>.  <title>"  "01. Was Ist
170              Ist.flac"
171

SHOW FILE METADATA

173   list
174       Lists all tags, values and a description of each tag in a table.
175
176       operon list [-h] [-a] [-t] [-c <c1>,<c2>...] <file>
177
178       -h, --help
179              Display help and exit
180
181       -a, --all
182              Also list programmatic tags
183
184       -t, --terse
185              Output is terse and suitable for script processing
186
187       -c, --columns <name>,...
188              Defines which columns should be printed and in which order
189
190       Example:
191              operon list -a song.flac
192
193              operon list -t -c tag,value song.ogg
194
195   info
196       Lists non-tag metadata like length, size and format.
197
198       operon info [-h] [-t] [-c <c1>,<c2>...] <file>
199
200       -h, --help
201              Display help and exit
202
203       -t, --terse
204              Output is terse and suitable for script processing
205
206       -c, --columns <name>,...
207              Defines which columns should be printed and in which order
208
209       Example:
210              operon info a.ogg
211
212   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
217       operon print [-h] [-p <pattern>] <file>...
218
219       -h, --help
220              Display help and exit
221
222       -p,--pattern <pattern>
223              Use a custom pattern
224
225       Example:
226              operon print -p "<album> - <artist>" a.ogg
227

EDIT EMBEDDED IMAGES

229   image-extract
230       Extract all embedded images to the current  working  directory  or  the
231       specified destination directory.
232
233       operon  image-extract  [-h]  [--dry-run] [--primary] [-d <destination>]
234       <file>...
235
236       -h, --help
237              Display help and exit
238
239       --dry-run
240              Print the found images and resulting file paths but  don't  save
241              them
242
243       --primary
244              Only extract the primary images for each file
245
246       -d,--destination <destination>
247              Save all images to the specified destination
248
249       Example:
250              operon image-extract asong.mp3 anotherone.ogg
251
252   image-set
253       Set  the  provided image as primary embedded image and remove all other
254       embedded images.
255
256       operon image-set <image-file> <file>...
257
258       -h, --help
259              Display help and exit
260
261       Example:
262              operon image-set cover.jpg song.mp3
263
264   image-clear
265       Remove all embedded images from all specified files.
266
267       operon image-clear <file>...
268
269       -h, --help
270              Display help and exit
271
272       Example:
273              operon image-clear song.mp3
274

MISCELLANEOUS

276   tags
277       List all common tags
278
279       operon tags [-h] [-a] [-t] [-c <c1>,<c2>...]
280
281       -h, --help
282              Display help and exit
283
284       -a, --all
285              Also list programmatic tags
286
287       -t, --terse
288              Output is terse and suitable for script processing
289
290       -c, --columns <name>,...
291              Defines which columns should be printed and in which order
292
293       Example:
294              operon tags -a
295
296              operon tags -t -c tag
297
298   help
299       operon help [<command>]
300
301       Example:
302              operon help list
303

SEE ALSO

305       regex(7)
306       exfalso(1)
307       quodlibet(1)
308
309
310
311
312
313                                                                     OPERON(1)
Impressum