Setup Guide

Setup Guide

Aucune enceinte

Speaker Setup Guide

Follow these steps to connect your Bose SoundTouch speaker to this app.

Step 1

Connect to the same Wi-Fi network

Your Bose SoundTouch speaker and the server running this app must be on the same local network (same Wi-Fi router or VLAN).

  • • Set up your speaker using the official Bose app first.
  • • Make sure the speaker’s LED is solid white (connected).
  • • The SoundTouch app is only needed for initial Wi-Fi setup.
Step 2

Find the speaker's IP address

You can find the IP address using any of these methods:

Router admin panel

Usually at 192.168.1.1 or 192.168.0.1 → look for 'SoundTouch' in the device list.

Bose SoundTouch app

Settings → Speaker → About → IP address

Network scanner

Tools like 'Advanced IP Scanner' (Windows) or 'LanScan' (macOS).

Step 3

Verify the Bose local API

Open a browser on a device connected to the same network and visit:

http://YOUR_SPEAKER_IP:8090/now_playing

You should see an XML response like:

<nowPlaying deviceID="ABC123" source="STANDBY">
  ...
</nowPlaying>
If you see XML, the speaker’s local API is working correctly.
If you see an error, ensure both devices are on the same subnet and no firewall is blocking port 8090.
Step 4

Auto-discover in this app

Navigate to the Speakers page and click Scan Network.

The app will attempt two discovery methods:

  1. 1mDNS / Bonjour — instant discovery, works when the speaker advertises _soundtouch._tcp.
  2. 2TCP subnet scan — scans your configured subnet (default 192.168.1.x) checking port 8090 on every IP.

You can also add a speaker manually by clicking Add Manually and entering the IP address.

Step 5

Control your speaker

Select your speaker and try the following features:

  • Adjust the volume using the slider
  • Play / Pause / Skip tracks
  • Recall hardware presets (1–6)
  • Play an internet radio station from the library
  • Search for stations via Radio Browser

Troubleshooting

Speaker not found after scan

Ensure both the server and the speaker are on the same subnet. Check your router's DHCP table. Update the subnet in Settings if needed.

Radio station won't play

Direct URL streaming requires SoundTouch firmware 4.x or later. Verify the stream URL is accessible from your network. Try a different stream URL.

Volume/playback commands don't respond

The speaker may be in Standby. Press POWER to wake it up, then try again.

App running in Docker not finding speakers

Use --network host in docker-compose.yml so the container can send multicast mDNS packets. This is the default in the provided docker-compose.yml.

Go to Speakers →Dashboard