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

Files

T

86825c44af feat(backup): add soundtouch-backup tool for cloud and local speaker backup (#197 )

Introduces a standalone `soundtouch-backup` CLI with three subcommands:
- `all`: authenticates with the Bose cloud, backs up account data, then
reads device IPs from devices.xml and backs up each reachable speaker
- `cloud`: fetches account profile, devices, sources, presets, and full
endpoint from streaming.bose.com
- `local`: backs up each speaker via HTTP API (12 endpoints) and
optionally via SSH (individual files + /opt/Bose/etc/ and
/mnt/nv/BoseApp-Persistence/1/ directories)

Also centralises pkg/service/ssh → pkg/ssh so both the service and the
backup tool share the same SSH client; adds ReadFile and ReadDir
methods, and handles the firmware quirk where cat exits 1 on empty
files.

Output is a single dated .tar.gz or .zip archive.

Example flow:

```shell
gesellix@Mac Bose-SoundTouch % go run ./cmd/soundtouch-backup all --output _/cloud-backup --email user@example.com
Password: 
Authenticating as user@example.com...
  ✓ Authenticated (account ID: 1234567)
  ✓ email address (107 bytes)
  ✓ devices (1492 bytes)
  ✓ sources (1111 bytes)
  ✓ presets (2585 bytes)
  ✓ full account (55037 bytes)
Found 2 device(s) in cloud account, attempting local backup...
  ✓ ST20: 12 files via HTTP
  ⚠ ST20: SSH skipped /etc/remote_services (Process exited with status 1)
  ⚠ ST20: SSH empty file /mnt/nv/remote_services
  ✓ ST20: 64 files via SSH
  ✓ ST10: 12 files via HTTP
  ⚠ ST10: SSH empty file /etc/remote_services
  ⚠ ST10: SSH skipped /mnt/nv/remote_services (Process exited with status 1)
  ✓ ST10: 48 files via SSH
Archive written: _/cloud-backup/soundtouch-backup-2026-05-02.tar.gz (141 files)
```

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-02 14:00:23 +02:00

4.8 KiB

Raw Blame History

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.

4.8 KiB Raw Blame History