Projects / eyeD3


eyeD3 is a Python program and module that provides the ability to read and write ID3 tags (v1.x and v2.3/v2.4). It also decodes MP3 headers (bit rate, sample frequency, play time, etc.).

Operating Systems

Recent releases

  •  09 Nov 2013 00:13

    Release Notes: A new plugin for fixing different types of music directories. Adds "eyed3.mp3.Mp3AudioFile.initTag()" for tag/resetting a new ID3 on a file. Updates and fixes to the statistics plugin. Support for TSO2 and TSOC frames. Better MIME-type checking.

    •  13 Jul 2013 01:34

      Release Notes: This release fixes a major bug in the install process that occurred for all users that did not have the 'paver' tool installed. For all these users an upgrade is required. The stats plugin will no longer crash when 0 files are processed.

      •  06 Jul 2013 23:08

        Release Notes: This release adds Python 2.6 support (2.7 is the default), ID3 chapters/TOC support, disc number/total commandline options, optional preservation of file modification time during saves, --no-color, more stats in the statistics plugin, and fixes for PRIV frames, tag templates, iD3 conversions, play times, etc.

        •  26 Nov 2012 03:51

          Release Notes: ID3 chapters and table-of-contents support. A new plugin for setting the podcast bits on/off (necessary for iTunes). ID3 POPM support. A new --remove-frame option. An improved statistics plugin. Plugin API enhancements. Better support for malformed ID3 tags, UTC timestamp support, etc.

          •  15 Nov 2012 03:16

            Release Notes: The command line script now supports plugins. The default plugin is the classic interface for tag reading and editing. Plugins were provided for writing NFO files, displaying lame/xing headers, jabber tunes, and library statistics. The module name is now 'eyed3' for better conformance to standards. A new tag interface based on properties was added. ID3 date frame support was improved, and 2.3<->2.4 conversion and other conversions in general were improved. Native support was provided for many more ID3 frame types. Installation with 'pip' is now supported. MIME type and Unicode support was improved. This version is not API compatible with 0.6.x releases.

            Recent comments

            13 Aug 2005 17:23 cowbutt

            Seems to be one of the few id3tag tools to handle international characters properly
            as a result, the iRiver H340 is happy with the tags it produces in conjuction with libiriverdb (


            Project Spotlight


            A Fluent OpenStack client API for Java.


            Project Spotlight

            TurnKey TWiki Appliance

            A TWiki appliance that is easy to use and lightweight.