PyPI · #1907 most downloaded on PyPI

tinytag

2.3.24.3M downloads/motinytag/tinytag ↗New releases in your daily digest, changelog included.

Read audio file metadata

Last release 27 days ago
07 Sep 2026
Release timing varies
gaps range from 8 days to 12 months
Rarely documented
notes for 9 of 49 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
49 releases · first in 2014

Release timeline

49 releases since 2014

2014201620182020

Releases

2.3.27 Sept 2026
ID3: Optimize parsing of UTF-16 strings
ID3: Optimize parsing of UTF-16 strings

MP4: Only parse decoder specific info if it exists

ASF: Decode strings as UTF-16LE instead of system byte order
Open source →
2.3.130 Aug 2026
Don't open unrecognized files when disabling magic byte detection
Don't open unrecognized files when disabling magic byte detection

MPEG: Fix parsing of some files with incorrect headers

OGG/WAV: Read sizes as little endian instead of native byte order
Open source →
2.3.030 Jul 2026

One column per quarter.

Mark deprecated 'extra' dictionary as obsolete

Add 'mime_type' attribute for audio MIME type/codec
Add 'is_lossless' attribute to indicate lossless audio
Add 'size' attribute to images for size in bytes
Add option to disable magic byte detection
Make XMP metadata available under 'other.xmp' field
Make bit depth available for lossy files providing it
Add .asf, .ogv and .wmv to list of supported file extensions
Mark deprecated 'extra' dictionary as obsolete
Fix incorrect key when adding common images to 'other' dictionary
Fix disc/track numbers not being returned as lists in 'as_dict()'
Only set audio properties with a positive value
Always read tags and audio properties in a single pass
ID3: Parse multi-value text frames correctly
ID3: Parse COMM and USLT frames correctly
ID3: Fix some errors in parsed size calculations
ID3: Exclude a few frames with custom structures
MPEG: Read VBRI and Xing Info headers for duration/bitrate
MPEG: Fix parsing of layer I and MPEG-2 layer III audio properties
MPEG: Fix slightly incorrect duration estimation
MPEG/MP4: Raise ParseError if header is invalid
MP4: Add 'image/bmp' and 'image/gif' MIME types
MP4: Fix infinite loop if size of certain sub-atoms is zero
MP4: Fix incorrect parsing of descriptor size
MP4: Don't read image data when image reading is disabled
OGG: Parse multi-stream files correctly
Speex: Don't read vendor string as comment
FLAC: Provide actual audio bitrate instead of overall bitrate
FLAC: Parse VORBIS_COMMENT and PICTURE blocks with invalid size
FLAC: Ignore subsequent STREAMINFO blocks
WAV: Include unknown fields in 'other' dictionary
WAV: Calculate bitrate/duration correctly
AIFF/WAV: Read whole ID3 chunk before parsing
ASF: Support parsing additional metadata objects
ASF: Stop parsing if object size is smaller than header
ASF: Make magic header detection more strict
Various performance improvements
Various code refactors

Open source →

2.2.115 Mar 2026

ID3: Prevent infinite loop due to malformed SYLT strings

ID3: Prevent infinite loop due to malformed SYLT strings

Open source →

2.2.015 Dec 2025

Add support for movement, work and grouping fields

Add support for movement, work and grouping fields
ID3: Make synced lyrics available in 'other.lyrics' (LRC format)
ID3: Continue reading after encountering empty frame
ID3: Fix frame reading when image parsing is disabled
ID3: Exclude more frames containing binary data
ID3: Avoid unnecessary string decoding
M4A: Support extended atom sizes
M4A: Ensure all field names are lowercase
OGG: Stop reading after reaching EOS page
Vorbis: Map UNSYNCEDLYRICS field to other.lyrics

Open source →

2.1.213 Aug 2025

M4A: Add a few missing additional metadata fields

M4A: Add a few missing additional metadata fields
M4A: Support '©com' composer atom
M4A: Fix reading of multi-value custom fields
M4A: Use correct encoding when reading data names
ID3: Don't read entire file to determine duration
ID3: Skip stray null byte before image data
Add missing __version__ attribute
Avoid some unnecessary work in hot code paths
Improve a few incomplete type hints

Open source →

2.1.123 Apr 2025

ID3: Stop removing 'b' character from strings

ID3: Stop removing 'b' character from strings
Port unit tests from pytest to built-in unittest module

Open source →

2.1.023 Feb 2025

Opus: Take pre-skip into account when calculating the duration

Opus: Calculate audio bitrate
Opus: Take pre-skip into account when calculating the duration

Open source →

2.0.03 Nov 2024Deprecated

DEPRECATION: Mark 'ignore_errors' parameter for TinyTag.get() as obsolete

BREAKING: Store 'disc', 'disc_total', 'track' and 'track_total' values as int instead of str
BREAKING: 'as_dict()' method (previously undocumented) returns tag field values in list form
BREAKING: TinyTagException no longer inherits LookupError
BREAKING: TinyTag subclasses are now private
BREAKING: Remove function to use custom audio file samples in tests
BREAKING: Remove support for Python 2
DEPRECATION: Mark 'ignore_errors' parameter for TinyTag.get() as obsolete
DEPRECATION: Mark 'audio_offset' attribute as obsolete
DEPRECATION: Deprecate 'extra' dict in favor of 'other' dict with values in list form
DEPRECATION: Deprecate 'get_image()' method in favor of 'images.any' property
Add type hints to codebase
Provide access to custom metadata fields through the 'other' dict
Provide access to all available images
Add more standard 'other' fields
Use Flit as Python build backend instead of Setuptools
ID3: Fix invalid sample rate/duration in some cases
ID3: Fix reading of UTF-16 strings without BOM
FLAC: Apply ID3 tags after Vorbis
OGG/WMA: Set missing 'channels' field
WMA: Set missing 'other.copyright' field
WMA: Raise exception if file is invalid
Various optimizations

Open source →

1.10.126 Oct 2023