Edit on GitHub

Getting started

Getting started with balenaSound is as simple as deploying it to a balenaCloud application; no additional configuration is required (unless you're using a DAC HAT). We've outlined the installation steps below. If you want a step-by-step tutorial on how to get balenaSound up and running, feel free to check these blog posts:

Hardware required

  • Raspberry Pi 3A+/3B/3B+/4B/Zero W
  • SD Card (we recommend 8GB Sandisk Extreme Pro)
  • Power supply
  • 3.5mm audio cable to the input on your speakers/Hi-Fi (usually 3.5mm or RCA). Alternatively you can use the HDMI port to get digital audio out.


  • The Raspberry Pi Zero cannot be used on it's own as it has no audio output. To use the Pi Zero, you'll need to add something like the Pimoroni pHAT DAC (out of stock and going to be replaced, see #111) to go with it.
  • For an extended list of device types supported please check this link.

Software required

Provision your device

  • Sign up for or login to the balenaCloud dashboard
  • Create an application, selecting the correct device type for your Raspberry Pi (we recommend setting the type as Raspberry Pi 1/Zero as your application will then be compatible with the Pi 1/Zero as well as all devices that were released afterward).
  • Add a device to the application, enabling you to download the OS
  • Flash the downloaded OS to your SD card with balenaEtcher
  • Power up the Pi and check it's online in the dashboard

Deploy the application

  • Install the balena CLI tools
  • Login with balena login
  • Download this project and from the project directory run balena push <appName> where <appName> is the name you gave your balenaCloud application in the first step.

One-click application creation and deploy

You can use the previous steps to deploy this project and learn more about balena CLI. For a faster path, try our one-button deploy. Once you have a balenaCloud account set up, click this button to go straight to application creation, where balenaSound will be pre-loaded to your application: