Skip to content
Branch: master
Go to file
Code

Latest commit

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 

README.md

SNDFILE.IO

A simple module providing a unified API to read and write sound-files to and from numpy arrays. If no extra modules are installed, it uses only standard modules and numpy to read and write uncompressed formats (WAV, AIFF).

If other modules are installed (see supported backends), then they are used.

Even without third-party packages, it has certain advantages over the built-in modules wave and aifc.

  • support for PCM16, PCM24, PCM32 and FLOAT32
  • unified output format, independent of encoding (always float64)
  • unified API for all backends

API

sndread

  • reads ALL the samples 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

Dependencies

Mandatory

  • numpy
  • scipy

Optional Backends

License

See the LICENSE file for license rights and limitations (MIT).

About

simple python module providing a unified API to read and write sound-files to and from numpy arrays

Topics

Resources

License

Releases

No releases published

Languages

You can’t perform that action at this time.