EYED3(1)																  EYED3(1)

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  LAN-
	      GUAGE 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 exam-
	      ple,  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  "<file-
	      name>.<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 Dis-
       tribution and Travis Shirk.

eyeD3 0.6.18							   Jun. 29, 2012							  EYED3(1)