1MID3V2(1) MID3V2(1)
2
3
4
6 mid3v2 - audio tag editor similar to 'id3v2'
7
9 mid3v2 [options] filename ...
10
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
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
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
125 Joe Wreschnig is the author of mid3v2, but he doesn't like to admit it.
126
127
128
129
130 MID3V2(1)