Speaker Volume Bridge
Volume settings
The Volume page controls synchronization direction, safety limits, and how computer volume maps to Sonos volume.
Two-way synchronization
When enabled, confirmed Sonos volume changes can update the computer output. On the first successful connection, Sonos state is applied locally.
When disabled, the bridge runs computer to Sonos only. Sonos observations still confirm connection health, but they do not change the computer output. On the first successful connection, the computer state is sent to Sonos.
The current treatment of computer output volume is being discussed in issue #74.
Repeated callbacks and volume feedback
In v1.6.3, repeated or overlapping notifications from the app’s own computer-volume writes are kept from becoming new Sonos commands on macOS and Ubuntu. The app also skips computer volume and mute writes when the requested property already matches. This protection is automatic and does not pause listening for other volume changes.
A computer-volume change at connection time remains expected with two-way synchronization enabled. If volume keeps moving after you stop adjusting it, follow Diagnostics and troubleshooting.
Mute speaker at zero volume
When enabled, moving computer volume to 0% also mutes the speaker. Raising volume above zero allows it to be unmuted through normal synchronization, provided the computer itself is not muted.
In v1.6.3, this option also sends the computer’s mute state with local changes even when Synchronize mute is off. Turn both options off to stop computer-to-Sonos mute commands. Sonos-to-computer mute follows Two-way synchronization. See Devices.
Highest speaker volume
This is a safety cap for volume commands sent by the bridge to Sonos. The default is 55%. It does not prevent another controller or the speaker itself from setting a higher volume.
Start conservatively, especially with powerful speakers, amplifiers, or unfamiliar volume mappings. Raising the computer volume to 100% never authorizes the bridge to exceed this cap.
Volume feel
| Choice | Behavior | Good starting point |
|---|---|---|
| Balanced | Gives more control at lower levels and rises more gently | Normal desktop listening |
| Direct | Keeps Sonos volume close to the computer percentage, subject to the cap | Users who want similar numbers on both sides |
| Scaled | Maps the full 0% to 100% computer range across 0% to the selected maximum | Using the full range of keyboard or system controls |
In v1.6.3, the Balanced curve reaches 55% Sonos volume when the computer reaches 100%. The highest-volume setting can lower that result, but raising the cap above 55% does not raise the Balanced curve. Choose Direct or Scaled if you need the selected maximum to be reachable above 55%.
Test speaker volume
The test reads the speaker’s current volume and writes the same value back. It verifies that the selected device accepts a volume command without intentionally making the speaker louder or quieter.
If the test fails, check Diagnostics and troubleshooting.