Sonorium plays ambient sound, such as rain, a forest or a busy tavern, on the speakers in your home. It mixes several recordings and keeps changing how each one plays, so the sound doesn't loop noticeably.
Sonorium runs on a computer that stays on, and you use it from a web page on any phone, tablet or computer in your home. There are three ways to install it. Pick the one that fits the machine you have; each has a complete guide, and all three end at the same place: Sonorium's documentation.
| Home Assistant app | Docker | Windows | |
|---|---|---|---|
| Pick it when | You run Home Assistant OS or Supervised | You have a Linux server or NAS with Docker, with or without Home Assistant | You want Sonorium on a Windows PC |
| Runs on | The Home Assistant machine (amd64 or aarch64) | Any amd64 Docker host | Windows |
| Speakers | Home Assistant's media_player entities |
Found on your network (Google Cast, Sonos, DLNA/UPnP, AirPlay, LinkPlay, HEOS), plus Home Assistant's if linked | See the Windows guide |
| Home Assistant controls | Built in | Optional: link Home Assistant and MQTT in the web UI | See the Windows guide |
| Sign-in | Home Assistant's users | Accounts made in Sonorium | See the Windows guide |
| Updates | Home Assistant's update button | docker compose pull |
See the Windows guide |
Not sure? If you already have Home Assistant OS, use the Home Assistant app. If you have Home Assistant in Docker (Container), use Docker and link it to Home Assistant.
Every path, step by step
- Home Assistant app: the Mosquitto broker, the repository, installing, the options, starting, the sidebar, Home Assistant's users, updating and uninstalling.
- Docker: the folders and compose file, starting, the first admin account, linking Home Assistant and MQTT, running without host networking, updating and uninstalling.
- Windows: installing and starting Sonorium on a Windows PC.
What each path needs in detail: Requirements.
After installing
Once Sonorium is open in your browser, everything works the same on every install:
- Turn on your speakers.
- Make a channel and play it.
- Explore Themes, Presets and Sequences and Playlists.
The full documentation starts at Home.
This page is also in the GitHub wiki.