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.

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

• Step 2 (Crucial): When prompted by your device, you must allow "Local Network" (iOS) or "Nearby Devices" (Android) permissions. If this is denied, your phone's security settings will block the app from seeing your speakers.

• Step 3: Tap Proceed to Setup to launch the network scanner.

🔍 Chapter 2: Discovering Your Speakers

Controller Pro needs to build a roster of your available speakers. The Network & Speakers menu gives you three 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.

• Subnet Override (For stubborn networks): If the Auto-Scan doesn't immediately find your speakers, tap the underlined Advanced network options text. Enter the first three blocks of your home network's IP address (e.g., 192.168.1) to force the scanner to push through restrictive router firewalls.

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

📋 Chapter 3: 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 4: 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 or local media (NAS) 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.

• Speaker or App Presets: Highlighted presets are app based while the plain ones are saved on the speaker. 

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 6: Discovering & Casting Music

Open Web Radio Search (App-Only Setup via Bluetooth/AirPlay)

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 speaker. (Note: Please make sure your device is connected to the speaker via Bluetooth or AirPlay before starting playback).

• 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.

Native TuneIn Radio (Rescue Node Setup)

If your system is powered by the local Rescue Node, your hardware's native internet radio capabilities are completely restored. You do not need to use Bluetooth or AirPlay.

• Searching: Use the exact same search bar on the main dashboard to find your favorite global stations.

• Native Playback: Tap the green Play button. The Rescue Node instantly intercepts the live audio stream and routes it directly into the speaker's internal hardware.

• Total Hardware Control: Save your favorite stations directly to your 1-6 Presets. Because the Rescue Node operates independently on your network, you can press the physical preset buttons on top of your speaker to start the radio even when your phone is completely turned off.

🟢 Chapter 7: The Spotify Integration

Because the official Bose cloud servers are permanently 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 icon 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.

• The "Jumpstart" (After a Power Loss): If your speaker is unplugged or loses power, it will temporarily forget its Spotify connection token. If the Resume button doesn't respond, simply open your official Spotify app, play any song directly to the speaker using Spotify Connect, and the token will be instantly restored. From then on, Controller Pro can wake and resume your sessions normally.

🔗 Chapter 8: 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.

Access this menu by tapping the Settings gear icon in the top right corner of the main dashboard, scrolling to the bottom, and tapping the pink Play from URL button.

• App-Only Setup (Bluetooth/AirPlay): Enter an optional name, paste your raw audio link into the URL field, and tap the pink Cast Stream button. (Note: Please ensure your phone is connected to the speaker via Bluetooth/AirPlay first).

• Rescue Node Setup (Native Playback): Enter your stream details and tap Cast. The Rescue Node will intercept the link and force the speaker to play the stream natively, completely freeing up your phone.

• 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 9: 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.

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

Managing Existing Media Servers (All Users) When you first open the NAS Library, the app will display the media servers your speakers already know about.

• 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.

Adding NEW Media Servers (Rescue Node Exclusive) Because the Bose cloud is dead, a standalone app can no longer authorise new hard drives to your speaker's memory.

• If your system is powered by the Rescue Node, a special Add button will dynamically appear in this menu.

• Tapping it allows the Node to scan your network, find brand new NAS drives, and permanently bind their security credentials directly to the speaker's internal hardware.

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 All, Track, Artist, or Album. (Note: The search feature is only available for standard NAS drives, not Windows PC libraries). * Preset Saving: Just like radio, 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 1-6 button. Press and Hold on the speaker to save it to that device!

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.

⚙️ Chapter 10: Device Settings Modal

Tap the Settings gear icon in the top right corner of the main dashboard to access hardware-specific configurations. Because Controller Pro adapts to your exact hardware, some of the options below will only appear if your specific speaker supports them.

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

• Bass Level: Adjust your speaker's physical bass output using the slider.

• L/R Balance: (Appears dynamically) Adjust the left and right audio balance if the active speaker is part of a Native Stereo Pair.

• OLED Clock Display: (Appears dynamically) Toggle the front-facing clock screen on or off for SoundTouch 20, 30, and Wave models.

• AirPlay Optimisation (5s): A built-in troubleshooting tool. Toggling this will clear the speaker's network cache and reboot its network stack to fix Apple AirPlay connectivity issues.

• Connection Beep: Enable or disable the audible beep the speaker makes when it connects to the app.

• Auto-Off (Standby): Enable or disable the speaker's automatic power-saving sleep feature.

• Bluetooth Tips: A quick-reference guide showing you exactly how to put your specific speaker into Bluetooth pairing mode.

• Apple Casting Method: (Appears on Apple devices) Choose whether the app prioritizes routing audio via Apple AirPlay or Bluetooth.

• System Diagnostics: Opens a secure developer terminal showing your speaker's exact IP address, MAC address, and Wi-Fi signal health.

(Note: Advanced navigation buttons for Native Stereo Pairing, Surround Desk, and Play from URL are also located in this menu, and detailed in their respective chapters.)

🕒 Chapter 11: Recently Played List

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

Access this list by opening the Settings gear icon and tapping View Recently Played.

• App-Only Setup: Your history will dynamically display your most recently played Open Web Radio stations and Local NAS tracks or folders.

• Rescue Node Setup: Your history will dynamically display your most recently played Native TuneIn stations and Local NAS media.

• Quick Resume: Simply tap the green Play button next to any item on the list to instantly launch the stream and 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). 

👯 Chapter 12: Native Stereo Pairing

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

How to Create a Stereo Pair (Rescue Node Required)

• Tap the Settings gear icon on the main dashboard.

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

• In the pairing menu, use the dropdown menus to select your Left Channel (Master) and your Right Channel.

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

Good to Know for Existing Pairs and After Pairing (Node Not Required)

• 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. When speakers are unpaired, the speakers revert to their single names (e.g. ST10-1)

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