Metadata-Version: 2.4
Name: mediafile
Version: 0.17.0
Summary: A simple, cross-format library for reading and writing media file metadata.
License-Expression: MIT
License-File: LICENSE
Author: Adrian Sampson
Author-email: adrian@radbox.org
Requires-Python: >=3.10
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Environment :: Web Environment
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: Implementation :: PyPy
Provides-Extra: docs
Requires-Dist: filetype (>=1.2.0)
Requires-Dist: mutagen (>=1.46)
Requires-Dist: sphinx (>=7.4.7) ; extra == "docs"
Project-URL: Bug Tracker, https://github.com/beetbox/mediafile/issues
Project-URL: Documentation, https://mediafile.readthedocs.io
Project-URL: Hopepage, https://mediafile.readthedocs.io
Project-URL: Repository, https://github.com/beetbox/mediafile
Description-Content-Type: text/x-rst

MediaFile: read and write audio files' tags in Python
=====================================================

.. image:: https://github.com/beetbox/mediafile/actions/workflows/main.yml/badge.svg?branch=master
    :target: https://github.com/beetbox/mediafile/actions

.. image:: https://img.shields.io/pypi/v/mediafile.svg
    :target: https://pypi.python.org/pypi/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.

.. _mutagen: https://github.com/quodlibet/mutagen

Synopsis
--------

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

.. code-block:: python

    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``.

.. _on pypi: https://pypi.python.org/pypi/mediafile

Documentation
-------------

See the `full documentation`_.

.. _full documentation: https://mediafile.readthedocs.io/

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.

.. _adrian sampson: https://github.com/sampsyo

.. _beets: https://github.com/beetbox/beets

.. _mit: https://www.opensource.org/licenses/mit-license.php

