mirror of https://github.com/gesellix/Bose-SoundTouch.git synced 2026-08-24 14:47:23 +00:00

Files

T

Tobias GesellchenandClaude Opus 4.7 51d196dd03 docs: replace personal LAN IPs and device names with placeholders

Public-repo hygiene: docs and READMEs carried the maintainer's home
LAN range (192.168.178.x) and personal speaker names ("Sound
Machinechen", "A Sound Machine"). Swapped to RFC-5737 documentation
IPs (192.0.2.x — reserved for examples, won't collide with anyone's
real network) and generic names ("Living Room SoundTouch",
"Kitchen SoundTouch").

12 files touched, all .md / .txt documentation. No code or tests
changed in this commit; subsequent commits will address the
docs/analysis/ANONYMIZATION-SUMMARY.md mapping log and the wider
real-MAC/real-account-ID footprint surfaced by the audit at
_/RFC-5737-cleanup/assessment.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-17 22:05:13 +02:00

3.1 KiB

Raw Permalink Blame History

Device Customization Setup Guide

This guide documents the manual steps required to configure your Bose SoundTouch device for customization using the SoundCork approach.

Based on: https://github.com/deborahgu/soundcork

Overview

SoundCork allows you to customize your SoundTouch device by intercepting and modifying its firmware update process. This requires specific manual configuration steps to prepare your device.

Prerequisites

Bose SoundTouch device
Network access to device
Administrative access to your router/network

Configuration Steps

Step 1: Prepare USB Drive

Insert USB stick into computer
Create remote services file: touch /path/to/mounted/usb/root-directory/remote_services

Step 2: Connect to Device

Insert USB stick into SoundTouch 20 device
Restart device (unplug power, plug it back in)

Step 3: Access Device via SSH or Telnet

After the restart, remote access is enabled.

Option A: SSH

SSH access: ssh -oHostKeyAlgorithms=ssh-rsa root@<device-ip>
Device will show network interfaces and system info
No password required for root access

Example output:

gesellix@Mac Bose-SoundTouch % ssh -oHostKeyAlgorithms=ssh-rsa root@<device-ip>
Last login: Sun Feb  1 19:12:47 2026
eth0      Link encap:Ethernet  HWaddr CA:FE:BA:BE:A3:25
          inet addr:<device-ip>  Bcast:0.0.0.0  Mask:255.255.255.0
lo        Link encap:Local Loopback
          inet addr:127.0.0.1  Mask:255.0.0.0
usb0      Link encap:Ethernet  HWaddr CA:FE:BA:BE:1E:47
          inet addr:123.12.123.12  Bcast:0.0.0.0  Mask:255.255.255.252

Sun Feb  1 20:35:24 CET 2026

Device name: "Kitchen SoundTouch"
Country EU, Region (not set)
Module type: scm
root@spotty:~#

Option B: Telnet via Docker

If you don't have a telnet client installed, you can use Docker:

docker run --rm -it alpine:edge ash -c 'apk add -U inetutils-telnet && telnet <device-ip> 23'