Simple API for reading / writing soundfiles
Project description
This package provides a simple and unified API to read and write sound-files to and from numpy arrays.
Documentation
API
sndread
- reads all the samples (or a fragment) from a soundfile and returns a tuplet (data, samplerate)
- Data will always be as a numpy.float64, between -1 and 1, independently of bit-rate
sndread_chunked
- reads chunks of frames, avoiding the allocation of all the samples in memory
sndinfo
- returns SndInfo, a namedtuple with all the information of the sound-file
sndwrite
- writes the samples.
- samples need to be a numpy.float64 array with data between -1 and 1
sndwrite_chunked
- allows you to write to the file as samples become available
resample
Resample a numpy array to a new samplerate
Examples
# Normalize and save as flac from sndfileio import sndread, sndwrite samples, sr = sndread("in.wav") maxvalue = max(samples.max(), -samples.min()) samples *= 1/maxvalue sndwrite(samples, sr, "out.flac")
# Process a file in chunks from sndfileio import * from sndfileio.dsp import with sndwrite_chunked(44100, "out.flac") as writer: for buf in sndread_chunked("in.flac"): # do some processing, like changing the gain buf *= 0.5 writer.write(buf)
Installation
pip install sndfileio
External dependencies
- libsndfile (Debian/Ubuntu: apt install libsndfile1-dev)
Note
In windows and macos all external dependencies are installed automatically
License
See the LICENSE file for license rights and limitations (MIT).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
sndfileio-1.9.0.tar.gz
(22.1 kB
view hashes)