---
id: libsoundtouch
version: "0.8.0"
license: Apache License 2.0
license_treatment: permissive
maintenance: abandoned
---

# libsoundtouch — Bose Soundtouch Python library

License: permissive · Maintenance: abandoned · Downloads: 74.5K/mo

## 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 above — 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

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

- License: Apache License 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 74.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

bose soundtouch control, soundtouch device api, bose speaker automation, multi-room audio zones, soundtouch python library, bose device discovery, soundtouch websocket notifications, iot-control, home-automation, deprecated

[View on SkillFed](https://skillfed.io/packages/libsoundtouch) · [View on PyPI](https://pypi.org/project/libsoundtouch/)