A lightweight, dependency-free Python library for reading metadata and images from various audio file formats.
tinytag is a Python library that extracts metadata from audio files, including tags, images, and technical properties like duration and bitrate. It solves the problem of needing a simple, dependency-free way to read audio metadata across multiple formats without complex setup.
Python developers building applications that need to read audio metadata, such as music players, media organizers, or audio analysis tools.
Developers choose tinytag for its simplicity, zero dependencies, and consistent API across many audio formats, making it a lightweight and reliable alternative to heavier libraries.
Python library for reading audio file metadata
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Pure Python with no external libraries, ensuring easy installation and portability, as highlighted in the README's features list.
Reads metadata from MP3, M4A, WAV, OGG, FLAC, WMA, AIFF, and others with various codecs and tag versions, covering most common audio files.
Provides the same interface across all formats, simplifying code when handling multiple file types, as demonstrated in the usage examples.
Can read embedded cover art and other images with standardized access via tag.images, supporting common types like front_cover and back_cover.
Explicitly does not support writing or editing metadata, requiring a separate library like Mutagen for any modifications, as stated in the README's important note.
May be slower than C-based alternatives for parsing large batches of files, which could be a bottleneck in performance-critical applications.
Version 2.0.0 introduced significant breaking changes and deprecations, such as removing ignore_errors and changing data structures, which can disrupt upgrades.