eyeD3 - displays and manipulates id3-tags on mp3 files

eyeD3 [options] file [file...]

eyeD3 [options] dir [dir...]

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.

-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.

-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

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.

--add-image=IMG_PATH:TYPE[:DESCRIPTION]

Add an image to the tag. 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.

-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.

--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:"

--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.

--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 extension.

-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.jabber.org/jeps/jep-0118.html

--force-update

Update the tag regardless of whether any frames were set on the command line.

http://eyed3.nicfit.net/

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.