Skip to content

Add speaker setup, Spotify, and architecture documentation#179

Open
timvw wants to merge 1 commit intodeborahgu:mainfrom
timvw:pr/documentation
Open

Add speaker setup, Spotify, and architecture documentation#179
timvw wants to merge 1 commit intodeborahgu:mainfrom
timvw:pr/documentation

Conversation

@timvw
Copy link
Contributor

@timvw timvw commented Feb 17, 2026

Summary

Adds three documentation files covering real-world deployment knowledge from a SoundTouch 20 (firmware 27.0.6).

Closes #172, #173, #174

Files

docs/speaker-setup.md (closes #172)

  • SSH access on firmware 27.x (USB stick method — the old TAP command is removed)
  • macOS junk file gotchas (.fseventsd, .Spotlight-V100)
  • Making SSH persistent (/mnt/nv/remote_services)
  • Extracting speaker data (port 8090 API vs SSH)
  • Redirecting speaker to soundcork (editing SoundTouchSdkPrivateCfg.xml)
  • Warnings: TAP console dangers, read-only filesystem

docs/spotify.md (closes #173, relates to #159)

  • Two Spotify systems explained (Spotify Connect vs SoundTouch integration)
  • Spotify preset fix: kick-start via Spotify Connect
  • Why it works (ZeroConf authentication, session in RAM)
  • Traffic analysis evidence
  • Preset management via local API (port 8090)

docs/architecture.md (closes #174)

  • Bose server status as of February 2026 (BMX/updates already 404ing, marge alive)
  • Shutdown date: May 6, 2026 (extended from Feb 18)
  • Links to official Bose EOL page and published API docs
  • Local vs proxy mode explanation
  • Circuit breaker design
  • Data flow diagrams (power-on, TuneIn playback, Spotify)

- speaker-setup.md: SSH on fw 27.x, data extraction, speaker redirect
- spotify.md: Connect vs SoundTouch Spotify, preset kick-start fix
- architecture.md: Bose server status, proxy modes, circuit breaker, data flows

Closes deborahgu#172, closes deborahgu#173, closes deborahgu#174
@colinmacgiolla
Copy link

Just worth noting as I used it today, Wi-Fi vs. Wired is not a factor.

It's very fussy about the USB stick. 8GB / FAT32 / remote_services file only failed, 1GB / FAT32 / remote_services file only succeeded.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants