Mutagen

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

* tools: Don't crash in misconfigured envs, fall back to utf-8.
* mp3: Return correct mimetype for MP2 files. :bug:`163`
* id3: deterministic sorting of frames. :bug:`166`
* AIFF support :bug:`146` (Evan Purkhiser)

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

* Minimum required Python version is now 2.6
* Online API reference at https://mutagen.readthedocs.org/
* EasyID3:

* Fix crash with empty TXXX values. :bug:`135`

* ID3:

* id3v2.3 writing support :bug:`85`
* Add iTunes podcast frames (TGID, TDES, WFED) :bug:`141`
* Updated id3v1 genre list

* MP4:

* add_tags() will not replace existing tags. :bug:`101`
* Don't ignore tags if parsing unknown atoms fails.
* Raise on invalid 64bit atom size :bug:`132` (Sidnei da Silva)

* APEv2:

* Handle invalid tag item count. :bug:`145` (Dawid Zamirski)

* Ogg:

* Faster parsing of files with large packets.

* VComment:

* Preserve text case for field names added through the dict interface
:bug:`152`

* mid3v2:

* New -e,--escape switch to enable interpretation of escape sequences and
makes escaping of the colon separator possible. :bug:`159`

* mid3iconv:

* Convert COMM frames :bug:`128`

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

* Fix Python 2.3 compatibility (broken in 1.19).
* Fix many warnings triggered by -3. :bug:`27`
* mid3v2:

* Add --TXXX support. :bug:`62` (Tim Phipps)
* Add --POPM support. :bug:`71`
* Allow setting multiple COMM or TXXX frames with one command line.

* FLAC:

* Try to handle corrupt Vorbis comment block sizes. :bug:`52`
* Try to handle corrupt Picture block sizes :bug:`106` (Christoph Reiter)
* Don't leak file handle with PyPy :bug:`111` (Marien Zwart)

* ID3:

* MakeID3v1: Do not generate bad tags when given short dates. :bug:`69`
* ParseID3v1: Parse short (< 128 byte) tags generated by old Mutagen
implementations of MakeID3v1, and tags with garbage on the front.
* pprint: Sort frames by name.
* Upgrade unknown 2.3 frames :bug:`97` (Christoph Reiter)
* Fix handling of invalid SYLT frames :bug:`105` (Christoph Reiter)

* MP3:

* Fix error when loading extremely small MP3s. :bug:`72`
* Fix rounding error in CBR length calculation :bug:`93` (Christoph Reiter)

* Use 'open' rather than 'file' everywhere. :bug:`74` (Dan Callahan)
* mid3iconv:

* Accurately copy QL-style frame encoding behavior. :bug:`75`
* Skip unopenable files. :bug:`79`

* ID3FileType:

* Remember which tag type load() was called with even if the file
doesn't yet have any ID3 tags. :bug:`89`

* VComment:

* Prevent MemoryError when parsing invalid header :bug:`112`
(Jyrki Pulliainen)

* ASF:

* Don't corrupt files on the second save() call :bug:`81` (Christoph Reiter)
* Always store GUID objects in the MetadataLibraryBlock :bug:`81`

* OggTheora: Fix length/bitrate calculation. :bug:`99` (Christoph Reiter)
* MP4:

* Less strict MP4 covr atom parsing. :bug:`86` (Lukáš Lalinský)
* Support atoms that extend to the end of the file. :bug:`109`
(Sidnei da Silva)
* Preserve freeform format flags :bug:`103` (Christoph Reiter)

* OggOpus support. :bug:`115` (Christoph Reiter)
* Musepack:

* Fix SV7 bitrate calculation :bug:`7` (Christoph Reiter)
* Support SV8 :bug:`7` (Christoph Reiter)

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

* ASF: Don't store blocks over 64K in the MetadataObject block;
use the MetadataLibraryBlock instead. :bug:`60` (Lukáš Lalinský)
* ID3: Faster parsing of files with lots of padding. :bug:`65`
(Christoph Reiter)
* FLAC: Correct check for audio data start. :bug:`67`

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

* ID3:

* POPM: 'count' is optional; the attribute may not exist. :bug:`33`
* TimeStampTextFrame: Fix a TypeError in unicode comparisons. :bug:`43`
* MakeID3v1: Translate TYER into ID3v1 year if TDRC is not present. :bug:`42`

* mid3v2:

* Allow --delete followed by --frame, and --genre 1 --genre 2. :bug:`37`
* Add --quiet and --verbose flags. :bug:`40`

* moggsplit: --m3u option to write an M3U playlist of the new files. :bug:`39`
* mid3iconv: Fix crash when processing TCML or TIPL frames. :bug:`41`
* VCommentDict: Correctly normalize key names for .keys() iterator. :bug:`45`
* MP3: Correct length calculation for MPEG-2 files. :bug:`46`
* oggflac: Fix typo in docstring. :bug:`53`
* EasyID3: Force UTF-8 encoding. :bug:`54`
* EasyMP4: Fix 'genre' translation. :bug:`56`

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

* ASF:

* Distinguish between empty and absent tag values in
ContentDescriptionObjects. :bug:`29`

* mid3iconv:

* Fix a crash when processing empty (invalid) text frames.

* MAJOR API INCOMPATIBILITY!!!!

* EasyID3FileType is now in mutagen.easyid3, not mutagen.id3. This
change was necessary to restore API compatibility with 1.16, as
1.17 accidentally contained a circular import preventing
mutagen.easyid3 from importing by itself. :bug:`32`