Wavy

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)

Authors

• Andrea Celletti - Initial work - Profile, Email

License

This project is licensed under the MIT License - see the LICENSE file for details.