Eyed3

---------------------------------------
New Features:
* Support for album artist info.
By Cyril Roelandt <tipecamlgmail.com>
* [fixup plugin] -- Custom patterns for file/directory renaming.
By Matt Black <https://bitbucket.org/mafrosis>
* API providing simple prompts for plugins to use.
* API and TXXX frame mappings for album type (e.g. various, album, demo,
etc.) and artist origin (i.e. where the artist/band is from).
* Lower cases ANSI codes and other console fixes.
* Added the ability to set (remove) tag padding. See
`eyeD3 --max-padding` option. By Hans Meine.
* Tag class contains read_only attribute than can be set to ``True`` to
disable the ``save`` method.
* [classic plugin] -- Added ``--track-offset`` for incrementing/decrementing
the track number.
* [fixup plugin] -- Check for and fix cover art files.

Bug Fixes:
* Build from pypi when ``paver`` is not available.
* Disable ANSI color codes when TERM == "dumb"
* Locking around libmagic.
* Work around for zero-padded utf16 strings.
* Safer tempfile usage.
* Better default v1.x genre.

------------------------------------------
Bug fixes:
* Allow setup.py to run with having ``paver`` installed.
* [statistics plugin] Don't crash when 0 files are processed.

------------------------------------------
New Features:
* Python 2.6 is now supported if ``argparse`` and ``ordereddict``
dependencies are installed. Thanks to Bouke Versteegh for much of this.
* More support and bug fixes for `ID3 chapters and table-of-contents`_.
* [classic plugin] ``-d/-D`` options for setting tag
disc number and disc set total.
* Frames are always written in sorted order, so if a tag is rewritten
with no values changed the file's checksum remains the same.
* Documentation and examples are now included in source distribution.
* [classic plugin] Removed ``-p`` for setting publisher since using it
when ``-P`` is intended is destructive.
* [classic plugin] Supports ``--no-color`` to disable color output. Note,
this happens automatically if the output streams is not a TTY.
* ``Tag.save`` supports preserving the file modification time; and option
added to classic plugin.
* [statistics plgin] Added rules for "lint-like" checking of a collection.
The rules are not yet configurable.
* ERROR is now the default log level.

Bug fixes:
* Various fixes for PRIV frames, error handling, etc. from Bouke Versteegh
* Convert '/' to '-' in TagTemplate names (i.e. --rename)
* Drop TSIZ frames when converting to ID3 v2.4
* ID3 tag padding size now set correctly.
* Fixes for Unicode paths.
* License clarification in pkg-info.
* The ``-b`` setup.py argument is now properly supported.
* Magic module `hasattr` fix.
* More robust handling of bogus play count values.
* More robust handling of bogus date values.
* Proper unicode handling of APIC descriptions.
* Proper use of argparse.ArgumentTypeError
* Allow TCMP frames when parsing.
* Accept more invalid frame types (iTunes)
* Documentation fixes.
* Fix for bash completion script.
* Fix for certain mp3 bit rate and play time computations.

.. _ID3 chapters and table-of-contents: http://www.id3.org/id3v2-chapters-1.0

------------------------------
New Features:
* Support for `ID3 chapters and table-of-contents`_ frames
(i.e.CHAP and CTOC).
* A new plugin for toggling the state of iTunes podcast
files. In other words, PCST and WFED support. Additionally, the Apple
"extensions" frames TKWD, TDES, and TGID are supported.
Run ``eyeD3 -P itunes-podcast --help`` for more info.
* Native frame type for POPM (Popularity meter).
See the :func:`eyed3.id3.tag.Tag.popularities` accessor method.
* Plugins can deal with traversed directories instead of only file-by-file.
Also, :class:`eyed3.plugins.LoaderPlugin` can optionally cache the
loaded audio file objects for each callback to ``handleDirectory``.
* [classic plugin] New --remove-frame option.
* [statistics plugin] More accurate values and easier to extend.

Bug fixes:
* Fixed a very old bug where certain values of 0 would be written to
the tag as '' instead of '\x00'.
* Don't crash on malformed (invalid) UFID frames.
* Handle timestamps that are terminated with 'Z' to show the time is UTC.
* Conversions between ID3 v2.3 and v2.4 date frames fixed.
* [classic plugin] Use the system text encoding (locale) when converting
lyrics files to Unicode.

----------------------------------------

.. warning::
This release is **NOT** API compatible with 0.6.x. The majority
of the command line interface has been preserved although many options
have either changed or been removed.
..

New Features:
* Command line script ``eyeD3`` now supports plugins. The default plugin
is the classic interface for tag reading and editing.
* Plugins for writing NFO files, displaying lame/xing headers, jabber tunes,
and library statistics.
* Module name is now ``eyed3`` (all lower case) to be more standards
conforming.
* New ``eyed3.id3.Tag`` interface based on properties.
* Improved ID3 date frame support and 2.3<->2.4 conversion, and better
conversions, in general.
* Native support for many more ID3 frame types.
* Python Package Index friendly, and installable with 'pip'.
* Improved mime-type detection.
* Improved unicode support.
* Support for config files to contain common options for the command-line
tool.

-----------------------------------------------
New features:
* Support for disc number frames (TPOS).
Thanks to Nathaniel Clark <natemisrule.us>
* Added %Y (year) and %G (genre) substitution variables for file renames.
Thanks to Otávio Pontes <otaviobpgmail.com>
* Improved XML (--jep-118) escaping and a new option (--rfc822) to output
in RFC 822 format. Thanks to Neil Schemenauer <nasarctrix.com>
* --rename will NOT clobber existing files.
* New option --itunes to write only iTunes accepted genres.
Thanks to Ben Isaacs <Ben XO meben-xo.com>
* If available the 'magic' module will be used to determine mimetypes when
the filename is not enough. Thanks to Ville Skyttä <ville.skyttaiki.fi>
* --set-encoding can be used along with a version conversion arg to apply
a new encoding to the new tag.
* Increased performance for mp3 header search when malformed GEOB frames
are encountered. Thanks to Stephen Fairchild <sfairchildbethere.co.uk>
* Less crashing when invalid user text frames are encountered.
* Less crashing when invalid BPM values (empty/non-numeric) are encountered.