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

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

.. image:: http://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 2.7 and Python 3.4 or later. Then:

.. code:: python

  >>> from mediafile import MediaFile
  >>> f = MediaFile('Lucy.mp3')
  >>> f.title
  u'Lucy in the Sky with Diamonds'
  >>> f.artist = 'The Beatles'
  >>> f.save()

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

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

See the `full documentation`_.

.. _full documentation: http://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: http://www.opensource.org/licenses/mit-license.php
