USAGE

🇩🇪 Deutsche Version

Usage Guide

How to use OpenCloudTouch in daily life.

---

The Web Interface

Open in your browser: http://opencloudtouch.local:7777

The web UI is optimized for desktop and mobile. On your phone, simply bookmark the URL or add it to your home screen.

💡 Tip: On iPhone/Android, you can add the page as a web app to your home screen. OCT then opens like a native app.

---

Home Screen: Your Devices

The home screen shows your SoundTouch devices. If you have multiple speakers, you can swipe left/right to switch between them.

For each device, you'll see:

• Name of the speaker
• 6 preset buttons (1-6)
• Volume slider

---

Assigning Presets

The 6 presets correspond to the favorite buttons on your SoundTouch speaker. You can assign a radio station to each preset.

Assign a Preset

1. Tap an empty preset (e.g. button 1)
2. The radio search opens
3. Enter a station name (e.g. "BBC Radio 1", "NPR", "Classic FM")
4. Select the desired station from the results list
5. The station is now assigned to your preset ✅

Play a Preset

• In the web UI: Tap the preset button
• On the speaker: Press the corresponding preset button (1-6) directly on the device

Change a Preset

1. Long-press the preset button (or tap the edit icon)
2. Search for a new station
3. Confirm the selection

Remove a Preset

1. Tap the edit icon on the preset
2. Select Remove preset

---

Searching for Radio Stations

The radio search covers over 30,000 stations worldwide (via RadioBrowser.info — a free community directory).

Search Tips

Search by	Example
Station name	"BBC Radio 1", "NPR", "Classic FM"
Genre	"Jazz", "Classical", "Rock"
City/Country	"London", "New York", "Australia"
Language	"German", "French", "Spanish"

The search shows:

• Station name
• Country/Region
• Genre/Tags
• Bitrate (quality)

💡 Tip: The more specific the search, the better the results. "BBC Radio 1" finds the station directly, "Radio" returns thousands of results.

---

Managing Devices

Automatic Discovery

OCT regularly scans your network for SoundTouch devices. New devices appear automatically.

You can also search for devices manually:

• Go to the home screen
• Click Search for devices

Manual IP Entry

If a device isn't found automatically (e.g. on a different network segment):

1. Go to Settings (⚙️)
2. Under Manual Device IPs: Enter the speaker's IP address
3. Click Add

You can find the IP address in your router's connected devices list.

---

Settings

Under Settings (⚙️) you'll find:

Setting	Description
Manual Device IPs	IP addresses for devices that aren't found automatically

---

Daily Tips

🔘 Use Presets on the Device

The preset buttons (1-6) on the SoundTouch speaker work as usual. You don't need to open the web UI to listen to music — the speakers remember their presets.

📱 Web UI as App

Add http://opencloudtouch.local:7777 as a web app to your smartphone's home screen for quick access without opening a browser.

🔄 Updates

OCT is regularly improved. Install updates with:

cd ~/opencloudtouch
docker compose pull
docker compose up -d

🔊 Multiple Speakers

You can manage any number of SoundTouch speakers with a single OCT installation. Swipe between devices in the web UI.

---

Planned Features

These features are being developed:

Feature	Status
🎵 Playback control (Play/Pause/Skip)	In progress
🔊 Multi-room zones	In progress
📻 Additional music services (Spotify, etc.)	Planned
🔄 Firmware info	In progress

---

Next Steps

👉 FAQ — Frequently asked questions

👉 Troubleshooting — When something doesn't work

---

Questions? Problems? Check the FAQ or create a GitHub Issue.