1MID3V2(1)                                                            MID3V2(1)
2
3
4

NAME

6       mid3v2 - audio tag editor similar to 'id3v2'
7

SYNOPSIS

9       mid3v2 [options] filename ...
10

DESCRIPTION

12       mid3v2  is  a Mutagen-based replacement for id3lib's id3v2. It supports
13       ID3v2.4 and more frames; it also does not have the numerous  bugs  that
14       plague id3v2.
15
16       This program exists mostly for compatibility with programs that want to
17       tag files using id3v2. For a more usable  interface,  we  recommend  Ex
18       Falso.
19

OPTIONS

21       -q, --quiet
22              Be quiet: do not mention file operations that perform the user's
23              request. Warnings will still be printed.
24
25       -v, --verbose
26              Be verbose: state all operations performed. This is the opposite
27              of --quiet. This is the default.
28
29       -e, --escape
30              Enable  interpretation  of  backslash  escapes  for  tag values.
31              Makes it possible to escape the colon-separator in  TXXX,  WXXX,
32              COMM  values  like  '\:'  and insert escape sequences like '\n',
33              '\t' etc.
34
35       -f, --list-frames
36              Display all supported ID3v2.3/2.4 frames and their meanings.
37
38       -L, --list-genres
39              List all ID3v1 numeric genres. These can be  used  to  set  TCON
40              frames, but it is not recommended.
41
42       -l, --list
43              List all tags in the files. The output format is not the same as
44              id3v2's; instead, it is easily parsable and readable. Some  tags
45              may not have human-readable representations.
46
47       --list-raw
48              List  all tags in the files, in raw format. Although this format
49              is nominally human-readable, it may be very long if the tag con‐
50              tains embedded binary data.
51
52       -d, --delete-v2
53              Delete ID3v2 tags.
54
55       -s, --delete-v1
56              Delete ID3v1 tags.
57
58       -D, --delete-all
59              Delete all ID3 tags.
60
61       --delete-frames=FRAMES
62              Delete  specific  ID3v2  frames  (or  groups of frames) from the
63              files.  FRAMES is a ","  separated  list  of  frame  names  e.g.
64              "TPE1,TALB"
65
66       -C, --convert
67              Convert  ID3v1  tags to ID3v2 tags. This  will also happen auto‐
68              matically during any editing.
69
70       -a,--artist=ARTIST
71              Set the artist information (TPE1).
72
73       -A,--album=ALBUM
74              Set the album information (TALB).
75
76       -t,--song=TITLE
77              Set the title information (TIT2).
78
79       -c,--comment=<DESCRIPTION:COMMENT:LANGUAGE>
80              Set a comment (COMM). The language and description may be  omit‐
81              ted,  in  which  case  the language defaults to English, and the
82              description to an empty string.
83
84       -p,--picture=<FILENAME:DESCRIPTION:IMAGE-TYPE:MIME-TYPE>
85              Set the attached picture (APIC). Everything except the  filename
86              can be omitted in which case default values will be used.
87
88       -g,--genre=GENRE
89              Set the genre information (TCON).
90
91       -y,--year=<YYYY>, --date=<YYYY-[MM-DD]>
92              Set the year/date information (TDRC).
93
94       -T,--track=<NUM/NUM>
95              Set the track number (TRCK).
96
97       Any  text or URL frame (those beginning with T or W) can be modified or
98       added by prefixing the name of the frame with "--". For example, --TIT3
99       "Monkey!" will set the TIT3 (subtitle) frame to Monkey!.
100
101       The  TXXX frame has the format <DESCRIPTION:TEXT>; many TXXX frames may
102       be set in the file as long as they have different  keys.  To  set  this
103       key,  just  separate  the  text with a colon, e.g. --TXXX "ALBUMARTIST‐
104       SORT:Examples, The". The description can be omitted in  which  case  it
105       defaults to an empty string.
106
107       The  WXXX frame has the same format as TXXX but since URLs usually con‐
108       tain a ":" you have provide a  description  or  enable  escaping  (-e):
109       --WXXX "desc:http://foo.bar" or -e --WXXX "http\\://foo.bar"
110
111       The USLT frame has the format <DESCRIPTION:TEXT:LANGUAGE>. The language
112       and description may be omitted, in which case the language defaults  to
113       English, and the description to an empty string.
114
115       The  special  POPM frame can be set in a similar way: --POPM "bob@exam‐
116       ple.com:128:2" to set Bob's rating to 128/255 with 2 plays.
117

BUGS

119       No sanity checking is done on the editing operations  you  perform,  so
120       mid3v2  will  happily accept --TSIZ when editing an ID3v2.4 frame. How‐
121       ever, it will also automatically throw it  out  during  the  next  edit
122       operation.
123

AUTHOR

125       Joe Wreschnig is the author of mid3v2, but he doesn't like to admit it.
126
127
128
129
130                                                                     MID3V2(1)
Impressum