GitHub - adafruit/Adafruit_CircuitPython_Wave: Wave file library for CircuitPython (original) (raw)

Introduction

Documentation Status Discord Build Status Code Style: Ruff

Read and write standard WAV-format files

Dependencies

This driver depends on:

Please ensure all dependencies are available on the CircuitPython filesystem. This is easily achieved by downloadingthe Adafruit library and driver bundleor individual libraries can be installed usingcircup.

Installing from PyPI

On supported GNU/Linux systems like the Raspberry Pi, you can install the driver locally from PyPI. To install for current user:

pip3 install adafruit-circuitpython-wave

To install system-wide (this may be required in some cases):

sudo pip3 install adafruit-circuitpython-wave

To install in a virtual environment in your current project:

mkdir project-name && cd project-name python3 -m venv .venv source .env/bin/activate pip3 install adafruit-circuitpython-wave

Installing to a Connected CircuitPython Device with Circup

Make sure that you have circup installed in your Python environment. Install it with the following command if necessary:

With circup installed and your CircuitPython device connected use the following command to install:

circup install adafruit_wave

Or the following command to update an existing version:

Usage Example

import adafruit_wave

with adafruit_wave.open("sample.wav") as w: print(w.getsampwidth()) print(w.getnchannels()) print(list(memoryview(w.readframes(100)).cast("h")))

Documentation

API documentation for this library can be found on Read the Docs.

For information on building library documentation, please check outthis guide.

Contributing

Contributions are welcome! Please read our Code of Conductbefore contributing to help this project stay welcoming.