Python Audiolayer

.. image:: https://travis-ci.org/remcohaszing/grunt-angular-templatecache.png?branch=master :target: https://travis-ci.org/remcohaszing/python-audiolayer

This package contains a Python 3 Extension for playing audio files, reading and writing metadata and converting those files. For decoding and encoding files the libav_ library is used. Playback is handled by libportaudio_.

The project can be found at GitHub <https://github.com/remcohaszing/python-audiolayer>_ and PyPi <https://pypi.python.org/pypi?name=audiolayer&:action=display>_.

Requirements

• python3.x (Tested using python3.3)
• libavcodec
• libavformat
• libavutil
• libportaudio

Installation

Using pip::

pip install audiolayer

From GitHub::

git clone https://github.com/remcohaszing/python-audiolayer.git
cd python-audiolayer
python3 setup.py install

Usage

Reading song metadata:

from audiolayer import Song filename = 'Finntroll - Trollhammaren.flac' song = Song(filename) song['artist'] Finntroll song['album'] Trollhammaren song['title'] Trollhammaren

Saving song metadata:

song['album'] = 'Nattfdd' song['album'] 'Nattfdd' song.save()

Saving a copy of the song with the new metadata to a new file:

song.save(filename='Finntroll/Nattfdd - Trollhammaren.flac')

Converting the song (not implemented):

converted = song.convert('Finntroll - Trollhammaren.ogg', ... format='opus', q=4) converted.filename Finntroll - Trollhammaren.ogg

Playback (current implementation):

song.play() # Wait for the song to finish.

Playback (target implementation):

song.play() 0.00 song.pause() 4.29 song.play_or_pause() 4.29 song.playing_time 12.53

Testing

The unittests can be run using::

python3 setup.py test

It is also possible to use nose_ to run the tests::

python3 setup.py nosetests

Coding style

• C code must be in compliance with pep7_.
• Python code must be in compliance with pep8_.
• All code must be covered by unittests.

To test the Python code for pep8 compliance, go to the project root directory and run::

python3 setup.py flake8

License

This project is licensed under the BSD 3-Clause License.

WIP

This project is still a work in progress.

.. _libav: https://libav.org .. _libportaudio: http://portaudio.com/ .. _nose: http://nose.readthedocs.org .. _pep7: http://www.python.org/dev/peps/pep-0007 .. _pep8: http://www.python.org/dev/peps/pep-0008