Getting started

Pre-requisites

bzzzbz is a self-contained video-synthesizer prototype that runs on a Raspberry Pi 3B+ with additional custom hardware to interface with external inputs. All the code and the information in this repository is adapted for this specific prototype. Check out the hadrware section to build your own "box"!

However, some of the functionalities should also work on most Linux distributions (tested on Ubuntu and Linux Mint) without the need of the hardware. You can:

• Run simple visuals without any control or audio input.
• Run audio-reactive visuals with you computer microphone. bzzzbz uses JACK audio server that is cross platform and uses the first input port that it "finds" on the system. This is however system dependent and you might have to modify the audio processing code to pick the right input (for example, your computer might be connected to an audio interface and have multiple input channels). On most cases, it should pick up the microphone.

All the examples and guides in this documentation will refer to the bzzzbz prototype, with commands issued from the Raspberry Pi shell. Everything that can be also implemented on a Linux machine will be explicitly specified with the following block quote at the beginning of the section:

Desktop compatible

Installation

Environment set-up

Desktop compatible

Clone this repository in your local environment:

foo@bar:~$ git clone https://github.com/daviderovell0/bzzzbz
foo@bar:~$ cd bzzzbz

A number of packages need to be installed prior installation. The quickest way is through the dependencies.sh script in the repository. Make sure to update the package manager first:

foo@bar:~$ sudo apt-get update
foo@bar:~$ sudo sh dependencies.sh

If you want to install package dependencies manually, the list below provides information on the external packages:

• OpenGL libraries

Build