---
id: tinytag
version: "2.3.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# tinytag — Read audio file metadata

License: permissive · Maintenance: active · Downloads: 5.5M/mo

## What it is and what it does

tinytag is a lightweight Python library for reading metadata from audio files. It extracts common fields like artist, album, title, track number, duration, bitrate, and sample rate from MP3, MP4, FLAC, OGG, WAV, ASF (WMA), and AIFF files using a single consistent API. The library is pure Python with no external dependencies, making it simple to embed in any project.

The package is designed for reading metadata only—it explicitly does not support writing or modifying tags. It provides both a Python API and a command-line interface for quick inspection of audio files. It returns metadata as simple attributes on a TinyTag object, with additional or format-specific fields available through an `other` dictionary.

Use it for:

- Extract duration and bitrate from audio files in a media player or streaming application.
- Build a music library cataloger that reads artist, album, and title from files in bulk.
- Validate audio file properties (channels, sample rate, MIME type) before processing.
- Populate a database with metadata from a folder of mixed audio formats.
- Implement a command-line tool to inspect or report on audio file properties.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Reads metadata (artist, title, duration, bitrate, and more) from audio files in formats including MP3, MP4, FLAC, OGG, WAV, and others, without writing or modifying tags.

Yes. tinytag is actively maintained, has zero known vulnerabilities, no dependencies, and a permissive license. It solves a narrow, well-defined problem (reading audio metadata) reliably across common formats. Install it if you need to extract metadata from audio files without the overhead of a heavier library.

## Install

pip install tinytag
uv add tinytag
poetry add tinytag

## Installing tinytag

Before you install: Low friction: pure Python with no runtime dependencies, distributed as a wheel, and actively maintained with a recent release.

License in practice: MIT license (permissive) means you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install tinytag

from tinytag import TinyTag
tag = TinyTag.get('/path/to/music.mp3')
print(f'{tag.artist} - {tag.title} ({tag.duration:.2f}s)')

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 5.5M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

read audio metadata, mp3 tag reader, audio file properties, extract music metadata, audio duration bitrate, flac ogg wav metadata, pure python audio parser, audio-metadata, pure-python, cli-tool

[View on SkillFed](https://skillfed.io/packages/tinytag) · [View on PyPI](https://pypi.org/project/tinytag/)