mirror of https://github.com/gesellix/Bose-SoundTouch.git synced 2026-08-18 16:46:17 +00:00

Files

T

Tobias GesellchenandClaude Sonnet 4.6 3891c08dd1 docs(migration): add Docker Compose quickstart with .env config guidance

Adds a "Docker Compose (recommended for home servers and VMs)" section
to Step 1, pointing users to the existing docker-compose.yml and
.env.example. Clarifies the purpose of docker-compose.ci.yml (CI tests
only) and docker-compose.override.yml (local modifications, not in VCS).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-03 21:36:34 +02:00

analysis

feat(android): scripted MITM setup with emulator snapshot and Frida SSL unpinning

2026-05-02 18:08:39 +02:00

README.md

Bose SoundTouch Toolkit Documentation

Welcome to the documentation for the Bose SoundTouch Toolkit. This comprehensive toolkit helps you keep your Bose SoundTouch speakers functional even after the Bose Cloud shutdown in May 2026, with enhanced local management and monitoring capabilities.

🚀 Start Here

For New Users

Complete Migration Guide - Step-by-step guide from Bose Cloud to local control
Getting Started - Quick introduction to the toolkit

For Existing Users

Cloud Shutdown Survival Guide - Prepare for the May 2026 shutdown
Backup Tool - Back up your cloud account and speaker data before shutdown
SoundTouch Service Guide - Advanced service configuration

📋 Essential Documentation

The documentation is organized into three main categories:

1. User Guides - For everyday users migrating and managing devices

2. Technical Reference - For developers and advanced configuration

3. Concept Documentation - For contributors and system architects

🗂 Documentation Structure

🗂 User Guides

Migration & Setup

Complete Migration Guide - 📖 Main guide for migrating from Bose Cloud
Cloud Shutdown Survival Guide - Prepare for service shutdown
Migration & Safety Guide - Advanced migration strategies
Initial Device Setup - First-time device configuration
Raspberry Pi Setup - Installing on Raspberry Pi

Daily Management

SoundTouch Service Guide - Service operation and maintenance
Troubleshooting - Common issues and solutions
HTTPS Setup - Secure connections
Deployment Guide - Production deployments

Advanced Features

MAC Address Mapping - Device identification
CLI Reference - Command-line tools
Backup Tool - Cloud account and speaker data backup
IoT Implementation Guide - IoT integrations
MQTT Integration Design - MQTT setup

📚 Technical Reference

API Documentation

API Endpoints - REST API reference
Spotify Account Addition - Technical requests for Spotify
WebSocket Events - Real-time events
Zone Management - Multi-room control
Preset Management - Preset operations

Analysis & Research

Upstream URLs - Bose service endpoints
Device Redirect Methods - Migration techniques
IoT Configuration Analysis - Device configurations
IoT Config Summary - Configuration summaries

Device Lifecycle & Network Independence

Device Lifecycle and /power_on Enhancement - Complete analysis of device registration and network independence improvements
/power_on Implementation Guide - Technical implementation details for enhanced device management

🏗 Concept Documentation

Enhanced Service Architecture

Concept Overview - High-level architecture vision
Upstream Service Simulation - Complete concept design
Implementation Plan - Development roadmap
Technical Specification - Detailed specifications

Development Planning

Implementation Roadmap - Project phases and milestones

💡 Quick Reference

Common Tasks

Migrate first device: Follow Migration Guide Step 5
Check device health: Dashboard → Devices → [Device Name] → Health Status
Backup configuration: Dashboard → Settings → Backup → Create Backup
Add new device: Dashboard → Devices → Discover Devices → Register

Getting Help

Issues & Bugs: GitHub Issues
Questions & Discussion: GitHub Discussions
Documentation: Check troubleshooting guides first
Community: Share experiences and help others

For a complete list of all documents, see the Summary.