A easy wrapper for mutagen
Project description
phrydy
This package originates from the file beets/mediafile.py of the beets project.
Handles low-level interfacing for files’ tags. Wraps Mutagen to automatically detect file types and provide a unified interface for a useful subset of music files’ tags.
Installation
From Github
git clone git@github.com:Josef-Friedrich/phrydy.git
cd phrydy
python setup.py install
From PyPI
pip install phrydy
easy_install phrydy
Usage
Basic usage:
>>> from phrydy import MediaFile >>> f = MediaFile('Lucy.mp3') >>> f.title u'Lucy in the Sky with Diamonds' >>> f.artist = 'The Beatles' >>> f.save()
List all available fields of a media file:
from phrydy import MediaFile
media_file = MediaFile('test/files/full.mp3')
for key in MediaFile.readable_fields():
value = getattr(media_file, key)
if key != 'art' and value:
print('{}: {}'.format(key, value))
A field will always return a reasonable value of the correct type, even if no tag is present. If no value is available, the value will be false (e.g., zero or the empty string).
Internally MediaFile uses MediaField descriptors to access the data from the tags. In turn MediaField uses a number of StorageStyle strategies to handle format specific logic.
Development
Test
tox
Publish a new version
git tag 1.1.1 git push --tags python setup.py sdist upload
Package documentation
The package documentation is hosted on readthedocs.
Generate the package documentation:
python setup.py build_sphinx
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.