Bokeh Reactive Audio Widget Library
- Free software: MIT license
- Documentation: https://boreal.readthedocs.io.
Boreal is a library for creating plots that react to audio while the audio is playing. The reactive audio widgets can be used as part of a stand-alone Bokeh application but the primary goal of the framework is to support the exploratory coding process when using Jupyter notebooks for audio research.
The library is designed to be extensible and supports the addition of new audio reactive widgets as well as audio processors that extract information from the underlying audio signal. Playback controls can be used to play, pause, and seek the underlying audio and associated visuals.
Building from source
To build boreal from source try:
python setup.py build
Then to install:
python setup.py install
If all went well, you should be able to run the following command in Python:
import boreal
To see how Boreal works try the following notebook (also part of the package):
https://github.com/gtzan/boreal/blob/main/boreal/audio_widgets_notebook.ipynb
- Bokeh application for audio reactive plots
- Example audio widgets: time domain, spectrum, waveform envelope, circularEQ
- Support for both real-time computation of visuals as well as pre-computation
- Ability to use html audio for playback on a local machine when notebook is hosted remotely
- Straighforward to add new audio widgets and audio processors
Boreal is under development and there is a lot of additinal work planned. Some examples include:
- More audio widgets
- Better documentation
- Support for multi-channel audio
This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.