Skip to content

Installation

João Miguel Tabosa Vaz Marques Silva edited this page Aug 27, 2026 · 2 revisions

Installation

This page covers the current generally available release, v1.3.3.

Only install Sonos Volume Bridge from the official latest release or an official store listing.

Windows direct download

  1. Open the latest full release.
  2. Download the file ending in windows-unsigned.exe.
  3. Run the installer.
  4. Start Sonos Volume Bridge from the Start menu.

The direct-download Windows installer is not digitally signed. Windows SmartScreen may therefore show a warning. Continue only if the file came from this project's official GitHub release page.

The normal graphical installer creates a Start menu shortcut and does not create a desktop shortcut. Installing a newer full release performs an in-place update and preserves application settings.

Microsoft Store on Windows

Stable Windows releases are available from the Microsoft Store. Store availability may lag behind GitHub while Microsoft processes a release.

Use one Windows distribution consistently when possible. If you switch distribution channels, confirm your settings after the new installation starts.

macOS direct download

  1. Open the latest full release.
  2. Download the file ending in macos.zip.
  3. Open the archive.
  4. Move Sonos Volume Bridge.app to Applications.
  5. Launch the app from Applications.

The direct-download macOS app is signed with Developer ID and notarized by Apple. macOS 13 or later is required.

Ubuntu direct download

The v1.3.3 release provides an AMD64 Debian package for 64-bit Ubuntu.

  1. Open the latest full release.
  2. Download the file ending in linux-amd64.deb.
  3. Open it with Ubuntu's software installer, or install it from a terminal:
sudo apt install ./sonos-volume-bridge-v1.3.3-linux-amd64.deb
  1. Start Sonos Volume Bridge from the application menu.

The package depends on pulseaudio-utils, which supplies pactl. It works with PulseAudio or PipeWire's PulseAudio compatibility service. See the Ubuntu guide for audio-service and troubleshooting details.

Direct download and store editions on macOS

Direct-download and store editions can be separate installations with separate application data. Before moving from a direct-download macOS edition to a Mac App Store edition, uninstall the direct-download edition. Settings are not migrated automatically, so select the speaker and audio preferences again.

After installation

Continue with Getting started. If the app opens but cannot find a speaker, go directly to Diagnostics and troubleshooting.

Clone this wiki locally