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'] = 'Nattfödd'
>>> song['album']
'Nattfödd'
>>> song.save()
>>>

Saving a copy of the song with the new metadata to a new file: >>> song.save(filename=’Finntroll/Nattfödd - 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.