About#

WaloViz is an open-source interactive audio player with a spectrogram built-in, as a Jupyter widget or as HTML.

Welcome!
WaloViz is an open source audio player with a spectrogram built-in, it was built by audio experts - for audio experts.

The name comes from WaloViz = wav + HoloViz, since it supports common audio file formats such as wav and many others thanks to torhcaudio and ffmpeg , and it is interactive thanks to the high customizability of the HoloViz stack, integrated with Bokeh.
To learn more about HoloViz - go to the HoloViz website, to learn more about Bokeh - go to the Bokeh website, they’re great :)

To start using WaloViz right now - read our Getting Started guide.
You can also try waloviz right now with our Google Colab Demo :)

Why WaloViz?#

WaloViz is designed to be accessible but powerful.
With just three lines of code it integrates seamlessly with the most popular notebook IDEs such as JupyterLab, VSCode and Google Colab.
You can use it to view audio URLs and files but also your own processed audio tensor.
An impressive suite of features is at your fingertips, high-level features such as overlaying your data and a built-in download button, and also low-level features for granular control like changing the colormap or sample-rate.

WaloViz is open-source and proud of its community!
With so many benefits, the real question becomes why not?

Why not?#

WaloViz is in early alpha, some features are not fully tested against all platforms, and breaking changes are bound to happen.
That’s exactly why WE NEED YOUR HELP!
There are 3 very simple ways in which you can help right now:

  1. Try it! The Getting Started Guide should get you up to speed. If there’s a problem, tell us about it in a Github Issue and we’ll do our best to help :) If it works and you like it - tell a friend!

  2. Consider giving us a 🌟 on our Github repository! The more stars we have, the larger our community will be, and the better WaloViz will become 🌟

  3. Contribute! WaloViz is a beginner friendly project, read our Contributing Guide and take a shot at one of our Good First Issues!

There might be other reasons why WaloViz might not be suited for your needs, we’d love to hear about them in a Github Issue.
We are always striving to become better, and honest criticism is how we learn best.

Thank you for considering WaloViz!