mirror of
https://github.com/gesellix/Bose-SoundTouch.git
synced 2026-08-18 16:46:17 +00:00
Add three new entries to docs/guides/TROUBLESHOOTING.md so the next reporter who hits these symptoms finds the answer without needing the issue thread. - "Every cloud source shows status=UNAVAILABLE / can't stream anything" (Connection Issues). Three-step diagnostic checklist: :443 reachability preflight, margeAccountUUID check, filtered `logread -f`. Distilled from the diagnostic ping on #224 plus Thatboioofy's resolution (missing margeAccountUUID was the cause). Sidebar clarifies that the firmware-internal placeholder sources (SpotifyConnectUserName, SpotifyAlexaUserName, UPnPUserName, StoredMusicUserName, QPlay{1,2}UserName, AirPlay2DefaultUserName) are speaker-synthesized and their UNAVAILABLE status is never an AfterTouch problem on its own. - New section "Music Service & Preset Issues" with "Spotify preset fails with 'Current content cannot be saved as preset'". Explains the firmware-side isPresetable="false" gate on Connect-pushed playback (foob61451's NowPlaying capture in #235), why an OAuth-linked account flips it to true, and cross-links to MUSIC-SERVICES.md and the new spotify-overview.md. - "TuneIn (or Internet Radio) missing from /sources after a factory reset". TuneIn is not a default source; the speaker only registers it after first play. Captured from the #253 side-thread with both app and `soundtouch-cli source content` recipes plus the no-SSH caveat for newer hardware (SA-5). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>