https://github.com/audeering/audiofile

Handling audio files in Python
https://github.com/audeering/audiofile

audio read write

Last synced: 8 months ago
JSON representation

Handling audio files in Python

• Host: GitHub
• URL: https://github.com/audeering/audiofile
• Owner: audeering
• License: other
• Created: 2019-03-20T09:00:27.000Z (almost 7 years ago)
• Default Branch: main
• Last Pushed: 2025-01-03T10:48:40.000Z (about 1 year ago)
• Last Synced: 2025-06-06T22:03:29.272Z (8 months ago)
• Topics: audio, read, write
• Language: Python
• Homepage: https://audeering.github.io/audiofile/
• Size: 16.1 MB
• Stars: 38
• Watchers: 3
• Forks: 2
• Open Issues: 5
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
=========

audiofile

=========

|tests| |coverage| |docs| |python-versions| |license|

The Python package **audiofile** handles all kind of audio files

with a focus on `reading speed`_.

It can read and request information

on channels, duration, number of samples and sampling rate

for all files that are supported by

ffmpeg_,

sox_,

and mediainfo_.

In addition,

it can write WAV, FLAC, MP3, and OGG files.

Have a look at the installation_ and usage_ instructions as a starting point.

Code example for reading a file:

.. code-block:: python

    import audiofile

    signal, sampling_rate = audiofile.read("signal.wav")

Under the hood it uses soundfile_ to read the audio files,

converting non-supported formats first to WAV files.

The same approach is applied

when requesting duration for formats that need to be decoded

to ensure that duration and number of samples match.

.. _ffmpeg: https://www.ffmpeg.org/

.. _installation: https://audeering.github.io/audiofile/installation.html

.. _mediainfo: https://mediaarea.net/en/MediaInfo/

.. _usage: https://audeering.github.io/audiofile/usage.html

.. _reading speed: https://audeering.github.io/audiofile/benchmark.html

.. _sox: http://sox.sourceforge.net/

.. _virtualenv: https://virtualenv.pypa.io/

.. _soundfile: https://python-soundfile.readthedocs.io/

.. |tests| image:: https://github.com/audeering/audiofile/workflows/Test/badge.svg

    :target: https://github.com/audeering/audiofile/actions?query=workflow%3ATest

    :alt: Test status

.. |coverage| image:: https://codecov.io/gh/audeering/audiofile/branch/main/graph/badge.svg?token=LVF0621BKR

    :target: https://codecov.io/gh/audeering/audiofile/

    :alt: code coverage

.. |docs| image:: https://img.shields.io/pypi/v/audiofile?label=docs

    :target: https://audeering.github.io/audiofile/

    :alt: audiofile's documentation

.. |python-versions| image:: https://img.shields.io/pypi/pyversions/audiofile.svg

    :target: https://pypi.org/project/audiofile/

    :alt: audiofile's supported Python versions

.. |license| image:: https://img.shields.io/badge/license-MIT-green.svg

    :target: https://github.com/audeering/audiofile/blob/main/LICENSE

    :alt: audiofile's MIT license