eyeD3 A Python module and program for processing ID3 tags.
Download

eyeD3 Ranking & Summary

eyeD3 Tags

Python Python module module ID3 tags processing tags eyeD3

eyeD3 Description

A Python module and program for processing ID3 tags. eyeD3 is a Python module and program for processing ID3 tags. Information about mp3 files (i.e bit rate, sample frequency, play time, etc.) is also provided. The formats supported are ID3 v1.0/v1.1 and v2.3/v2.4.Installation:gzip -dc eyeD3-0.6.9.tar.gz | tar xvf -cd eyeD3-0.6.9./configuremakemake install (as root)Usage:The 'eyeD3' utility program can perform most ID3 tasks, and it is also the best example of how to use the API. It supports the following features: eyeD3 file Options: --version show program's version number and exit -h, --help show this help message and exit Tag Versions ------------ -1, --v1 Only read/write ID3 v1.x tags. By default, v1.x tags are only read if there is not a v2.x 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 -------- -a STRING, --artist=STRING Set artist -A STRING, --album=STRING Set album -t STRING, --title=STRING Set title -n NUM, --track=NUM Set track number -N NUM, --track-total=NUM Set total number of tracks -G GENRE, --genre=GENRE Set genre. The argument is a valid genre string or number. See --list-genres -Y STRING, --year=STRING Set a four digit year. -c ::COMMENT, --comment=::COMMENT Set comment -p STRING, --publisher=STRING Set the publisher/label text --remove-comments Remove all comment frames. --add-image=IMG_PATH:TYPE Add an image to the tag. The description and type optional, but when used, both ':' delimiters must be present. The type MUST be an string that corresponds to one given with --list-image-types. If the IMG_PATH value is empty the APIC frame with TYPE is removed. -i DIR, --write-images=DIR Causes all attached images (APIC frames) to be written to the specified directory. If not directory specified the images are written to . --set-text-frame=FID:TEXT Set the value of a 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 user text frame (i.e., TXXX). To remove the frame, specify an empty value. e.g., --set- user-text-frame="SomeDesc:" --play-count=N If this argument value begins with '+' the tag's play count (PCNT) is incremented by N, otherwise the value is set to exactly N. --bpm=N Set the beats per minute value. --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-BE|utf16-LE Set the encoding that is used for _all_ text frames. This only takes affect when the tag is updated as the result of a frame value being set with another option (e.g., --artist=) or --force-update is present. --remove-v1 Remove ID3 v1.x tag. --remove-v2 Remove ID3 v2.x tag. --remove-all Remove both ID3 v1.x and v2.x tags. Misc. Options ------------- --rename=NAME Rename file (the extension is not affected) based on data in the tag using substitution variables: %A (artist), %a (album), %t (title), %n (track number), and %N (total number of tracks) --fs-encoding=ENCODING Use the specified character encoding for the filename when renaming files -l, --list-genres Display the table of ID3 genres and exit --list-image-types List all possible image types --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 are set with new values. --no-color Disable color output -v, --verbose Show all available information --debug Trace program execution.eyeD3 is free software released under the GPL license. Requirements: · Python What's New in This Release: · Invalid utf16-encoded strings are now worked around. · All genres are shown in -list-genres. · A workaround was made for invalid PLCT (i.e. playcount) frames. · All tracks are shown in -nfo output. · Support was added for URL frames W??? and WXXX. · A program exit code is now produced by the "eyeD3" command line tool.

eyeD3 Related Software