Chapter 1: Getting Started

The Welcome Screen

When you launch Controller Pro for the first time, you will be greeted by the Welcome Screen. Because Controller Pro communicates directly with your hardware without relying on external cloud servers, a local network connection is required.

• Ensure your phone, tablet, or computer is connected to the exact same Wi-Fi network as your Bose SoundTouch speakers.

• Tap Proceed to Setup to launch the network scanner.

Discovering Your Speakers

Controller Pro needs to build a roster of your available speakers. The Network & Speakers menu gives you two ways to connect:

• Auto-Scan (Recommended): Tap the 🔍 Find Speakers button. The app will perform a radar sweep of your local Wi-Fi network and automatically add any compatible SoundTouch hardware it detects.

• Manual Entry: If your home network router blocks automatic discovery, simply type your speaker's local IP address (e.g., 192.168.0.25) into the Add Speaker by IP field and tap Add.

Managing Your Speaker Roster

Once your speakers are discovered, they will populate in a clean, interactive list at the top of the modal.

• Select Active Speaker: Tap any speaker in the list to make it your active controller. The currently selected speaker will be highlighted in blue and marked with a checkmark (✓).

• Remove Speakers: If you move a speaker to a different network or no longer want it to appear in your app, simply tap the Red Trash Can icon to permanently delete it from your local memory.

• Switching On the Fly: You can open this menu at any time by tapping the Network Icon in the top left corner of the main dashboard to switch control between different rooms.

Chapter 2: The Main Dashboard

The main dashboard is the central control hub for your active speaker. From here, you can view the "Now Playing" status, adjust volumes, and trigger your favorite audio streams with a single tap.

Standard Mode: Radio & Presets

When the center toggle switch is set to RADIO (Blue), the six buttons in the middle of your screen directly correspond to the physical 1-6 preset buttons on top of your Bose speaker.

• Play a Preset: Simply tap any saved preset to instantly wake the speaker and start streaming that station or playlist.

• Dynamic Labels: Unlike the official app, Controller Pro pulls the actual names of your saved radio stations and Spotify playlists and displays them right on the buttons so you never forget what is saved to each slot.

• Clear a Preset: To clear a preset slot, simply long-press (press and hold) the button for about one second.

Macro Mode: Multi-Room Scenes

By flipping the center switch to SCENES (Purple), those same six buttons transform into a powerful smart-home macro engine. A "Scene" allows you to take a snapshot of the exact current state of your house and recall it instantly later.

• Capturing a Scene: Set up your house exactly how you want it (e.g., grouping the Kitchen and Living Room together, setting the volume to 30, and playing a specific Jazz station). Then, tap an empty + Scene slot. The app will capture that exact state and save it.

• Deploying a Scene: Tap a saved Scene at any time. Controller Pro will automatically wake the necessary speakers, group them together, adjust their individual volumes, and start the music with just one tap.

• Deleting a Scene: Just like standard presets, long-press a saved Scene to delete it.

Chapter 3: Discovering & Casting Music

Open Web Radio Search (Bluetooth or AirPlay only)

Controller Pro bypasses the old, restricted TuneIn API and taps directly into an open-source, global radio directory directly in the app. This gives you access to thousands of high-quality internet radio stations from around the world.

• Searching: Simply tap the search bar in the middle of the dashboard and type the name of an artist, genre, or specific station (e.g., "Virgin"). Tap the blue Search button.

• Browsing Results: The app will instantly display a dropdown list of matching stations. Controller Pro automatically filters out dead links and displays the audio bitrate (e.g., 128kbps) right under the station name so you can choose the highest quality stream.

• Instant Playback: Tap the green Play button next to any search result to instantly cast it to your active SoundTouch Bluetooth or Airplay connected speaker only.

• Saving Stations: Once a station is playing, you can use the Save to Preset button on the main dashboard to permanently lock it to one of your 1-6 Preset buttons.

• Before starting internet radio streams or direct URLs, please make sure your device is connected to the speaker via Bluetooth/Airplay

The Spotify Integration

Because the official Bose cloud servers are deprecated, standard Spotify linking through the Bose app is no longer reliable. Controller Pro features a custom-built Spotify engine to keep your music playing.

Tap the circular Spotify button at the bottom of the main dashboard to open the Spotify Modal.

• Resume Last Session: The giant green button does exactly what it says. Tap it to instantly wake your speaker from standby, clear any frozen audio buffers, and force it to resume exactly what you were listening to during your last Spotify session.

• Advanced Actions (Ghost Link): If you want to cast a brand new playlist or album, tap this dropdown. You can paste a standard Spotify link (URL or URI) directly into the app. Controller Pro will use a custom "Ghost Link" to securely cast the new music straight to your speaker, completely bypassing the broken Bose cloud.(May not function after 6 May 2026)

Custom Stream URLs (Direct URL Casting)

If you have a direct link to a raw audio stream (like an independent web radio station or a direct MP3/M3U8 feed), you can cast it directly to your speaker without needing a search engine. Uses Bluetooth/Airplay only.

• Accessing the Menu: Tap the Settings gear icon in the top right corner of the main dashboard, scroll to the bottom, and tap the pink Play from URL button.

• Casting a Stream: Enter an optional name for the station (so you know what is playing), paste your raw audio link into the URL field, and tap the bright pink ▶ Cast Stream button.

• Saving Custom URLs: Just like standard radio stations, once your custom URL is playing, you can return to the main dashboard and use the Save to Preset button to permanently bind it to one of your 1-6 quick-access slots.

Chapter 4: Local Media (The Vault)

Controller Pro features a powerful "Hybrid Engine" that allows you to stream your own personal music files directly over your Wi-Fi network. It natively supports both standard DLNA NAS drives (like Synology or Ubuntu servers) and Windows PC libraries created via the official Bose app.

Access this feature by tapping the Settings gear icon, then tapping Browse Local NAS.

Selecting Your Media Server

When you first open the NAS Library, the app will scan your network and display all available media servers.

• Status Indicators: A green dot next to a server means it is online and ready. A red dot means the server is currently sleeping or offline.

• Selecting a Drive: Simply tap the name of your preferred server (e.g., "Ubuntu Music Vault") to connect to it. A checkmark (✓) will appear to confirm your active connection.

• Switching Drives: If you have multiple servers on your network, you can quickly jump between them at any time by tapping the Switch NAS button in the top right corner.

Browsing & Searching Your Files

Once connected to a drive, Controller Pro provides a lightning-fast, native file browser to navigate your music collection.

• Folder Navigation: Tap any folder (e.g., "Music" or "Browse Folders") to drill down into your library. The app features a smart history stack, allowing you to seamlessly back out of deep folder structures.

• Play Full Albums: When you open an album folder, you will see a ▶ Play Full Folder/Album button at the top. Tapping this will queue the entire album to your speaker.

• Dynamic Search: For massive libraries, manual browsing can be tedious. Use the search bar at the top to instantly query your drive. Use the dropdown menu to filter your search by Track, Artist, or Album. (Note: The search feature is only available for standard NAS drives, not Windows PC libraries). * Preset Saving: Just like internet radio and Spotify, you can cast a local MP3 or a full local album, return to the main dashboard, and tap Save to Preset to assign it to a physical 1-6 button!

Chapter 5: Advanced Features & Settings

The Multi-Room Mixer

Tap the Mixer Icon (the microchip symbol next to the volume label) on the main dashboard to open the Multi-Room Mixer. This is where you manage speaker grouping for whole-home audio.

• Grouping Speakers: Check the box next to any available speaker to instantly join it to your current playback session. Uncheck the box to remove it.

• Individual Volume Control: Use the dedicated sliders to perfectly balance the volume in each room.

• Sync Sliders to Master: When toggled ON, adjusting the master volume on the main dashboard will proportionally adjust all grouped speakers at the same time, maintaining your perfect room-to-room balance.

Device Settings Modal

Tap the Settings Gear Icon in the top right corner of the main dashboard to access hardware-specific configurations.

• Rename Speaker: Type a new name into the box and tap Save to permanently rename the active speaker across your entire network.

• Hardware Controls: Adjust your speaker's physical Bass Level using the slider. You can also toggle the OLED Clock Display (for SoundTouch 20/30 models) and enable or disable the Auto-Off (Standby) power-saving feature. ST10 pairing will also show here (not shown) when two ST10s are connected

Recently Played List

Controller Pro automatically remembers your listening habits so you don't have to search for your favorite stations every time.

• Accessing the List: Open the Settings Modal and tap View Recently Played.

• Quick Resume: The app stores a local history of your most recent internet radio stations. Simply tap the green Play button next to any station to instantly tune back in.

System Diagnostics Terminal

If you are experiencing audio dropouts or connection issues, the Diagnostics Terminal provides raw, real-time telemetry straight from the speaker's internal network card.

• Accessing the Terminal: Open the Settings Modal and tap System Diagnostics near the bottom.

• IP / MAC / Serial: The unique network and hardware identifiers for your active speaker. 

• Signal Health: The most important metric here is SIGNAL_HEALTH. If this reads as POOR or AVERAGE in orange or red text, your speaker is too far from your router, which can cause DLNA or internet radio streams to skip. A reading of GOOD or EXCELLENT means your network connection is rock solid!

• Stored Profiles: This indicates the number of different Wi-Fi networks the speaker has saved in its internal memory over its lifetime. (Tip: A high number of stored profiles can sometimes cause connection confusion or delays if the speaker is trying to find old networks). 

Native Stereo Pairing

Controller Pro allows you to natively bind two identical SoundTouch 10 speakers to act as dedicated Left and Right stereo channels, giving you a much wider and richer audio soundstage.

How to Create a Stereo Pair:

1. Tap the Device Settings (gear icon) on the main dashboard.

2. Scroll down and tap Native Stereo Pairing. (Note: This button will only appear if the app detects two or more compatible speakers (ST10s) on your network).

3. In the pairing menu, use the dropdowns to select your Left Channel (Master) and your Right Channel.

4. Tap Create Pair. The speakers will chime to confirm the bond.

Good to Know (After Pairing):

• Unified Control: Once paired, the app will automatically merge the two speakers into a single entity in your Network & Speakers list. You only need to select this new "Master" speaker to control the pair.

• L/R Balance: Creating a stereo bond unlocks a new L/R Balance slider inside your Device Settings, allowing you to fine-tune the audio stage to your room.

• Renaming: You can rename the entire stereo pair at any time by simply renaming the Master speaker in your settings.

• Separating: To unpair the speakers, return to the Stereo Pairing menu and tap Separate Speakers.