Guide · Raspberry Pi

Install Stembox on a Raspberry Pi

You flash the Stembox image onto a microSD card once, with Raspberry Pi Imager, the free official tool from Raspberry Pi. Then the card goes into the Pi and Stembox starts on its own. It takes about fifteen minutes.

Raspberry Pi Imager, Write step: summary Raspberry Pi 4, Stembox image, microSD card, and the Write button

What you need

A Raspberry Pi 4

With 2 GB of memory or more. The Raspberry Pi 3 is not powerful enough.

A microSD card

16 GB minimum, 32 GB recommended, good quality (A1 or A2 class).

A card reader

Built into your computer, or a small USB microSD reader.

Your Stembox account

To download the image and find your license key.

Raspberry Pi Imager uses your computer's language. The screenshots below are in French: the buttons are in the same places.

Step 1

Download the Stembox image

In your account, Software tab, click the Raspberry Pi button. You get a file ending in .img.xz (about 1.9 GB).

Open my account

Do not unzip the file: Raspberry Pi Imager reads it as it is.

Step 2

Install Raspberry Pi Imager

Raspberry Pi Imager is free and available for Windows, macOS and Linux. Download the version for your computer from the official Raspberry Pi website, install it, then put the microSD card in the reader.

Download Raspberry Pi Imager

On Windows, Imager asks for permission to make changes when it starts: this is normal, it needs it to write to the card.

Step 3

Choose your Raspberry Pi

  1. In the list, click Raspberry Pi 4.
  2. Click NEXT.
Raspberry Pi Imager, Device step: Raspberry Pi 4 selected and the Next button
Step 4

Choose the Stembox image

The list shows Raspberry Pi's operating systems. Scroll to the very bottom and click the last option, Use custom image.

Raspberry Pi Imager, OS step: the Use custom image option at the bottom of the list

Select the downloaded file

  1. Go to the folder where the file was downloaded (usually Downloads) and click the Stembox image.
  2. Click Open.
File selection window: the Stembox image for Raspberry Pi and the Open button

The image is selected

  1. The Use custom image option is highlighted, with the size of the image (about 12 GB once unpacked).
  2. Click NEXT.
Raspberry Pi Imager: the Stembox custom image is selected
Step 5

Choose the microSD card

  1. Click your microSD card. Check its size: it must match your card.
  2. Leave Exclude system drives ticked: your hard drives do not show up, so they cannot be erased by mistake.

Everything on the selected card will be erased. Remove other USB drives and cards before this step, so you cannot pick the wrong one.

Raspberry Pi Imager, Storage step: the microSD card selected and Exclude system drives ticked
Step 6

Write the card

  1. Check the summary: Raspberry Pi 4, the stembox-pi-image image and your card.
  2. Click WRITE and confirm that the card will be erased.

Imager writes then verifies the card: allow 5 to 15 minutes depending on the card and the reader. At the end it ejects the card: you can take it out.

Raspberry Pi Imager, Write step: summary Raspberry Pi 4, Stembox image, microSD card, and the Write button
Step 7

Start the Raspberry Pi

  • Put the microSD card in the Raspberry Pi, plug the screen and your DJ controller straight into a USB port of the Pi, then plug in the power supply (USB-C, 5 V 3 A).
  • The first start takes a minute or two, then Stembox opens on its own.
  • Enter your license key: you will find it in your account, License tab. Connect the Pi to Wi-Fi if you want to receive updates.

You only flash the card once: Stembox updates then arrive directly on the Raspberry Pi.

Frequently asked questions

Do I need to unzip the .img.xz file?

No. Raspberry Pi Imager reads the .img.xz file directly and unpacks it while writing.

Does it work with a Raspberry Pi 3?

No. Stembox needs a Raspberry Pi 4 with 2 GB of memory or more: on a Pi 3, the sound drops out and the screen freezes.

Which microSD card should I choose?

A card of at least 16 GB, 32 GB recommended, from a known brand, A1 or A2 class. A slow card makes writing and starting up longer.

I'm on a Mac or on Linux, is it the same?

Yes. Raspberry Pi Imager has the same steps on Windows, macOS and Linux. Only the file selection window looks different.

Writing failed, what should I do?

Start writing again. If the error comes back, try another USB port or another card reader, then another microSD card: a worn or fake card is the most common cause.

Do I have to flash the card again for each new version?

No. Once Stembox is installed, updates arrive directly on the Raspberry Pi. Flash the card again only if you want to start from scratch.

Ready to flash your card?

The Stembox image for Raspberry Pi is waiting in your account. A question? Our team will answer.