Debian Codegraph @

NEWS

raw
1 .. _release-1.47.0:
2
3 1.47.0 - 2023-09-03
4 -------------------
5
6 * ID3: Allow reading TYER tags in the form of "yyyy-mm-dd" :pr:`597`
7 * ID3: Handle negative extended header sizes :pr:`607`
8 * ID3: id3 frames fix bad cast due to str.isdigit :pr:`616`
9 * MP3: Auto-detect MP3 files without ID3 tags :pr:`601`
10 * WAVE: Extensible wave format support :bug:`595` :pr:`596`
11 * WAVE, AIFF: Handle truncated IFF files :bug:`496` :pr:`517`
12 * MP4: add a check for wrong offsets in mp4 files :bug:`426` :pr:`462`
13 * FLAC: Fix cuesheet and seektable saving :pr:`534`
14 * TrueAudio: Read sample rate as unsigned and handle zero sample rate :pr:`609`
15 * docs: Fixed documentation for id3.ID3.save parameter v2_version
16 * docs: Make extlinks compatible with sphinx 6.0 :pr:`590`
17 * docs: Fixed various typos :pr:`602`
18 * Add some more type annotations :pr:`622`
19 * Various minor fixes for issues uncovered by oss-fuzz :pr:`620` :pr:`621` :pr:`623`
20
21
22 .. _release-1.46.0:
23
24 1.46.0 - 2022-10-09
25 -------------------
26
27 * Drop Support for Python 3.5 and 3.6 :pr:`487` :pr:`568`
28 * Add pyproject.toml and switch to poetry for development only :pr:`513`
29 * tests: no longer include flake8 in the test suite, it has to be run separately now :pr:`571`
30 * Start adding some type annotations and integrate mypy :pr:`488`
31 * easyid3: map easyid3 grouping to TIT1 :pr:`505`
32 * mutagen-inspect: add usage documentation :pr:`540`
33 * wave: Fix bitrate calculation :pr:`566`
34 * FLAC: handle files where the first metadata block is not STREAMINFO :pr:`500`
35 * Increase buffer size for rewriting files from 256K to 1M to improve performance with network shares :pr:`570`
36 * Other changes: code cleanup :pr:`514`, typos :pr:`565`, remove upper limit for python version :pr:`579`
37
38
39 .. _release-1.45.1:
40
41 1.45.1 - 2020-07-31
42 -------------------
43
44 * Fix flake8 tests when run after calling ``setup.py build`` :bug:`482`
45 * No longer use mmap when rewriting files. Fixes slow save performance with Windows network shares, ZFS and more :pr:`483` :pr:`484`
46
47
48 .. _release-1.45.0:
49
50 1.45.0 - 2020-07-11
51 -------------------
52
53 * WAVE support with ID3 tags :pr:`408` (:user:`Philipp Wolfer <phw>`, :user:`Borewit`)
54 * DSDIFF support with ID3 tags :pr:`473` :pr:`472` (:user:`Philipp Wolfer <phw>`)
55 * MP4: Add support for nero chapters :pr:`398` (:user:`Martin Weinelt <mweinelt>`)
56 * wavpack: add support for wavpack DSD :pr:`464` (:user:`Timothy Redaelli <drizzt>`)
57 * wavpack: add bits_per_sample :pr:`467` (:user:`Timothy Redaelli <drizzt>`)
58 * MP4: handle DecoderSpecificInfo with wrong instance size :pr:`465`
59 * docs: various fixes :pr:`461` (:user:`Terence Eden <edent>`), :pr:`474` (:user:`naglis`)
60 * tests: depend on flake8 now (instead of pycodestyle and pyflakes)
61 * docs: fix warnings with sphinx v3
62
63 Fuzzing related:
64
65 * Fuzzing integration with `python-afl <https://github.com/jwilk/python-afl>`__ :pr:`449`
66 * Fix various unhandled error cases in ogg, asf, oggvorbis, id3 :pr:`441`, :pr:`445`, :pr:`446`, :pr:`447`, :pr:`448`, :pr:`454` (:user:`Julien Voisin <jvoisin>`)
67 * aac: Fix ZeroDivisionError in case frequency is unknown
68 * musepack: handle truncated stream header
69 * musepack: handle invalid sample rate index
70 * musepack: handle duplicate RG/SH packets
71 * oggtheora: handle truncated header packet
72 * oggtheora: fail if FRN in the header packet is zero
73 * oggtheora: handle empty pages in more cases
74 * ogg: handle empty pages in to_packets()
75 * aiff: handle overflow in read_float() :pr:`456`
76
77
78 .. _release-1.43.1:
79
80 1.43.1 - 2020-07-11
81 -------------------
82
83 * Add pickle support for enum types :pr:`477`
84 * docs: fix various warnings with sphinx v3
85
86
87 .. _release-1.44.0:
88
89 1.44.0 - 2020-02-10
90 -------------------
91
92 * Python 2 is no longer supported :bug:`410`
93 * mp4: Fix some infinite loops in the mp4 parser :pr:`429` (:user:`Julien Voisin <jvoisin>`)
94 * flac: Fix pickle support for SeekPoint :pr:`428` (:user:`point-source`)
95 * aiff: Fix a division by zero :pr:`431` (:user:`Julien Voisin <jvoisin>`)
96 * asf: Catch a MemoryError :pr:`432` (:user:`Julien Voisin <jvoisin>`)
97 * oggtheora: Fix a division by zero :pr:`430` (:user:`Julien Voisin <jvoisin>`)
98
99
100 .. _release-1.43.0:
101
102 1.43.0 - 2019-11-17
103 -------------------
104
105 * **Note: 1.43.x might be the last version supporting Python 2**
106 * Python 3.4 is no longer supported
107 * Building requires 'setuptools' now, CLI tools depend on 'pkg_resources'
108 * CLI tools are setuptools entry points now
109
110 ..
111
112 * Fix collections ABCs deprecation warning :pr:`371` (:user:`Ken Sato <ksato9700>`)
113 * Minor typo fixes :pr:`375` (:user:`Nicholas Chammas <nchammas>`)
114 * MP3: increase max initial wrong syncs from 1000 to 1500 :pr:`376` (:user:`Hamid Alaei Varnosfaderani <halaei>`)
115 * FLAC: support files with multiple VORBIS_COMMENT blocks like libflac :pr:`378`
116 * ID3: Improved TYER/TDAT/TIME upgrade to TDRC :pr:`385`
117 * MP4: Add support for iTunes HD Video tag (hdvd) :pr:`386` (:user:`Jay Sandhu <JaySandhu>`)
118 * Add AC3 file type :pr:`400` (:user:`Philipp Wolfer <phw>`)
119 * AIFF: renamed sample_size to bits_per_sample (sample_size still works) :pr:`403` (:user:`Philipp Wolfer <phw>`)
120 * API doc fixes :pr:`404` :pr:`407` (:user:`Philipp Wolfer <phw>`)
121 * Add support for Tom's lossless Audio Kompressor (TAK) :pr:`405` (:user:`Philipp Wolfer <phw>`)
122 * OptimFROG: support encoder version >= 5.100 :pr:`406` (:user:`Philipp Wolfer <phw>`)
123 * AIFF: Fix handling of padding bytes, safe chunk manipulation :pr:`409` (:user:`Philipp Wolfer <phw>`)
124 * Fix typos :pr:`412` (:user:`Tim Gates <timgates42>`)
125
126
127 .. _release-1.42.0:
128
129 1.42.0 - 2018-12-26
130 -------------------
131
132 * ID3: Always read id3v1 tags and include them when no id3v2 equivalent
133 exists. Can be disabled with the new ``load_v1`` option,
134 see :meth:`id3.ID3.load`
135 :pr:`357` (:user:`Fredrik Strupe <frestr>`)
136 * ID3: Add a pretty print implementation for SYLT
137 :pr:`359` (:user:`Hamid Alaei Varnosfaderani <halaei>`)
138 * vorbis: Improved error messages when validating keys/values
139 :pr:`356` (:user:`Michael Booth <MJuddBooth>`)
140 * Fix pylint warnings when using the various ``save()`` methods :pr:`364`
141
142
143 .. _release-1.41.1:
144
145 1.41.1 - 2018-08-11
146 -------------------
147
148 * MP4: fix rtng, stik, shwm getting saved as 16bit ints instead of 8bit :bug:`349`
149
150
151 .. _release-1.41.0:
152
153 1.41.0 - 2018-07-15
154 -------------------
155
156 * Documentation fixes :pr:`342` (:user:`Jakub Wilk <jwilk>`)
157 * mid3v2: Add support for WXXX frames :bug:`344` :bug:`348`
158 * Fix decoding of track_peak from MP3 Info Tag :pr:`345`
159 (:user:`Anton Yuzhaninov <citrin>`)
160 * MonkeysAudio: set bits_per_sample for older files :bug:`347`
161
162
163 .. _release-1.40.0:
164
165 1.40.0 - 2018-01-25
166 -------------------
167
168 * APEv2: Ensures tags are saved in a deterministic way :pr:`329`
169 (:user:`cushy007`)
170 * Restore WinXP support for the CLI tools :bug:`332`
171 * easymp4: Fix EasyMP4.add_tags() when no tags exist :bug:`334`
172 * id3: Fix PyCharm not being able to resolve id3 frame class references
173 :bug:`336`
174 * Support pathlib.Path objects for paths (PEP 519) :bug:`337` :pr:`338`
175 (:user:`Andrew Rabert <nvllsvm>`)
176 * Use semver for versioning
177
178
179 1.39 - 2017-11-05
180 -----------------
181
182 * Tests:
183
184 * Require `hypothesis <https://hypothesis.readthedocs.io>`__
185 * Run pycodestyle/pyflakes tests by default. Skip with ``--no-quality`` or
186 ``-m no quality`` when using pytest directly.
187
188 * Python 3.3 is no longer supported
189 * MP3: Improved bitrate accuracy for files with XING header :bug:`328`
190 (thanks :user:`Michaël Defferrard <mdeff>`)
191 * ASF: Fix case where some tags resulted in broken ASFUnicodeAttribute
192 instances :bug:`324`
193 * Add support for filesystems which don't support opening files read/write
194 (gvfs over fuse for example) :bug:`300`
195 * mid3v2: Add support for USLT :bug:`306`
196 * Minor improvements by :user:`Borewit` and
197 :user:`Evan Purkhiser <EvanPurkhiser>`
198
199
200 1.38 - 2017-06-01
201 -----------------
202
203 * Note: New release tarballs are now hosted on github:
204 https://github.com/quodlibet/mutagen/releases
205 * ID3:
206
207 * Add iTunes grouping frame `id3.GRP1` :bug:`304`
208 * Fix exposing text frames where the text can't be encoded with the
209 reported encoding due to merging of frames :bug:`307`
210
211 * OGG: Fix wrong StreamInfo.length (small negative value) for all
212 ogg based formats in rare cases. :bug:`308`
213
214
215 1.37 - 2017.02.24
216 -----------------
217
218 * Relicense "GPLv2" → "GPLv2 or later" :bug:`291`
219 * DSF: add `mutagen.dsf` module for DSF (DSD Stream File) support
220 :pr:`283` (Boris Pruessmann)
221 * MP3: Add `mp3.MPEGInfo.encoder_settings` containing a guess of the encoder
222 settings used, for example ``"-V2"`` for LAME :bug:`66`
223 * ID3: add iTunes movement related frames `id3.MVIN` and `id3.MVNM`
224 * MP4: support ``©mvi``, ``©mvc``, ``shwm``, ``stik``, ``rtng``, ``tves``,
225 ``tvsn``, ``plID``, ``cnID``, ``geID``, ``atID``, ``sfID``, ``cmID``,
226 ``akID`` :bug:`130`
227
228
229 1.36.3 - 2017.02.24
230 -------------------
231
232 * MP3: fix error with xing frames without a frame count :bug:`292`
233
234
235 1.36.2 - 2017.01.25
236 -------------------
237
238 * ID3: Always write little endian utf-16 with BOM.
239 Fixes tests on big endian machines :pr:`289`
240
241
242 1.36.1 - 2017.01.22
243 -------------------
244
245 * Support GAE runtime :bug:`286`
246 * FLAC: Fix crash when loading files with zero samples :bug:`287`
247 * MP3: Handle broken lame tags written by older lame versions
248
249
250 1.36 - 2016.12.22
251 -----------------
252
253 * ID3: Ignore trailing empty values for v2.3 text frames :bug:`276`
254 * ID3: Write large APIC frames last :bug:`278`
255 * EasyID3: support saving as v2.3 :bug:`188`
256 * FLAC: Add StreamInfo.bitrate :bug:`279`
257 * mid3cp: Add ``--merge`` option :bug:`277`
258 * MP4: Allow loading files without audio tracks :bug:`272`
259
260
261 1.35.1 - 2016.11.09
262 -------------------
263
264 * Revert back to distutils :bug:`273`
265
266
267 1.35 - 2016.11.02
268 -----------------
269
270 * Tests: Require pytest
271 * Tools: Install .exe launchers on Windows
272 * setup.py: Require setuptools
273 * ID3:
274
275 * Fix loading files with CRM frames :bug:`239`
276 * Fix loading AENC, LINK, GRID frames with no payload
277 * Merge duplicate text frames with same key on load :bug:`172`
278 * Allow parsing of duplicate APIC frames :bug:`172`
279 * Parse utf-16 text fields with missing BOM :bug:`267`
280 * Increase max resyncs for the mpeg frame search :bug:`268`
281
282
283 1.34.1 - 2016.08.13
284 -------------------
285
286 * ID3: Expose some internals again to make Picard (mostly) work again.
287
288 * http://tickets.musicbrainz.org/browse/PICARD-833
289 * https://github.com/metabrainz/picard/pull/479
290
291
292 1.34 - 2016.07.20
293 -----------------
294
295 * ID3:
296
297 * Add `CTOC <id3.CTOC>` and `CHAP <id3.CHAP>` frames. New classes:
298 `ID3Tags <id3.ID3Tags>`, `CTOCFlags <id3.CTOCFlags>`. :bug:`6`
299 * Add `TCAT <id3.TCAT>`, `TKWD <id3.TKWD>`, `PCST <id3.PCST>` frames.
300 :bug:`249`
301 * Validate user provided LNK/LINK frameid. :bug:`242`
302 * Add `RVAD <id3.RVAD>`, RVA frames
303 * Add TST, TSA, TS2, TSP and TSC frames
304 * Fix not writing optional fields when saving to v2.3
305 * Add default field values for all frames
306
307 * Drop Python 2.6 support
308 * EasyID3: Fix TXXX frame encoding when setting a non-latin1 encodable
309 value after a latin1 one. :bug:`263`
310
311
312 1.33.2 - 2016.07.05
313 -------------------
314
315 * Fix loading of small ogg/apev2 files (1.33 regression)
316
317
318 1.33.1 - 2016.06.29
319 -------------------
320
321 * Fix Overeager deprecation warnings :bug:`261`
322
323
324 1.33 - 2016.06.29
325 -----------------
326
327 * FileType, Metadata: File-like object support :bug:`1`
328 * mid3v2: Add APIC support. :bug:`47`
329 * EasyID3: Fix handling of RVA2 frames with non-lowercase description
330 :bug:`215`
331 * mid3v2: Add UFID support. :bug:`234`
332 * ID3: Include human-readable representation of the picture type in
333 APIC._pprint() :bug:`244`
334 * EasyID3: make albumartist use TPE2 and move performer to TXXX. :bug:`252`
335 * ID3: id3.ID3TimeStamp comparator: check type :pr:`260`
336 (Fabian Peter Hammerle)
337 * setup.py: follow PEP440 for the development version
338 * FileType/Metadata.load/save/delete no longer raise IOError or IOError
339 subclasses. They only raise subclasses of MutagenError.
340
341
342 1.32 - 2016.05.02
343 -----------------
344
345 * Add basic SMF (Standard MIDI File) support (:mod:`mutagen.smf`)
346 * FLAC: add ``audio/flac`` mime type. :bug:`235`
347 * ASF: Fixed crash when object size is longer than the header and file length
348 (Ben Ockmore)
349 * ID3: Validate attributes set after frame creation :commit:`69368c31e00`
350 (:user:`Daniel Plachotich <danpla>`)
351 * MP4: validate values in ``__setitem__`` so things don't fail in save()
352 :bug:`236`
353 * tests: Fix SynchronizedTextSpec test on big-endian machines :bug:`247`
354 (Daniel Plachotich)
355 * ID3: do type checking in ``__setitem__`` :bug:`251`
356 * Building the documentation now requires sphinx >= 1.3
357 * New :class:`mutagen.Tags` base class for tags
358 * Moved from Bitbucket to GitHub
359
360
361 1.31 - 2015.09.10
362 -----------------
363
364 * New padding control API for flac/id3/mp4/asf/ogg/aiff and everything
365 based on it, except oggflac :bug:`229`
366 * Mutagen will now reduce padding on save if there is lots of it.
367 * delete() will remove padding in addition to tags.
368
369 * ASF:
370
371 * Padding support :bug:`201`
372 * Don't report negative lengths for some broken files
373 * New :class:`asf.ASFInfo`.codec_type/codec_name/codec_description
374 * Implement ASF.delete()
375
376 * OGG: Padding support for Opus/Vorbis/Theora/Speex
377 * M4A: Implementation removed. Every operation will raise. Use mp4 instead.
378 * Tools: Support Unicode output under Windows :bug:`232`
379
380
381 1.30 - 2015.08.22
382 -----------------
383
384 * FLAC:
385
386 * Fix :meth:`flac.FLAC.save` in case the source contained a too large
387 (invalid but recovered) image block :bug:`226`
388
389 * MP3:
390
391 * Improved length and bitrate accuracy:
392
393 * Read lame "Info" tags for improved bitrate/length accuracy
394 * Use bytes info of VBRI headers for improved bitrate accuracy
395 * Subtract encoder delay/padding from length for improved length accuracy
396 (especially for short tracks)
397 * Fix rare false identification of Xing headers :bug:`182`
398
399 * New :class:`mp3.MPEGInfo`.encoder_info attribute containing the encoder
400 name and version :bug:`66`
401 * New :class:`mp3.MPEGInfo`.bitrate_mode attribute exposing if the file is
402 VBR, ABR or CBR :bug:`24` :bug:`66`
403 * New :class:`mp3.MPEGInfo`.channels attribute providing the channel count
404 * New :class:`mp3.MPEGInfo`.track_gain/track_peak/album_gain values exposing
405 the replaygain info provided by the lame header :bug:`36`
406
407 * ID3:
408
409 * New :class:`id3.PictureType` enum for the picture type used in APIC frames :bug:`222`
410
411 * MP4:
412
413 * Fix MP4FreeForm.__eq__ and MP4Cover.__eq__ when comparing with bytes
414 :bug:`218`
415
416 * Don't raise on :meth:`FileType.save` if there are no tags. :bug:`227`
417 * Minor fixes: :bug:`228`
418
419
420 1.29 - 2015.05.09
421 -----------------
422
423 * mid3v2: Fix an error under Python 3 with files without tags :bug:`219`
424 * mid3v2: Various Windows+Python2+Unicode fixes :bug:`214`
425 * Don't emit warnings during loading (ID3Warning) :bug:`223`
426 * py.test support
427
428
429 1.28 - 2015.03.06
430 -----------------
431
432 * Various minor fixes to make mutagen behave the same under Python3 as under
433 Python2.
434 * Update gpl text :bug:`205`
435 * Documentation: Add example for how to create a new flac.Picture :bug:`209`
436
437 * ID3:
438
439 * Various error handling fixes (:bug:`110`, :bug:`211`, ...)
440 * Don't hide ID3 loading errors with ID3FileType.
441 * In case a synch safe marked frame isn't sync safe, only warn :bug:`210`
442 * Removed PEDANTIC mode
443
444 * Tools:
445
446 * Add signal handling :bug:`170`
447 * mid3cp: Make it work under Windows.
448 * mutagen-inspect: Make it work under Windows+Python3 :bug:`216`
449 * Support unicode file paths under Windows+Python2 :bug:`214`
450 * Support file paths with invalid encoding under Unix+Python3.
451
452
453 1.27 - 2014.11.28
454 -----------------
455
456 * MP4:
457
458 * New ``MP4Info.codec`` for identifying the contained audio codec
459 e.g. ``"mp4a"``, ``"alac"``, ``"mp4a.40.2"``, ``"ac-3"`` etc.
460 :commit:`b2f22b81c77`
461 * New ``MP4Info.codec_description``: name of the audio codec
462 e.g. ``"ALAC"``, ``"AAC LC"``, ``"AC-3"``
463
464 * OggOpus:
465
466 * Preserve data after vorbis comment (
467 See https://tools.ietf.org/html/draft-ietf-codec-oggopus-05#section-5.2)
468 :bug:`202`
469
470 * AAC:
471
472 * New AAC FileType. Supports loading ADTS/ADIF AAC files. :bug:`15`
473
474
475 1.26 - 2014.11.10
476 -----------------
477
478 * MP4:
479
480 * Parse channels/sample_rate/bits_per_sample/bitrate for ALAC files
481 :bug:`199` :commit:`192cfcaf14` (Adrian Sampson, Christoph Reiter)
482
483 * ASF:
484
485 * Support writing multiple values for
486 Author/Title/Copyright/Description/Rating :bug:`151`
487 * Fix read order for multi value tags
488 * Various Python3 fixes
489
490 * EasyID3: Add more tag mappings :bug:`136` (Ben Ockmore)
491
492 * MPC/SV8: Fix parsing of SH packets with padding :bug:`198`
493
494 * docs:
495
496 * New logo :commit:`b728fa75` (:user:`Samuel Messner <obskyr>`)
497 * Add examples for handling cover art in vorbiscomment :bug:`200`
498 * Add examples for id3v2.3
499
500
501 1.25.1 - 2014.10.13
502 -------------------
503
504 * ID3: Fix parsing of some files with Python 3 :bug:`194`
505
506
507 1.25 - 2014.10.03
508 -----------------
509
510 * Python 3 support (Ben Ockmore et al) :bug:`27`
511 Supported: Python 2.6, 2.7, 3.3, 3.4 (CPython and PyPy)
512 * All custom exceptions now have a common mutagen.MutagenError base class
513 * mutagen.File: prefer theora over vorbis/flac streams in ogg :bug:`184`
514 * New mid3cp script for copying id3 tags :bug:`178`
515 (Marcus Sundman, Ben Ockmore)
516
517 * ID3:
518
519 * Parse 2.3/4 frames with 2.2 names :bug:`177`
520 * Try to detect apev2 tags when looking for id3v1 tags :bug:`122`
521 * New id3.Encoding, id3.ID3v1SaveOptions enums :bug:`190`
522
523 * ASF:
524
525 * Raise a proper exception on invalid utf-16 :bug:`127`
526
527 * APEv2:
528
529 * Fix UnicodeDecodeError during parsing :bug:`174`
530
531 * MP4:
532
533 * Fix struct.error exception during parsing :bug:`119`
534 * New AtomDataType enum for MP4FreeForm.dataformat values
535 * Read some previously ignored purl/egit atoms
536 * Read multi value reverse DNS tags written by foobar2000
537 * Read multi value atoms written by MusicBee :bug:`165`
538 * Write back unknown atoms and ones that failed to parse.
539
540
541 1.24 - 2014.08.13
542 -----------------
543
544 * Moved to Bitbucket: https://bitbucket.org/lazka/mutagen
545 * ID3:
546
547 * Parse utf-16 text frames with wrong termination :bug:`169`
548 * Fix parsing of utf-16 SYLT frames :bug:`173`
549
550 * WavPack:
551
552 * Fix length calculation if sample count is missing in the header :bug:`180`
553
554 * setup.py: Don't install leftover files produced by the test suite :bug:`179`
555 * tests: Fix error with POSIX locale :bug:`181`
556
557 1.23 - 2014.05.14
558 -----------------
559
560 * tools: Don't crash in misconfigured envs, fall back to utf-8.
561 * mp3: Return correct mimetype for MP2 files. :bug:`163`
562 * id3: deterministic sorting of frames. :bug:`166`
563 * AIFF support :bug:`146` (Evan Purkhiser)
564
565 1.22 - 2013.09.08
566 -----------------
567
568 * Minimum required Python version is now 2.6
569 * Online API reference at https://mutagen.readthedocs.org/
570 * EasyID3:
571
572 * Fix crash with empty TXXX values. :bug:`135`
573
574 * ID3:
575
576 * id3v2.3 writing support :bug:`85`
577 * Add iTunes podcast frames (TGID, TDES, WFED) :bug:`141`
578 * Updated id3v1 genre list
579
580 * MP4:
581
582 * add_tags() will not replace existing tags. :bug:`101`
583 * Don't ignore tags if parsing unknown atoms fails.
584 * Raise on invalid 64bit atom size :bug:`132` (Sidnei da Silva)
585
586 * APEv2:
587
588 * Handle invalid tag item count. :bug:`145` (Dawid Zamirski)
589
590 * Ogg:
591
592 * Faster parsing of files with large packets.
593
594 * VComment:
595
596 * Preserve text case for field names added through the dict interface
597 :bug:`152`
598
599 * mid3v2:
600
601 * New -e,--escape switch to enable interpretation of escape sequences and
602 makes escaping of the colon separator possible. :bug:`159`
603
604 * mid3iconv:
605
606 * Convert COMM frames :bug:`128`
607
608 1.21 - 2013.01.30
609 -----------------
610
611 * Fix Python 2.3 compatibility (broken in 1.19).
612 * Fix many warnings triggered by -3. :bug:`27`
613 * mid3v2:
614
615 * Add --TXXX support. :bug:`62` (Tim Phipps)
616 * Add --POPM support. :bug:`71`
617 * Allow setting multiple COMM or TXXX frames with one command line.
618
619 * FLAC:
620
621 * Try to handle corrupt Vorbis comment block sizes. :bug:`52`
622 * Try to handle corrupt Picture block sizes :bug:`106` (Christoph Reiter)
623 * Don't leak file handle with PyPy :bug:`111` (Marien Zwart)
624
625 * ID3:
626
627 * MakeID3v1: Do not generate bad tags when given short dates. :bug:`69`
628 * ParseID3v1: Parse short (< 128 byte) tags generated by old Mutagen
629 implementations of MakeID3v1, and tags with garbage on the front.
630 * pprint: Sort frames by name.
631 * Upgrade unknown 2.3 frames :bug:`97` (Christoph Reiter)
632 * Fix handling of invalid SYLT frames :bug:`105` (Christoph Reiter)
633
634 * MP3:
635
636 * Fix error when loading extremely small MP3s. :bug:`72`
637 * Fix rounding error in CBR length calculation :bug:`93` (Christoph Reiter)
638
639 * Use 'open' rather than 'file' everywhere. :bug:`74` (Dan Callahan)
640 * mid3iconv:
641
642 * Accurately copy QL-style frame encoding behavior. :bug:`75`
643 * Skip unopenable files. :bug:`79`
644
645 * ID3FileType:
646
647 * Remember which tag type load() was called with even if the file
648 doesn't yet have any ID3 tags. :bug:`89`
649
650 * VComment:
651
652 * Prevent MemoryError when parsing invalid header :bug:`112`
653 (Jyrki Pulliainen)
654
655 * ASF:
656
657 * Don't corrupt files on the second save() call :bug:`81` (Christoph Reiter)
658 * Always store GUID objects in the MetadataLibraryBlock :bug:`81`
659
660 * OggTheora: Fix length/bitrate calculation. :bug:`99` (Christoph Reiter)
661 * MP4:
662
663 * Less strict MP4 covr atom parsing. :bug:`86` (Lukáš Lalinský)
664 * Support atoms that extend to the end of the file. :bug:`109`
665 (Sidnei da Silva)
666 * Preserve freeform format flags :bug:`103` (Christoph Reiter)
667
668 * OggOpus support. :bug:`115` (Christoph Reiter)
669 * Musepack:
670
671 * Fix SV7 bitrate calculation :bug:`7` (Christoph Reiter)
672 * Support SV8 :bug:`7` (Christoph Reiter)
673
674 1.20 - 2010.08.04
675 -----------------
676
677 * ASF: Don't store blocks over 64K in the MetadataObject block;
678 use the MetadataLibraryBlock instead. :bug:`60` (Lukáš Lalinský)
679 * ID3: Faster parsing of files with lots of padding. :bug:`65`
680 (Christoph Reiter)
681 * FLAC: Correct check for audio data start. :bug:`67`
682
683 1.19 - 2010.02.18
684 -----------------
685
686 * ID3:
687
688 * POPM: 'count' is optional; the attribute may not exist. :bug:`33`
689 * TimeStampTextFrame: Fix a TypeError in unicode comparisons. :bug:`43`
690 * MakeID3v1: Translate TYER into ID3v1 year if TDRC is not present. :bug:`42`
691
692 * mid3v2:
693
694 * Allow --delete followed by --frame, and --genre 1 --genre 2. :bug:`37`
695 * Add --quiet and --verbose flags. :bug:`40`
696
697 * moggsplit: --m3u option to write an M3U playlist of the new files. :bug:`39`
698 * mid3iconv: Fix crash when processing TCML or TIPL frames. :bug:`41`
699 * VCommentDict: Correctly normalize key names for .keys() iterator. :bug:`45`
700 * MP3: Correct length calculation for MPEG-2 files. :bug:`46`
701 * oggflac: Fix typo in docstring. :bug:`53`
702 * EasyID3: Force UTF-8 encoding. :bug:`54`
703 * EasyMP4: Fix 'genre' translation. :bug:`56`
704
705 1.18 - 2009.10.22
706 -----------------
707
708 * ASF:
709
710 * Distinguish between empty and absent tag values in
711 ContentDescriptionObjects. :bug:`29`
712
713 * mid3iconv:
714
715 * Fix a crash when processing empty (invalid) text frames.
716
717 * MAJOR API INCOMPATIBILITY!!!!
718
719 * EasyID3FileType is now in mutagen.easyid3, not mutagen.id3. This
720 change was necessary to restore API compatibility with 1.16, as
721 1.17 accidentally contained a circular import preventing
722 mutagen.easyid3 from importing by itself. :bug:`32`
723
724 1.17 - 2009.10.07
725 -----------------
726
727 * ID3:
728
729 * Support for the iTunes non-standard TSO2 and TSOC frames.
730 * Attempt to recover from bad SYLT frames. :bug:`2`
731 * Attempt to recover from faulty extended header flags. :bug:`4` :bug:`21`
732 * Fix a bug in ID3v2.4 footer flag detection, :bug:`5`
733
734 * MP4:
735
736 * Don't fail or double-encode UTF-8 strings when given a str.
737 * Don't corrupt 64 bit atom sizes when resizing atoms. :bug:`17`
738
739 * EasyID3:
740
741 * Extension API for defining new "easy" tags at runtime.
742 * Support for many, many more tags.
743
744 * OggVorbis, OggSpeex: Handle bitrates below 0 as per the spec. :bug:`30`
745 * EasyMP4: Like EasyID3, but for iTunes MPEG-4 files.
746 * mutagen.File: New 'easy=True' argument to create new EasyMP3, EasyMP4,
747 EasyTrueAudio, and EasyID3FileType instances.
748
749 1.16 - 2009.06.15
750 -----------------
751
752 * Website / code repository move.
753 * Bug Fixes:
754
755 * EasyID3: Invalid keys now raise KeyError (and ValueError).
756 * mutagen.File: .flac files with an ID3 tag will be opened as FLAC.
757
758 * MAJOR API INCOMPATIBILITY!!!!
759
760 * Python 2.6 has required us to rename the .format attribute of M4A/MP4
761 cover atoms, because it conflicts with the new str.format method.
762 It has been renamed .imageformat.
763
764 1.15 - 2008.12.01
765 -----------------
766
767 * Bug Fixes:
768
769 * mutagen.File: Import order no longer affects what type is returned.
770 * mutagen.id3: Compression of frames is now disabled.
771 * mutagen.flac.StreamInfo: Fix channel mask (support channels > 2). :bug:`35`
772 * mutagen.mp3: Ignore Xing headers if they are obviously wrong.
773
774 1.14 - 2008.05.31
775 -----------------
776
777 * Bug Fixes:
778
779 * MP4/M4A: Fixed saving of atoms with 64-bit size on 64-bit platforms.
780 * MP4: Conversion of 'gnre' atoms to '\xa9gen' text atoms now correctly
781 produces a list of string values, not just a single value.
782 * ID3: Broken RVA2 frames are now discarded. (Vladislav Naumov)
783 * ID3: Use long integers when appropriate.
784 * VCommentDict: Raise UnicodeEncodeErrors when trying to use a Unicode
785 key that is not valid ASCII; keys are also normalized to ASCII
786 str objects. (Forest Bond)
787
788 * Tests:
789 * FLAC: Use 2**64 instead of 2**32 to test overflow behavior.
790
791 1.13 - 2007.12.03
792 -----------------
793
794 * Bug Fixes:
795
796 * FLAC: Raise IOError, instead of UnboundLocalError, when trying
797 to open a non-existent file. (Lukáš Lalinský, Debian #448734)
798 * Throw out invalid frames when upgrading from 2.3 to 2.4.
799 * Fixed reading of Unicode strings from ASF files on big-endian
800 platforms.
801
802 * TCP/TCMP support. (Debian #452231)
803 * Faster implementation of file-writing when mmap fails, and
804 exclusive advisory locking when available.
805 * Test cases to ensure Mutagen is not vulnerable to CVE-2007-4619.
806 It is not now, nor was it ever.
807 * Use VBRI header to calculate length of VBR MP3 files if the Xing
808 header is not found.
809
810 1.12 - 2007.08.04
811 -----------------
812
813 * Write important ID3v2 frames near the start. (Lukáš Lalinský)
814 * Clean up distutils functions.
815
816 1.11 - 2007.04.26
817 -----------------
818
819 * New Features:
820
821 * mid3v2 can now set URL frames. (Vladislav Naumov)
822 * Musepack: Skip ID3v2 tags. (Lukáš Lalinský)
823
824 * Bug Fixes:
825
826 * mid3iconv: Skip all timestamp frames. (Lukáš Lalinský)
827 * WavPack: More accurate length calculation. ('ak')
828 * PairedTextFrame: Fix typo in documentation. (Lukáš Lalinský)
829 * ID3: Fixed incorrect TDAT conversion. The format is DDMM, not
830 MMDD. (Lukáš Lalinský)
831
832 * API:
833
834 * Metadata no longer inherits from dict.
835 * Relatedly, the MRO has changed on several types.
836 * More documentation for MP4 atoms. (Lukáš Lalinský)
837 * Prefer MP3 for files with unknown extensions and ID3 tags.
838
839 1.10.1 - 2007.01.23
840 -------------------
841
842 * Bug Fixes:
843
844 * Documentation mentions ASF support.
845 * APEv2 flags and valid keys are fixed.
846 * Tests pass on Python 2.3 again.
847
848 1.10 - 2007.01.21
849 -----------------
850
851 * New Features:
852
853 * FLAC: Skip ID3 tags. Added option to delete them on save.
854 * EncodedTextSpec: Make private members more private.
855 * Corrupted Oggs generated by GStreamer (e.g. Sound Juicer) can be read.
856 * FileTypes have a .mime attribute which is a list of likely MIME types
857 for the file.
858 * ASF (WMA/WMV) support.
859
860 * Bug Fixes:
861
862 * ID3: Fixed reading of v2.3 tags with unsynchronized data.
863 * ID3: The data length indicator for compressed tags is written
864 as a synch-safe integer.
865
866 1.9 - 2006.12.09
867 ----------------
868
869 * New Features:
870
871 * OptimFROG support.
872 * New mutagen.mp4 module with support for multiple data fields per atom
873 and more compatible tag saving implementation.
874 * Support for embedded pictures in FLAC files (new in FLAC 1.1.3).
875
876 * mutagen.m4a is deprecated in favor of mutagen.mp4.
877
878 1.8 - 2006.10.02
879 ----------------
880
881 * New Features:
882
883 * MonkeysAudio support. (#851, Lukáš Lalinský)
884 * APEv2 support on Python 2.5; see API-NOTES. (#852)
885
886 1.7.1 - 2006.09.24
887 ------------------
888
889 * Bug Fixes:
890
891 * Expose full ID3 tag size as .size. (#848)
892
893 * New Features:
894
895 * Musepack Replay Gain data is available in SV7 files.
896
897 1.7 - 2006.09.15
898 ----------------
899
900 * Bug Fixes:
901
902 * Trying to save an empty tag deletes it. (#813)
903 * The semi-public API removal mentioned in 1.6's API-NOTES happened.
904 * Stricter frame ID validation. (#830, Lukáš Lalinský)
905 * Use os.path.devnull on Win32/Mac OS X. (#831, Lukáš Lalinský)
906
907 * New Features:
908
909 * FLAC cuesheet and seektable support. (#791, Nuutti Kotivuori)
910 * Kwargs can be passed to ID3 constructors. (#824, Lukáš Lalinský)
911 * mutagen.musepack: Read/tag Musepack files. (#825, Lukáš Lalinský)
912
913 * Tools:
914
915 * mutagen-inspect responds immediately to keyboard interrupts.
916
917 1.6 - 2006.08.09
918 ----------------
919
920 * Bug Fixes:
921
922 * IOError rather than NameError is raised when File succeeds in
923 typefinding but fails in stream parsing.
924 * errors= kwarg is correctly interpreted for FLAC tags now.
925 * Handle struct.pack API change in Python 2.5b2. (SF #1530559)
926 * Metadata 'load' methods always reset in-memory tags.
927 * Metadata 'delete' methods always clear in-memory tags.
928
929 * New Features:
930
931 * Vorbis comment vendor strings include the Mutagen version.
932 * mutagen.id3: Read ASPI, ETCO, SYTC, MLLT, EQU2, and LINK frames.
933 * mutagen.m4a: Read/tag MPEG-4 AAC audio files with iTunes tags. (#681)
934 * mutagen.oggspeex: Read/tag Ogg Speex files.
935 * mutagen.trueaudio: Read/tag True Audio files.
936 * mutagen.wavpack: Read/tag WavPack files.
937
938 * Tools:
939
940 * mid3v2: --delete-frames. (#635)
941
942 1.5.1 - 2006.06.26
943 ------------------
944
945 * Bug Fixes:
946
947 * Handle ENODEV from mmap (e.g. on fuse+sshfs).
948 * Reduce test rerun time.
949
950 1.5 - 2006.06.20
951 ----------------
952
953 * Bug Fixes:
954
955 * APEv2
956
957 * Invalid Lyrics3v2 tags are ignored/overwritten.
958 * Binary values are autodetected as documented.
959
960 * OggVorbis, OggFLAC:
961
962 * Write when the setup packet spans multiple pages.
963 * Zero granule position for header packets.
964
965 * New Features:
966
967 * mutagen.oggtheora: Read/tag Ogg Theora files.
968 * Test Ogg formats with ogginfo, if present.
969
970 1.4 - 2006.06.03
971 ----------------
972
973 * Bug Fixes:
974
975 * EasyID3: Fix tag["key"] = "string" handler. (#693)
976 * APEv2:
977
978 * Skip Lyrics3v2 tags. (Miguel Angel Alvarez)
979 * Avoid infinite loop on malformed tags at the start of the file.
980
981 * Proper ANSI semantics for file positioning. (#707)
982
983 * New Features:
984
985 * VComment: Handle malformed Vorbis comments when errors='ignore' or
986 errors='replace' is passed to VComment.load.
987 (Bastian Kleineidam, #696)
988 * Test running is now controlled through setup.py (./setup.py test).
989 * Test coverage data can be generated (./setup.py coverage).
990 * Considerably more test coverage.
991
992 1.3 - 2006.05.29
993 ----------------
994
995 * New Features:
996
997 * mutagen.File: Automatic file type detection.
998 * mutagen.ogg: Generic Ogg stream parsing. (#612)
999 * mutagen.oggflac: Read/tag Ogg FLAC files.
1000 * mutagen.oggvorbis no longer depends on pyvorbis.
1001 * ID3: SYLT support. (#672)
1002
1003 1.2 - 2006.04.23
1004 ----------------
1005
1006 * Bug Fixes:
1007
1008 * MP3: Load files with zeroed Xing headers. (#626)
1009 * ID3: Upgrade ID3v2.2 PIC tags to ID3v2.4 APIC tags properly.
1010 * Tests exit with non-zero status if any have failed.
1011 * Full dict protocol support for VCommentDict, FileType, and APEv2 objects.
1012
1013 * New features:
1014
1015 * mutagen.oggvorbis gives pyvorbis a Mutagen-like API.
1016 * mutagen.easyid3 makes simple ID3 tag changes easier.
1017 * A brief TUTORIAL was added.
1018
1019 * Tools:
1020
1021 * mid3iconv, a clone of id3iconv, was added by Emfox Zhou. (#605)
1022
1023 1.1 - 2006.04.04
1024 ----------------
1025
1026 * ID3:
1027
1028 * Frame and Spec objects are not hashable.
1029 * COMM, USER: Accept non-ASCII (completely invalid) language codes.
1030 * Enable redundant data length bit for compressed frames.
1031
1032 1.0 - 2006.03.13
1033 ----------------
1034
1035 * mutagen.FileType, an abstract container for tags and stream information.
1036 * MP3: A new FileType subclass for MPEG audio files.
1037 * FLAC:
1038
1039 * Add FLAC.delete.
1040 * Raise correct exception when saving to a non-FLAC file.
1041 * FLAC.vc is deprecated in favor of FLAC.tags.
1042
1043 * VComment (used by FLAC):
1044
1045 * VComment.clear to clear all tags.
1046 * VComment.as_dict to return a dict of the tags.
1047
1048 * ID3:
1049
1050 * Fix typos in PRIV._pprint, OWNE._pprint, UFID._pprint.
1051
1052 * mutagen-pony: Try finding lengths as well as tags.
1053 * mutagen-inspect: Output stream information with tags.
1054
1055 0.9 - 2006.02.21
1056 ----------------
1057
1058 * Initial release.