NAME¶
eyeD3 - displays and manipulates id3-tags on mp3 files
SYNOPSIS¶
eyeD3 [
options] file [
file...]
eyeD3 [
options] dir [
dir...]
DESCRIPTION¶
eyeD3 Manipulates ID3 tags in mp3 files and is able to read/write and
convert between ID3 v1.0, v1.1, v2.3 and v2.4 tags. High-level access is
provided to most frames, including APIC (i.e., images) frames.
OPTIONS¶
-h, --help Shows a brief help string and exit.
- --version
- Show program's version number and exit.
- --no-color
- Disable color output.
- -v, --verbose
- Show all available tag information.
- --debug
- Trace program execution; for debugging.
TAG VERSIONS¶
- -1, --v1
- Only read/write ID3 v1 tags. By default, v1 tags are only read if there is
not a v2 tag.
- -2, --v2
- Only read/write ID3 v2.x tags.
- --to-v1.1
- Convert the file's tag to ID3 v1.1. (Or 1.0 if there is no track
number)
- --to-v2.3
- Convert the file's tag to ID3 v2.3.
- --to-v2.4
- Convert the file's tag to ID3 v2.4
TAG DATA¶
Options for manipulating tag data have the side-effect of removing a frame when
the data specified is the empty string. For example, --artist="" (or
-a "") would cause the artist frame to be removed. This is
especially useful for removing comment frames.
- -a STRING, --artist=STRING
- Set artist the to STRING.
- -A STRING, --album=STRING
- Set album to STRING.
- -t STRING, --title=STRING
- Set track title to STRING.
- -n NUM, --track=NUM
- Set track number to NUM.
- -N NUM, --track-total=NUM
- Set total number of tracks to NUM.
- -G STRING, --genre=STRING
- Sets genre to STRING. (See --list-genres)
- -Y YEAR, --year=YEAR
- Set the four digit year.
- -p STRING, --publisher=STRING
- Set the publisher/label text.
- --comment=[LANGUAGE]:DESCRIPTION:COMMENT
- Add (or remove when COMMENT is "") a comment. Note that the
argument value MUST always contain exactly two ':' characters to delimit
the fields even when the default language is being used. The DESCRIPTION
string is the comment title. The optional LANGUAGE string MUST be a
three-character ISO 639 language code. The default is "eng" for
English.
A tag may not have more than one comment frame with the same DESCRIPTION and
LANGUAGE values.
- --remove-comments
- Remove all comment frames from the tag.
- --lyrics=[LANGUAGE]:DESCRIPTION:LYRICS
- Add (or remove when LYRICS is "") a comment. Note that the
argument value MUST always contain exactly two ':' characters to delimit
the fields even when the default language is being used. The DESCRIPTION
string is the lyrics title. The optional LANGUAGE string MUST be a
three-character ISO 639 language code. The default is "eng" for
English.
A tag may not have more than one lyrics frame with the same DESCRIPTION and
LANGUAGE values.
- --remove-lyrics
- Remove all lyrics frames from the tag.
- --add-image=IMG_PATH:TYPE[:DESCRIPTION]
- Add an image to the tag (APIC frame). The IMG_PATH is the image file to
add to the tag. If the path value is empty the image frame with a value of
TYPE is removed from the tag. The TYPE is one of the types listed when
'eyeD3 --list-image-types' is run. The DESCRIPTION is optional and will
default to "".
A tag may not have more than one image frame with the same TYPE values.
- --remove-images
- Remove all image (APIC) frames from the tag.
- --add-object=OBJ_PATH[:DESCRIPTION[:MIME-TYPE[:FILENAME]]]
- Add an encapsulated object to the tag (GEOB frame). The description and
filename are optional, but when used, the ':' delimiters must be present.
If the OBJ_PATH value is empty the GEOB frame with DESCRIPTION is removed.
A tag may not have more than one object (GEOB) frame with the same
DESCRIPTION values.
- -i DIR, --write-images=DIR
- Causes all attached images (APIC frames) to be written to the specified
directory. They are named by their "image type". For example, if
the image is a png and the type is OTHER, a file named OTHER.png is
written to the desired directory. If the file name already exist, a unique
numeric value is appended to the type string.
- -o DIR, --write-objects=DIR
- Causes all attached objects (GEOB frames) to be written to the specified
directory. The files are written with the name
"<filename>.<mime-subtype>" in the specified
directory.
- --set-text-frame=FID:TEXT
- Set the value of a specific (i.e., FID) text frame. To remove the frame,
specify an empty value. e.g., --set-text-frame="TDRC:"
- --set-user-text-frame=DESC:TEXT
- Set the value of a TXXX text frame with a unique description. To remove
the frame, specify an empty value. e.g.,
--set-user-text-frame="Description:"
- --set-url-frame=FID:URL
- Set the value of a specific (i.e., FID) URL frame. To remove the frame,
specify an empty URL. e.g., --set-url-frame="WCOM:"
- --set-user-url-frame=DESC:URL
- Set the value of a WXXX frame with unique description string. To remove
the frame, specify an empty URL. e.g.,
--set-user-url-frame="Description:"
- --play-count=[+]N
- Set the play count (PCNT). If the argument value begins with '+' the value
is incremented by N, otherwise it is set to exactly N.
- --bpm=N
- Set the beats per minute value. The value MUST be greater than 0.
- --unique-file-id=OWNER_ID:ID
- Add a UFID frame. If the ID arg is empty the UFID frame with OWNER_ID is
removed. An OWNER_ID MUST be specified.
- --set-encoding=latin1|utf8|utf16-LE|utf16-BE
- Set the encoding that is used for _all_ text frames in the tag. The
encoding is applied only when the tag is updated, therefore a frame must
be set or --force-update is present. Note that, unfortunately, utf8 is not
supported by ID3 v2.3 tags.
- --remove-v1
- Remove ID3 v1.x tag.
- --remove-v2
- Remove ID3 v2.x tag.
- --remove-all
- Remove all tags.
MISC. OPTIONS¶
- --rename=PATTERN
- Rename the file based on PATTERN which may contain the following
substitution variables: %A (artist), %a (album), %t (title), %n (track
number), and %N (the total track count). The PATTERN string MUST not
contain the file name extenstion.
- --fs-encoding=ENCODING
- Use the specified character encoding for filenames when renaming files.
The default value is iso-8859-1.
- -l, --list-genres
- Display the table of "valid" ID3 genres and exit.
- --list-image-types
- List all possible image types for APIC frames.
- --strict
- Fail for tags that violate the ID3 specification.
- --jep-118
- Output the tag per the format described in JEP-0118. See
http://www.xmpp.org/extensions/xep-0118.html
- --nfo
- Output NFO information for each album directory.
- --lametag
- Prints the LAME Tag.
- --force-update
- Update the tag regardless of whether any frames were set on the command
line.
- --no-zero-padding
- Don't pad track or disc numbers with 0's.
- --no-tagging-time-frame
- When saving tags do not add a TDTG (tagging time) frame.
- -F DELIM
- Specify a new delimiter for option values that contain multiple fields
(default delimiter is ':')
SEE ALSO¶
http://eyed3.nicfit.net/
AUTHOR¶
eyeD3 was written by Travis Shirk <travis@pobox.com>. This manpage was
written by Alexander Wirt <formorer@debian.org> for the Debian
Distribution and Travis Shirk.