Multi-Zone Ambient Soundscape Mixer
Sonorium lets you create immersive ambient audio environments. Stream richly layered soundscapes—from distant thunder and rainfall to forest ambiance and ocean waves—to speakers throughout your home or directly through your computer.
Download and run without any dependencies. Perfect for desktop ambient sound.
Download Latest Release | Installation Guide
- Single portable executable—no installation required
- Local audio playback through your default speakers
- Stream to DLNA network speakers
- Automatic updates built-in
Integrate with your smart home for whole-house audio.
- One-click install from addon store
- Use any Home Assistant media_player
- Organize speakers by room, floor, or area
- Control from the HA dashboard
Create and manage multiple audio channels, each streaming to different speakers.
Choose from your library of ambient themes for each channel.
Organize your audio files into themes with favorites and categories.
Configure speakers, volume defaults, and other preferences.
- Mobile Sidebar Close - Fixed mobile menu not closing when tapping the hamburger button or the overlay area. The sidebar now properly collapses on mobile devices.
- Single Speaker Toggle - Fixed speaker toggle bouncing back to enabled when users with only one speaker tried to disable it.
- Browse Available Plugins - New "Browse Catalog" tab in Settings → Plugins lets you discover and install plugins directly from the Sonorium plugin repository with one click.
- One-Click Install - Install plugins without manually downloading ZIP files. The catalog shows installed status and available updates.
- Page Refresh Persistence - Refreshing the browser now stays on your current page instead of returning to Channels view.
- Settings Menu Stays Expanded - When viewing any Settings sub-page, the Settings menu remains expanded through page refreshes.
- Speaker IP Addresses - The Settings → Speakers page now displays each speaker's IP address.
- MQTT Entity Compatibility - Updated for Home Assistant Core 2026.4+ compatibility.
- Plugin Catalog Refresh - Uninstalling a plugin now immediately updates the catalog's "Installed" status.
- Renamed Sonos Entity Support - Sonos speakers are now detected using Home Assistant's entity registry
platformfield rather than relying on the entity_id containing "sonos". Users who have renamed their Sonos entities will now have them properly detected. - Device-Inherited Area Fix - Speakers assigned to an area via their parent device (rather than directly on the entity) now properly display their area instead of "Unassigned".
- Max Channels Setting Now Works - Fixed an issue where the
sonorium__max_channelsaddon setting was ignored. Users can now configure up to 10 channels as intended.
- HA API Fallback - When Cast device IP cannot be discovered (e.g., device on different VLAN), Sonorium now falls back to Home Assistant's
media_player.play_mediaservice. This allows Cast streaming to work across VLANs without manual IP configuration. - mDNS Discovery - Added zeroconf/mDNS discovery as an additional IP resolution method for Cast devices on the same network segment.
- Improved Device Detection - Broader Cast device recognition (Nest Hub, Chromecast, Google Home variants).
- Large Installation Support - Fixed "message too big" error that occurred when querying device registry in Home Assistant installations with many devices. Increased WebSocket message limit from 1MB to 10MB.
- Restored Floor/Room Hierarchy - Fixed a regression where the Settings → Speakers page showed a spinning circle instead of the proper floor/area/speaker tree view.
- Exclusive Track Spacing - Increased the minimum gap between exclusive tracks from 30 seconds to 2 minutes. This prevents multiple exclusive tracks (like different lute songs in a tavern theme) from playing back-to-back.
⚠️ Beta Testing: This version is available in the dev channel for testing. Please report issues!
- HEOS Speaker Support (Beta) - Denon/Marantz HEOS speakers discovered and controlled via CLI protocol
- HEOS Discovery - Automatic detection of HEOS devices via SSDP and mDNS
- pyheos Integration - Uses pyheos library for reliable HEOS communication (falls back to raw telnet)
- Multiple Channels: Run up to 10 independent audio channels simultaneously (configurable)
- Per-Channel Themes: Each channel plays its own theme
- Flexible Speaker Selection: Target individual speakers, entire rooms, floors, or custom speaker groups
- Live Speaker Management: Add or remove speakers from active channels without interrupting playback
- Theme-Based Organization: Audio files organized into theme folders (Thunder, Forest, Ocean, etc.)
- Automatic Mixing: All recordings in a theme blend together seamlessly
- Theme Favorites: Star your most-used themes for quick access
- Custom Categories: Organize themes into categories like "Weather", "Nature", "Urban"
- Theme Icons: Visual icons for easy theme identification
- Bundled Themes: Includes Sleigh Ride, Tavern, and "A Rainy Day... Or is it?" out of the box
Fine-tune how each audio file plays within a theme:
- Presence Control - Set how often each track appears in the mix (0-100%)
- Per-Track Volume - Adjust amplitude independent of presence
- Playback Modes:
- Auto - Automatically selects best mode based on file length
- Continuous - Loop with seamless crossfade
- Sparse - Play once, wait before repeating (for short sounds)
- Presence - Fade in/out based on presence setting
- Save/Load Presets - Store track settings as named presets
- Quick Switching - Select presets directly on channel cards
- Import/Export - Share presets with the community
- MQTT Entities - Full dashboard control via MQTT (session select, theme/preset dropdowns, play/stop, volume)
- Human-Readable Names - Theme and preset dropdowns show names instead of UUIDs
- Status Sensors - See playback status and assigned speakers from your dashboard
- Automation Support - Use HA automations to trigger soundscapes (morning alarms, schedules, etc.)
- Responsive Design: Works on desktop and mobile
- Dark Theme: Easy on the eyes
- Real-Time Status: See what's playing across all channels
- Drag & Drop: Upload audio files directly through the UI
Ambient soundscapes aren't just background noise—they're a powerful tool for mental wellness and productivity:
- ADHD & Focus: Background noise can improve concentration by providing consistent auditory input
- Misophonia: Ambient masking helps cover trigger sounds
- Anxiety & Stress: Nature sounds activate the parasympathetic nervous system
- Sleep: Consistent ambient sound masks disruptive noises
- Work & Study: Moderate ambient noise can boost creative thinking
- Download
Sonorium.exefrom the Releases page - Run the executable (click "More info" → "Run anyway" if Windows SmartScreen appears)
- Create a session, select a theme and speakers
- Play and enjoy your ambient soundscape
- Install the addon using the button above
- Open Sonorium from your Home Assistant sidebar
- Add Themes: Create themes and upload audio via the web interface
- Create a Channel: Select a theme and speakers
- Play: Hit the play button
Full documentation is available in the Wiki:
- Getting Started - Home Assistant installation
- Standalone App - Windows app guide with architecture details
- Themes - Creating and organizing themes
- Track Settings - Playback modes explained
- Presets - Saving track configurations
- Speakers - Speaker setup and management
- API Reference - REST API for automation
- Troubleshooting - Common issues
Audio files: .mp3, .wav, .flac, .ogg
Single-file themes loop seamlessly using crossfade blending—no jarring restarts!
- Local audio output (default speakers)
- DLNA/UPnP network speakers
- Sonos speakers (via SoCo library)
- Arylic/Linkplay speakers (via HTTP API)
- HEOS speakers (Denon/Marantz) - Beta, via CLI protocol
- Coming soon: AirPlay (other devices), Chromecast
- Any media_player entity in Home Assistant
- Google Cast (Chromecast, Nest Hub, Google Home) - with HA API fallback for cross-VLAN setups
- Sonos - Native streaming via SoCo library
- Organized by floors, areas, and custom groups
Sonorium provides a REST API for integration:
GET /stream/{theme_id}- Direct audio stream for a themeGET /stream/channel{n}- Audio stream for channel N
GET /api/sessions- List all sessionsPOST /api/sessions- Create a new sessionPOST /api/sessions/{id}/play- Start playbackPOST /api/sessions/{id}/stop- Stop playbackPOST /api/sessions/{id}/volume- Set volume
GET /api/themes- List all themesPOST /api/themes/create- Create a new themePOST /api/themes/{id}/upload- Upload audio file
Sonorium is a fork of Amniotic by fmtr. The original project laid the groundwork with its innovative approach to ambient soundscape mixing.
See LICENSE file for details.
Contributions are welcome! Please open an issue to discuss changes before submitting a PR.
