mediafile

MediaFile is a simple interface to the metadata tags for many audio file formats. It wraps Mutagen, a high-quality library for low-level tag manipulation, with a high-level, format-independent interface for a common set of tags.

Synopsis

MediaFile is available on PyPI. Install it by typing pip install mediafile. It works on Python 3.10 or later. Then:

from mediafile import MediaFile

f = MediaFile("Lucy.mp3")
f.title
"Lucy in the Sky with Diamonds"
f.artist = "The Beatles"
f.save()

MediaFile also exposes plural fields for repeated metadata values, such as artists, albumartists, lyricists, composers, arrangers, and remixers.

Documentation

See the full documentation.

Authors

MediaFile is part of the beets project. It was originally written by Adrian Sampson and is now developed by the beets community. The license is MIT.

Metadata

Release files for mediafile 0.17.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mediafile 0.17.0
File	Size	Uploaded
mediafile-0.17.0.tar.gz	24.6 kB	Apr 24, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mediafile 0.17.0
File	Interpreter	ABI	Platform	Reset
mediafile-0.17.0-py3-none-any.whl 29.9 kB Apr 24, 2026	Python 3	none	any	Details

Total release size: 54.5 kB

Release files / mediafile-0.17.0.tar.gz

Download URL	mediafile-0.17.0.tar.gz
Size	24.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`80c9003fd25d7096a7237e3b58e6ff018ef67f9c39900feafacabac1742c7d3a`
BLAKE2b-256 checksum How to use checksums	`e302460b31c20833036d8f171b991ff2f46c7f1dc85c6219e8bf7efca4a9aa5a`
Upload date	Apr 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/beetbox/mediafile
Publishing commit: github.com/beetbox/mediafile/tree/40970543d54641d83dd4a4484fca33e132b98759

Workflow

Publishing configuration: github.com/beetbox/mediafile/blob/40970543d54641d83dd4a4484fca33e132b98759/.github/workflows/make_release.yaml
Publishing logs: github.com/beetbox/mediafile/actions/runs/24907030386/attempts/1

Artifact

Subject: mediafile-0.17.0.tar.gz
SHA-256 checksum: 80c9003fd25d7096a7237e3b58e6ff018ef67f9c39900feafacabac1742c7d3a Verifying attestations

Release files / mediafile-0.17.0-py3-none-any.whl

Download URL	mediafile-0.17.0-py3-none-any.whl
Size	29.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1bba387527d474f4d93a1c4033ecaff4700e9e311cfac334b9232e409a222a59`
BLAKE2b-256 checksum How to use checksums	`0058c4389f744b64fa81c5380cf2b0bed7e67b5789443860e5d51d31206b8e9d`
Upload date	Apr 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/beetbox/mediafile
Publishing commit: github.com/beetbox/mediafile/tree/40970543d54641d83dd4a4484fca33e132b98759

Workflow

Publishing configuration: github.com/beetbox/mediafile/blob/40970543d54641d83dd4a4484fca33e132b98759/.github/workflows/make_release.yaml
Publishing logs: github.com/beetbox/mediafile/actions/runs/24907030386/attempts/1

Artifact

Subject: mediafile-0.17.0-py3-none-any.whl
SHA-256 checksum: 1bba387527d474f4d93a1c4033ecaff4700e9e311cfac334b9232e409a222a59 Verifying attestations