libsoundtouch

What it is and what it does

Libsoundtouch is a Python library for controlling Bose Soundtouch speakers over your local network. It wraps the Soundtouch REST API and WebSocket protocol, letting you discover devices, control playback (play, pause, next, previous), manage volume, select inputs (AUX, Bluetooth, internet radio, Spotify, local music), and create multi-room zones by linking multiple speakers together. The library also supports event listeners via WebSocket so you can react to volume, status, preset, and zone changes without polling.

The package depends on requests for HTTP calls, websocket-client for real-time notifications, zeroconf for mDNS device discovery, and enum-compat for Python 2.7 compatibility. It is a pure-Python wheel with low install friction, but it has been abandoned since 2018 and has not been tested against recent Soundtouch firmware or modern Python versions.

Use it for:

• Automate playback on Bose speakers in a home automation system by discovering devices and controlling them programmatically.
• Build a multi-room audio controller that creates zones to synchronize music across multiple Soundtouch speakers in different rooms.
• Create event-driven integrations that listen for volume or track changes via WebSocket and trigger downstream actions.
• Play specific sources (Spotify, internet radio, local music) on a Soundtouch device from a Python application or script.
• Snapshot and restore the current playback state on a speaker for pause-and-resume workflows.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Control Bose Soundtouch devices over the network, including playback, volume, presets, and multi-room zone management via HTTP and WebSocket APIs.

No, unless you own legacy Bose Soundtouch devices with old firmware and are willing to test thoroughly. The library has been abandoned for over 6 years with no updates to match modern Soundtouch firmware or Python versions. The runtime dependencies may themselves be outdated or incompatible. If your devices are recent or you need active maintenance and support, look for a maintained alternative or contact Bose for current API documentation.

Install

libsoundtouch on PyPI

pip install libsoundtouch

uv add libsoundtouch

poetry add libsoundtouch

Installing libsoundtouch

Before you install

Low install friction with a pure-Python wheel. However, the package is abandoned—last release was 2018-02-11, over 6 years old. The repository is not archived but has received no commits since 2022-10-29. Use only if your Soundtouch devices and firmware are old enough to match the API version this library targets.

License in practice

Apache License 2.0 is permissive; you may use, modify, and distribute this library freely in commercial or private projects, provided you include the license notice.

Quickstart

pip install libsoundtouch

from libsoundtouch import soundtouch_device
device = soundtouch_device('192.168.1.1')
device.power_on()
device.set_volume(30)
status = device.status()
print(status.track)

Requires a Bose Soundtouch device on the same network with a compatible firmware version; the library targets older API versions and may not work with recent device firmware.

Verify before relying

• Whether this library works with current Bose Soundtouch firmware versions or only legacy devices.
• Whether the runtime dependencies (requests, enum-compat, websocket-client, zeroconf) are still actively maintained and compatible with modern Python versions.
• Whether HTTPS playback support has been added since the last release in 2018.

Package facts

Evidence: libsoundtouch-0.8.0-py2.py3-none-any.whl

Keywords: bose, soundtouch

Tags

More Libraries packages