A pure python module for working with WAVE files with support for all common file formats for both RIFF and RIFX.
Project description
Introduction
A pure python module for working with WAVE files with support for all common file formats for both RIFF and RIFX.
When working with WAVE files, there are two main pure python modules available:
- builtin.wave
Python built-in module, lacks support for float and 24bit integer. Provides raw data instead of an array of values.
- scipy.wave
Scipy does not support 24bit integer files. The module strength and weakness is its simplicity, if all you need to do is read and write, this might be for you.
The wave module provides a fully featured dedicated module that can be used as an alternative to the above if flexibility and ease of use are desirable.
Comparison
The following table shows a comparison of supported functionality:
Functionality |
builtin.wave |
scipy.wave |
wavy |
---|---|---|---|
RIFF Format Support |
|||
RIFX Format Support |
|||
Read Audio Information |
|||
Read Data As Array |
|||
Read Tag Information |
The following table shows a comparison of supported formats for uncompressed WAVE files:
Sample Width |
Format Tag |
builtin.wave |
scipy.wave |
wavy |
---|---|---|---|---|
8 bit |
PCM |
|||
EXTENSIBLE |
||||
16 bit |
PCM |
|||
EXTENSIBLE |
||||
24 bit |
PCM |
|||
EXTENSIBLE |
||||
32 bit |
PCM |
|||
EXTENSIBLE |
||||
FLOAT |
||||
64 bit |
FLOAT |
Installation
The latest stable version is available on PyPI.
Either add wavy to your requirements.txt file or install with pip:
pip install wavy
Usage
Read File
Open a file using the module use wavy.read:
>>> import wavy
>>> file = wavy.read("audio.wav")
>>> file
WaveFile(sample_width=16, framerate=44100, n_channels=2, n_frames=286653)
Get the data for the file:
>>> rate, data = file.framerate, file.data
>>> rate
44100
>>> data.shape
(286653, 2)
>>> data.dtype
int16
Get File Info
To read the file information without loading the data use wavy.info:
>>> wavy.info("audio.wav")
WaveFileInfo(sample_width=16, framerate=44100, n_channels=2, n_frames=286653, tags=None)
License
This project is licensed under the MIT License - see the LICENSE file for details.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.