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
-t STRING, --title=STRING
Set track title to 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, --track-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 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 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.

--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:"
--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 (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.jabber.org/jeps/jep-0118.html
--force-update
Update the tag regardless of whether any frames were set on the command line.

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.