[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80229":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":22,"topics":24,"createdAt":10,"pushedAt":10,"updatedAt":36,"readmeContent":37,"aiSummary":38,"trendingCount":16,"starSnapshotCount":16,"syncStatus":39,"lastSyncTime":40,"discoverSource":41},80229,"Bose-SoundTouch-Hybrid-2026","TJGigs\u002FBose-SoundTouch-Hybrid-2026","TJGigs","Preserves all SoundTouch functionality with a private cloud replacing the Bose Cloud service. A unified web app restoring local control, preserving physical presets, and modernizing speakers with expanded streaming support.","https:\u002F\u002Fwww.youtube.com\u002Fplaylist?list=PLS5KFF3Xd1vmpmRJuNjAk_L_JJNcCjsnr",null,"JavaScript",75,11,4,19,0,5,9,14,15,3.24,false,"main",[25,26,27,28,29,30,31,32,33,34,35],"bose","bose-cloud-service","bose-end-of-life","bose-soundtouch-adapter","bose-soundtouch-hybrid","nodejs","self-hosted","soundtouch","soundtouch-alternatives","soundtouch-hybrid","soundtouch-speaker","2026-06-12 02:03:59","# V3.4 Quick Notes: \n* 🔊 Addresses most of the known bugs including issue 20\n* 🔊 **Includes a complete revamp of the Bose cloud emulation inject sequence. It is now completely automated (does not require USB Hijack)**\n* 🔊 Bose Cloud (Hybrid) has been simplified and is more stable. Prior heavy lifting moved to new Pre-Flight module\n\n## Future Releases and Timing:\n* 📅 V3.5 address remaining new or old bugs (hopefully in another week)\n* 📅 V4 Enhancements target mid-June\n\n### ***BTW: You can see status of issues, discussions and timings using the list labels filters.***\n\n## [Jump To Install Instructions Below:](#setting-up-soundtouch-hybrid)\n\n\n\n# \u003Cimg src=\"public\u002Fimages\u002Fhybrid_icon.png\" width=\"30\"> Bose SoundTouch Hybrid 2026 - V3.4\n\n**A free, open-source private cloud streaming service replacing the Bose Cloud Service to maintain 100% of the smart speaker functionality of your SoundTouch 10, 20, 30, Wave IV Speakers and Wireless Link Adapter. Physical Presets Included!**\n\n\u003Cimg src=\"public\u002Fimages\u002Fbose_icon.png\" width=\"20\">  The Bose shut down of their SoundTouch Cloud Service (May 2026) degraded the Bose SoundTouch intelligent, multi-room audio speakers into \"dumb\" receivers dependent on a phone's active connection. This represents a **significant loss of functionality** for the SoundTouch 10, 20, 30, Wave IV Speakers and Wireless Link Adapter. \n\n\u003Cimg src=\"public\u002Fimages\u002Fhybrid_icon.png\" width=\"20\">  **This solution provides a self-hosted \"Private Cloud\" to emulate and replace the Bose Cloud Service**. It runs locally on your network (NAS, PC, etc.) and intercepts and actively manages the complex server handshakes required to keep the SoundTouch Speakers authenticated and functional, providing the **same phone-free audio streaming capabilities** as the original SoundTouch Application and Speakers. \n\n### ✨ V3 Enhancements:\n\n* ✅ **Custom URL Streaming Library Integration:** Moved the \"play custom URL stream\" function to the Library Manager and added the ability to assign custom streams directly to favorites and physical speaker presets.\n\n* ✅ **Advanced Global and Favorites Search:** Expanded the search functionality with additional filters, including the ability to perform provider-specific searches.\n\n* ✅ **Auto-Resume Presets:** Speakers now remember if a preset was active when powered off and will automatically resume that specific preset upon the next power-on.\n\n* ✅ **In-App Update Notifications:** Automatically checks for new releases and displays a notification banner within the UI when a new version is available.\n\n* ✅ **Live Console Logging:** Integrated a real-time server log viewer directly into the System Tools page.\n\n* ✅ **Streamlined GHCR Deployment:** Transitioned from manual repository cloning to a pre-built GitHub Container Registry image. The system now automatically generates required configuration templates on first boot and performs startup configuration and version validation checks.\n\n* ✅ **Improved State Synchronization:** Completely replaced backend REST API polling with a more efficient, stable, and event-driven WebSocket architecture for improved speaker state and audio stream tracking.\n\n* ✅ **Music Assistant Native DLNA Metadata:** Takes advantage of Music Assistant's improved DLNA streaming by reading track metadata directly from the audio stream. The original API-based fetch has been streamlined into a lightweight \"Watchdog\" function that executes as a fallback only when needed. *(MASS v2.8.5 or later required)*\n\n* ✅ **Music Assistant Smart Startup & Version Checks:** On boot, the app now verifies the Music Assistant version and automatically launches the container if it detects it isn't running.  *(MASS v2.8.5 or later required)*\n\n\n### ✨ Application Key Features:\n* **100% Local Control:** Your data and control logic stay on your LAN. No reliance on external Bose servers.\n* **Complete App Replacement:** A single, responsive web interface for **Desktop** and **Mobile** that handles both streaming and speaker maintenance, completely eliminating the need for the legacy SoundTouch app or provider-specific streaming apps. Includes support for initial speaker setup, factory resets, WiFi provisioning,\n\n* ### ***And Automatic Non-USB Injection of the Bose SoundTouch Hybrid Bose Cloud Emulation***\n\n* **Hardware Intelligence Preserved:** \n  * ✅ **Local Bose Cloud Emulation:** Local replacement emulating  the required Bose Cloud handshakes to keeping the speakers authenticated and fully functional.\n  * ✅ **The Physical 1-6 Preset Buttons:** Remain assignable to any source via the Hybrid Bridge and work instantly.\n  * ✅ **Volume, Power, & Presets:** Physical speaker buttons remain fully functional and sync perfectly with the new Hybrid app.\n  * ✅ **Native Hardware Grouping:** Utilizes Bose's near-zero-latency Master\u002FSlave hardware grouping instead of software-level sync. This guarantees perfect multi-speaker audio regardless of whether you are streaming from a new Hybrid cloud source or a local input.\n* **Expanded Music Universe:** Bridges your speakers to modern sources powered by Music Assistant (MASS v2.8.5 or later requried) \u003Cimg src=\"public\u002Fimages\u002Fma_icon.png\" width=\"15\">\n  * Spotify, Apple Music, YouTube Music\n  * Local NAS Files, Plex, Jellyfin\n  * Internet Radio (TuneIn, DI.fm)\n  * Others from MASS\n  * Global Agnostic Search within SoundTouch Hybrid Library of all your MASS sources\n\n## 🛠 Architecture\n* **Backend:** Custom Node.js\u002Fserver acting as the \"Audio Engine\" (Music Assistant \u003Cimg src=\"public\u002Fimages\u002Fma_icon.png\" width=\"15\"> ) and local Bose Cloud Emulation ☁️.\n* **Frontend:** Responsive Web App deployable to any browser.\n* **Connectivity:** Direct IP control over Bose WebSockets & XML API. \n\u003Cimg src=\"public\u002Fdocs\u002FArchitectureIntro.png\" alt=\"SoundTouch Hybrid Architecture Diagram\" width=\"700\">\n\n### ☁️ BOSE CLOUD EMULATION AND HYBRID FEATURES:\n\n### Authentication & Provisioning\n* Full BMX Registry and MargeID handshakes\n* Dynamic account profile generation\n* Source Providers Authorization (e.g., `11`, `LOCAL_INTERNET_RADIO`)\n* Automated injection of Hybrid Preset Physical Buttons (1-6)\n* Automated Cloud Redirect Setup (points speakers to local server)\n\n### Device Rescue (NVRAM Auto-Healer)\n* Factory-reset speaker detection and setup\n* Gabbo System Bus (Port `8080`) websocket backdoor access\n* Automated UI setup bypass (Language → Name → Account Binding → Seal)\n* Permanent NVRAM persistence flag generation (`\u003CsetupState state=\"SETUP_LEAVE\" \u002F>`)\n\n### System Traps & Speaker Protection\n* Dummy radio base URL generation (streaming check bypass)\n* DRM streaming token mocks\n* Boot-loop prevention (Account deletion trap)\n* Telemetry and analytics blocking\n* Firmware update bypass \n* Factory reset request spoofing (Fake `201 Created`)\n* Device rename and profile sync spoofing\n\n### Server Stability & Caching\n* Real-time speaker identity fetching (MAC, Serial, Name)\n* Local identity caching to handle heavy network traffic\n* Failsafe request dropping (protects busy speakers from accidental preset wipes)\n\n## 📺 \u003Cimg src=\"public\u002Fimages\u002Fhybrid_icon.png\" width=\"20\"> Demo Videos\n\u003Ca href=\"https:\u002F\u002Fyoutu.be\u002FR6mbTRBEBYA\" target=\"_blank\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.youtube.com\u002Fvi\u002FR6mbTRBEBYA\u002Fmaxresdefault.jpg\" alt=\"Bose SoundTouch Hybrid 2026 Initial Demo Video\" width=\"300\">\n\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fyoutu.be\u002F3BhAkpsZjBI\" target=\"_blank\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.youtube.com\u002Fvi\u002F3BhAkpsZjBI\u002Fmaxresdefault.jpg\" alt=\"Bose SoundTouch Hybrid 2026 V2 Enhancements Demo Video\" width=\"300\">\n\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fyoutu.be\u002FERsoMmyOpEU\" target=\"_blank\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.youtube.com\u002Fvi\u002FERsoMmyOpEU\u002Fmaxresdefault.jpg\" alt=\"Bose SoundTouch Hybrid 2026 V3 Enhancements Demo Video\" width=\"300\">\n\u003C\u002Fa>\n\n\n\n## \u003Cimg src=\"public\u002Fimages\u002Fhybrid_icon.png\" width=\"20\"> Getting Started\n\nReview **[SoundTouch Hybrid 2026 Technical Documentation](https:\u002F\u002Fgithub.com\u002FTJGigs\u002FBose-SoundTouch-Hybrid-2026\u002Fblob\u002Fmain\u002Fpublic\u002Fdocs\u002FSoundTouchHybridDocumentation.pdf)** for detailed system architecture, technical development findings and solutions, and visual setup screenshots.\n\n## Installations via Docker Compose \n\n***You must verify your SoundTouch speakers and streaming providers are fully working inside of Music Assistant prior to using the SoundTouch Hybrid Application.***\n\n### \u003Cimg src=\"public\u002Fimages\u002Fma_icon.png\" width=\"18\"> Setting up Music Assistant (MASS)\nInstall Music Assistant (MASS):  ***version 2.8.5 or later is required***\n\n1. **For installation instructions and troubleshooting, use Music Assistant Help:** This includes help for setup, providers, speakers testing, playback issues, etc.\n   * See [MASS GitHub](https:\u002F\u002Fgithub.com\u002Fmusic-assistant\u002Fserver) \n   * See [MASS Website](https:\u002F\u002Fwww.music-assistant.io\u002Finstallation)\n   * To run MASS using my specific configuration, I included my `mass_docker.yml` and `mass_package.json` files located in the `examples` subfolder. Your MASS install may or may not be the same but these are provided as reference.\n\n2.\t**Initial Setup:** Once MASS is installed go to it's web interface to create your login ID and password. These will be used by the SoundTouch Hybrid system to access MASS. *(the SoundTouch Hybrid system does not require a MASS \"Long-lived Access Token\").*\n\n3.\t**Configure Providers:** Add your desired streaming providers (e.g., Local NAS, TuneIn, Spotify, etc.) and configure any local Music Library synchronization options. Examples of synchronization options are on Page 13 in the [SoundTouch Hybrid Documentation](https:\u002F\u002Fcdn.jsdelivr.net\u002Fgh\u002FTJGigs\u002FBose-SoundTouch-Hybrid-2026@main\u002Fpublic\u002Fdocs\u002FSoundTouchHybridDocumentation.pdf#page=13)\n    * *I choose not to enable MASS local library synchronization for my providers to ensure that content search using the SoundTouch Hybrid Library search function (via MASS Search) is directly accessing the most recent data from streaming providers rather than relying on a local MASS cached and periodically sync'd copy. You may decide otherwise.*\n   \n5.\t**Configure UPnP:** Enable the DLNA\u002FUPnP provider, and for each of your SoundTouch speakers ensure you select DLNA as your **\"Preferred Output Protocol.\"** DLNA is recommended because the Bose SoundTouch Hybrid system’s self-healing logic, latency management, and real-time state synchronization are heavily optimized for DLNA\u002FUPnP. The majority of stabilization regression testing was done with this protocol. See Page 12 in the [SoundTouch Hybrid Documentation](https:\u002F\u002Fcdn.jsdelivr.net\u002Fgh\u002FTJGigs\u002FBose-SoundTouch-Hybrid-2026@main\u002Fpublic\u002Fdocs\u002FSoundTouchHybridDocumentation.pdf#page=12) for an example.\n    * *NOTE: AirPlay is supported but not as fully tested. In the future I'll spend more time testing and optimizing for AirPlay*\n\n8.\t**Very Important:** Make sure Music Assistant itself can play audio to your speakers and you hear the audio. Do this completely independent of the Bose SoundTouch Hybrid app. Do this for every provider and speaker you add. This way you know Music Assistant is fully working first before proceeding to install\u002Fuse the Bose SoundTouch Hybrid system\n\n### \u003Cimg src=\"public\u002Fimages\u002Fhybrid_icon.png\" width=\"18\"> Setting up SoundTouch Hybrid\n\n⚠️ **Important Upgrade Note For Existing V1 & V2 SoundTouch Hybrid Installations:** V3.4 has significant architectural changes including transitioning to streamlined pre-built Docker image. Because of fundamental changes to the system and file structures, you cannot simply update your existing container. This requires a complete fresh install.\n\nBefore proceeding with the instructions below, please do the following:\n\n   * **Backup Your Data:** Save a copy of your existing `.env`, `library.json` and `speakers.json` files. You need these to reference your specific IPs\u002Fports\u002Fetc configs.\n\n   * **NOTE: It is ok to place the your `.env`, `library.json` and `speakers.json`into the same directory as the yml file. V3.4 is smart enough not to wipe them out and will prompt if your '.env' is outdated**\n\n   * **Destroy the Old System:** Completely stop and remove your old SoundTouch Hybrid container, and delete your old project folder.\n \n   * **Do Not Reuse These Old Files:** The internal structure of the `.env` and `.yml` files have changed. When you deploy V3.4, the system will generate new configuration templates. Copy your IP's, credentials etc from your old backup files into the new files. Do not overwrite the new `.env` file with your old one. You can reuse your `speakers.json` and `library.json` files so after the fresh install just overlay the new same named files in your container directory\n\n#### \u003Cimg src=\"public\u002Fimages\u002Fhybrid_icon.png\" width=\"18\"> **Install Bose SoundTouch Hybrid 2026**\n1. **Create Directory & Download the Compose File:** Create a new folder on your local NAS or server named `bose-soundtouch-hybrid`. Download only the `bose-soundtouch-hybrid.yml` file from this repository and place it inside your new  `bose-soundtouch-hybrid` folder.\n\n2. **Configure Docker Volume Path:** Open `bose-soundtouch-hybrid.yml` and locate the `volumes:` section. Read the instructions and make any required changes to the volumes section depending on your YML deploy method.\n\n3. **Initial Deploy \u002F Template Generation:** Launch the container to generate your configuration files.\n   * NAS\u002FGUI: Import the `bose-soundtouch-hybrid.yml` file into your container manager (like Container Station or Portainer) and deploy.\n   * Command Line: Navigate to your folder and run: `docker compose -f bose-soundtouch-hybrid.yml up -d`\n   * Note: The container will download the image, create the necessary configuration files in your folder, and then pause waiting for you to fill them out.\n   * \u003Cimg width=\"686\" height=\"191\" alt=\"image\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Ff1727099-a2f4-4b94-b884-3a25cb13900c\" \u002F>\n   * Note: The image below shows the end state of a where you config files and logs directory wil be \n   * \u003Cimg width=\"1142\" height=\"316\" alt=\"image\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F0bee4dbf-bece-4a52-a801-10f3e366756d\" \u002F>\n\n\n  \n4. **Configure Your Environment & Speakers:** Navigate to your `bose-soundtouch-hybrid` folder on your server. You will see the automatically generated `.env` and `speakers.json` files.\n   * Edit `.env`: Update it with your local server IP addresses, Music Assistant (MASS) credentials, and port configurations. Replace all placeholders.(Note: Your actual streaming provider passwords are managed inside Music Assistant, not here).\n   * Edit `speakers.json`: Update it with your speakers' names and their static IP addresses. Replace all placeholders.\n   * See Page 15 in the [SoundTouch Hybrid Documentation](https:\u002F\u002Fcdn.jsdelivr.net\u002Fgh\u002FTJGigs\u002FBose-SoundTouch-Hybrid-2026@main\u002Fpublic\u002Fdocs\u002FSoundTouchHybridDocumentation.pdf#page=15) for examples.\n\n5. Restart Appliocation: Once the files are configured restart the container to launch Bose SoundTouch Hybrid 2026\n   * NAS\u002FGUI: Click \"`Restart`\" on the container in your management interface.\n   * Command Line: Run `docker compose -f bose-soundtouch-hybrid.yml restart`\n\n6. **Install the Web App:** Open your mobile browser and navigate to the SoundTouch Hybrid local web address (e.g., http:\u002F\u002F\u003CYOUR_SERVER_IP>:3000\u002Fcontrol.html). Tap **\"Add to Home Screen\"** to install it as a native-feeling app with a launch icon.\n\n7. **Redirect SoundTouch Speakers to Your Local Cloud:** In v3.4 the happens automatically (no more USB hijack) and is noted in the Pre-Flight console logs.\n\n8. **Demo Video Reviews:**\n   *  **Initial V1 Core Functionality: 📺[Bose SoundTouch Hybrid 2026](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=R6mbTRBEBYA)** \n   *  **V2 Enhancements: 📺[V2 Enhancements Bose SoundTouch Hybrid 2026 V2](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=3BhAkpsZjBI)** \n   *  **V3 Enhancements: 📺[V3 Enhancements Bose SoundTouch Hybrid 2026 V3](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ERsoMmyOpEU)**  Review the latest V3 functionality changes and additions.\n\n\n## 🔗 Resources\n\u003Cimg src=\"public\u002Fimages\u002Fhybrid_icon.png\" width=\"18\"> **[Bose SoundTouch Hybrid 2026 - Project Announcement](https:\u002F\u002Fwww.reddit.com\u002Fr\u002Fbose\u002Fcomments\u002F1rdzs7z\u002Fbose_soundtouch_hybrid_2026_official_public\u002F)**\n\n\u003Cimg src=\"public\u002Fimages\u002Fma_icon.png\" width=\"18\"> **Music Assistant:** This project relies on  [Music Assistant](https:\u002F\u002Fmusic-assistant.io\u002F) for backend audio routing and provider aggregation. \n\n**Community Discussions:**\n* **Official Shutdown Discussion:** The original community thread tracking Bose's EOL announcement and API release [Bose EOL Reddit](https:\u002F\u002Fwww.reddit.com\u002Fr\u002Fbose\u002Fcomments\u002F1o2cnhw\u002Fbose_ending_cloud_support_for_soundtouch\u002F).\n* **The Reddit \"Alternative App\" Megathread:** Ongoing conversation about replacing the Bose App. [Bose Alternatives Reddit](https:\u002F\u002Fwww.reddit.com\u002Fr\u002Fbose\u002Fcomments\u002F1o8my2n\u002Fsoundtouch_app_alternatives\u002F).\n* **The Bose Wiki (App Alternatives):** A community-maintained list of current workarounds and projects. [Bose Alternatives Wiki](https:\u002F\u002Fbose.fandom.com\u002Fwiki\u002FSoundTouch_app_alternatives).\n","Bose SoundTouch Hybrid 2026 是一个开源的私有云解决方案，旨在替代即将关闭的Bose Cloud服务，以保持SoundTouch系列智能音箱的全部功能。项目通过本地部署（如NAS、PC等）来模拟Bose Cloud服务，实现无需手机连接即可播放音频的功能，并支持自定义URL流媒体库集成、高级搜索和自动恢复预设等功能。它特别适用于那些希望在Bose官方云服务停止后继续使用SoundTouch设备多房间音频特性的用户。基于Node.js开发，具有良好的稳定性和易用性。",2,"2026-06-11 03:59:44","CREATED_QUERY"]