1
.TH EYED3 "1" "Apr. 08, 2005" "eyeD3 0.6.4" ""
4
\- displays and manipulates id3-tags on mp3 files
19
Manipulates ID3 tags in mp3 files and is able to read/write and convert between
20
ID3 v1.0, v1.1, v2.3 and v2.4 tags. High-level access is provided to most
21
frames, including APIC (i.e., images) frames.
24
\fB\-h, \fB\-\-help\fR
25
Shows a brief help string and exit.
28
Show program's version number and exit.
33
\fB\-v\fR, \fB\-\-verbose\fR
34
Show all available tag information.
37
Trace program execution; for debugging.
42
Only read/write ID3 v1 tags. By default, v1 tags are only read if there is
46
Only read/write ID3 v2.x tags.
49
Convert the file's tag to ID3 v1.1. (Or 1.0 if there is no track number)
52
Convert the file's tag to ID3 v2.3.
55
Convert the file's tag to ID3 v2.4
58
Options for manipulating tag data have the side-effect of removing a frame
59
when the data specified is the empty string. For example, --artist=""
60
(or -a "") would cause the artist frame to be removed. This is especially
61
useful for removing comment frames.
64
\fB-a \fRSTRING, \fB\-\-artist=\fRSTRING\fR
65
Set artist the to STRING.
67
\fB-A \fRSTRING, \fB\-\-album=\fRSTRING\fR
70
\fB-t \fRSTRING, \fB\-\-title=\fRSTRING\fR
71
Set track title to STRING.
72
\fB-n \fRNUM, \fB\-\-track=\fRNUM\fR
73
Set track number to NUM.
75
\fB-N \fRNUM, \fB\-\-track\-total=\fRNUM\fR
76
Set total number of tracks to NUM.
78
\fB-G \fRSTRING, \fB\-\-track\-genre=\fRSTRING\fR
79
Sets genre to STRING. (See --list-genres)
81
\fB-Y \fRYEAR, \fB\-\-year=\fRYEAR\fR
82
Set the four digit year.
84
\fB\-\-comment=\fR[LANGUAGE]:DESCRIPTION:COMMENT\fR
85
Add (or remove when COMMENT is "") a comment. Note that the argument value
86
MUST always contain exactly two ':' characters to delimit the fields even
87
when the default language is being used. The DESCRIPTION string is the
89
The optional LANGUAGE string MUST be a three-character ISO 639
90
language code. The default is "eng" for English.
92
A tag may not have more than one comment frame with the same DESCRIPTION and
95
\fB\-\-remove-comments\fR
96
Remove all comment frames from the tag.
98
\fB\-\-add\-image=\fRIMG_PATH:TYPE[:DESCRIPTION]\fR
99
Add an image to the tag.
100
The IMG_PATH is required and points to the image file to add to the tag.
101
The TYPE is one of the types listed when 'eyeD3 --list-image-types' is run.
102
It is used to classify what the image pertains to.
103
The DESCRIPTION is optional and will default to "".
105
A tag may not have more than one image frame with the same DESCRIPTION and
108
\fB\-i, \-\-write-images\fR
109
Causes all attached images (APIC frames) to be written to the current directory.
110
They are named by their type. For example, if the image is a png and the type
111
is OTHER, a file named OTHER.png is written to the current directory.
113
\fB\-\-set\-text\-frame=\fRFID:TEXT\fR
114
Set the value of a specific (i.e., FID) text frame. To remove the frame,
115
specify an empty value. e.g., --set-text-frame="TDRC:"
117
\fB\-\-play\-count=\fR[+]N\fR
118
Set the play count (PCNT). If the argument value begins with '+' the value is
119
incremented by N, otherwise it is set to exactly N.
121
\fB\-\-unique\-file-id=\fROWNER_ID:ID\fR
122
Add a UFID frame. If the ID arg is empty the UFID frame with OWNER_ID is
123
removed. An OWNER_ID MUST be specified.
125
\fB\-\-set\-encoding=\fRlatin1|utf8|utf16-LE|utf16-BE\fR
126
Set the encoding that is used for _all_ text frames in the tag. The encoding
127
is applied only when the tag is updated, therefore a frame must be set or
128
--force-update is present. Note that, unfortunately, utf8 is not supported
142
\fB\-\-rename=\fRPATTERN\fR
143
Rename the file based on PATTERN which may contain the following substitution
144
variables: %A (artist), %a (album), %t (title), %n (track number), and
145
%N (the total track count). The PATTERN string MUST not contain the file
148
\fB\-l\fR, \fB\-\-list\-genres\fR
149
Display the table of "valid" ID3 genres and exit.
151
\fB\-\-list\-image\-types\fR
152
List all possible image types for APIC frames.
155
Fail for tags that violate the ID3 specification.
158
Output the tag per the format described in JEP-0118. See
159
http://www.jabber.org/jeps/jep-0118.html
161
\fB\-\-force\-update\fR
162
Update the tag regardless of whether any frames were set on the command line.
165
http://eyed3.nicfit.net/
168
eyeD3 was written by Travis Shirk <travis@pobox.com>. This manpage was written
169
by Alexander Wirt <formorer@debian.org> for the Debian Distribution and Travis