Hello. I’m very excited about this project. If I may make a couple of small suggestions which could help other noobs.
Which leads to recommendation one: Pump the forums. Tell people, in big clear letters at the top: “This is not going to work as described. When it doesn’t, check out our forums”. Or some variant of that. Nobody reads as far as your troubleshooting section, and they probably try to Google first. But, for some reason, in this case, Google isn’t as helpful as it should be (if you don’t believe me, check this search out. You’ll note that the balena forum response there is not encouraging and doesn’t scream “use the forums” at you - rather, your own anguished scream forces you back to google!).
Then, recommendation two: Perhaps a table of key gotchas - early in the document. I’ve been using a Pi 3B. Turns out that neither Airplay nor Bluetooth work with that device. Perhaps a wild guess, but I suspect a large fraction of folk playing with balenaSound are using a PI 3B. And hope to stream using either Airplay or Bluetooth. From your forums, I suspect that there may be similar issues with the PI 4.
Either way, it turns out that these problems can be reasonably easily solved. Well, Airplay anyway.
I’d be happy to edit your document - but I didn’t spot a link to a repo. So maybe that’s recommendation three: Let the community contribute to the documentation?
Anyway, I’m cautiously optimistic that I’ve got a working sound system again - and I really appreciate the time balena has invested in this project: thank you.