Reporting a bug

A well described bug gets fixed much faster. Before writing, gather these few pieces of information.

What you see

The color of the light, and whether it is steady, blinking or going round.

What you were doing just before: the card you inserted, the button you pressed, the screen open in the app.

Whether it happens every time, or now and then.

The app and MusicBox versions

The app version: in Settings, tap "About".

The MusicBox version: on its page, in Settings, on the "Software update" line.

Your phone model and its system version.

Anonymous error reports

The app can send us a report when it runs into an error. It offers this at first launch, and you can change your mind in Settings, under "Anonymous error reports". The change takes effect the next time you open the app.

If the problem happens during the flash

For a MusicBox you built yourself

On the Software page, the serial monitor keeps everything the MusicBox printed. Tap "Copy" and attach those lines to your message.

Write to us

Write to us on Discord, or by email if you prefer. Put in your message what you see and the versions: it is what helps us find the cause.

Guide checked on October 29, 2026 against the MusicBox software of that day.

Still stuck?

Write to us on Discord, we answer.

Join the Discord
Newsletter

A letter every two weeks

The project told straight, one Thursday morning out of two. What I build, what ships, and the mistakes along the way.