Skip to content

About

Remote Control for Toniebox 2 via Teddiecloud

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

TeddyRemote

TeddyRemote ist eine moderne native Android-App zur Fernsteuerung von Toniebox-2-Geräten über TeddyCloud. Die App gibt selbst kein Audio wieder: Sie zeigt den aktuellen Zustand der Boxen an und sendet Steuerbefehle über die TeddyCloud-API.

Funktionsumfang

  • adaptive TB2-Karten mit Boxname, Boxbild, Onlinezustand und „Zuletzt gesehen“
  • Akku-, Kopfhörer- und sekundengenauer Bedtime-Status
  • physischer Tonie mit Bild, optionaler RUID, Titel, Kapitel und Laufzeit
  • Previous, Play/Pause, Next und Kapitelauswahl
  • Lautstärkeregelung von 1 bis 12
  • Bedtime starten, neu setzen oder abbrechen, die Bedtime-Ringhelligkeit steuern sowie bestätigt zweistufig schlafen legen
  • optionale Ringhelligkeit
  • Android-Mediensteuerung für aktive TB2 – ohne lokale Audiowiedergabe
  • mehrere speicherbare TeddyCloud-/MQTT-Verbindungsprofile
  • automatischer Reconnect mit begrenzbarem exponentiellem Backoff
  • Livezustände über einen externen MQTT-Broker; API-Polling als Fallback
  • lokaler Cache für Box- und Toniebilder
  • Light-, Dark- und System-Theme

TeddyRemote unterstützt ausschließlich Toniebox 2. TB1-Geräte werden bewusst nicht angezeigt.

Screenshots

Boxübersicht Einstellungen
TeddyRemote Boxübersicht TeddyRemote Einstellungen
Player Sperrbildschirm
TeddyRemote Player TeddyRemote Sperrbildschirm

Voraussetzungen

  • Android 10 oder neuer (minSdk 29)
  • TeddyCloud mit TB2-Live-State- und Control-API
  • Netzwerkzugriff des Android-Geräts auf TeddyCloud
  • optional: ein externer MQTT-3.1.1-Broker für schnelle Live-Updates

Der unter MQTT und Home Assistant konfigurierte TeddyCloud-MQTT-Client veröffentlicht Zustände an den externen Broker. Der interne ICI-MQTT-Server (mqtt_server.*) ist dafür ausdrücklich nicht vorgesehen.

TeddyRemote abonniert:

<prefix>/status
<prefix>/box/+/+

Ohne MQTT bleibt die App über angepasstes API-Polling nutzbar. MQTT reduziert die Verzögerung und vermeidet unnötige Abfragen.

Verbindung einrichten

Beim ersten Start wird ein Serverprofil angelegt. Erforderlich ist mindestens die TeddyCloud-Basis-URL, zum Beispiel:

https://192.168.1.100:8443/

192.168.1.100 ist nur eine neutrale Beispieladresse und muss durch die tatsächliche Adresse des eigenen TeddyCloud-Hosts ersetzt werden.

Ein Profil kann zusätzlich Host, Port, Prefix, TLS, Benutzername und Passwort des externen MQTT-Brokers enthalten. API und MQTT lassen sich im Profildialog getrennt prüfen.

Die App enthält unter Einstellungen → Anleitungen → MQTT-Server konfigurieren eine lokale HTML-Anleitung für einen kleinen TLS-gesicherten Mosquitto-Broker. Sie wird direkt im installierten Browser geöffnet und benötigt keine Internetverbindung.

Projektstruktur

app/src/main/java/de/teddycloud/teddyremote/
├── data/        Profile und verschlüsselte Zugangsdaten
├── model/       Verbindungs-, API- und UI-Modelle
├── mqtt/        MQTT-Verbindung und Topic-Auswertung
├── network/     TeddyCloud-API und TLS-Fingerprint-Pinning
├── repository/  Zustandszusammenführung, Polling und Reconnect
├── service/     Foreground-Service und Android-MediaSessions
└── ui/          Jetpack-Compose-Oberfläche

Die App verwendet Kotlin, Jetpack Compose, Material 3, Retrofit/OkHttp, Kotlin Serialization, HiveMQ MQTT Client, DataStore, Coroutines/StateFlow und Coil.

Lokaler Build

Benötigt werden:

  • JDK 17
  • Android SDK 36
  • Android Build Tools und Platform Tools

PowerShell:

$env:JAVA_HOME='C:\Program Files\Eclipse Adoptium\jdk-17.0.19.10-hotspot'
./gradlew.bat test
./gradlew.bat lint
./gradlew.bat assembleRelease

Die APK entsteht unter:

app/build/outputs/apk/release/app-release.apk

Release-Signatur

Die Signaturdaten liegen absichtlich außerhalb des Projekts unter:

%USERPROFILE%\.teddyremote\signing.properties

Ein lokaler Keystore kann vorbereitet werden mit:

./scripts/prepare-signing.ps1

Fehlt die externe Release-Konfiguration, signiert Gradle den lokalen Release-Build zu Entwicklungszwecken mit der Debug-Signatur. Keystore und Passwörter dürfen nicht in das Projekt übernommen werden.

Sicherheit und Datenschutz

  • MQTT-Passwörter werden per AES-GCM mit einem nicht exportierbaren Android-Keystore-Schlüssel verschlüsselt.
  • Selbst signierte API- und MQTT-Zertifikate müssen anhand ihres SHA-256-Fingerprints bestätigt werden.
  • Bestätigte Fingerprints werden pro Profil gepinnt. Ein Zertifikatswechsel blockiert die Verbindung bis zur erneuten Bestätigung.
  • HTTP bleibt für lokale Testsysteme möglich, wird aber deutlich als unverschlüsselt markiert.
  • Zugangsdaten und Zertifikatsinhalte werden nicht protokolliert.
  • Die App besitzt keine Audio-Engine, fordert keinen Audiofokus an und spielt keine lokalen Audiodateien ab.

Entwicklungsstatus

0.1.33

  • Einstellungen → Updates prüft auf Knopfdruck die neueste reguläre GitHub-Release von Netfreak25/TeddyRemote. Es gibt keine automatische Suche, keinen Hintergrunddienst und keine automatischen Installationen.
  • Nur die eindeutig zugehörige Release-APK wird angeboten. Download über WLAN mit normaler HTTPS-Zertifikatsprüfung; vollständige Größe und eine vorhandene GitHub-SHA-256-Prüfsumme werden geprüft. Vor Installation müssen Paketname, höhere Versionsnummer, Release-Status und Signaturidentität zur installierten App passen.
  • Nach Herunterladen folgt Installieren und die Bestätigung im Android-Systemdialog. Falls nötig, zuerst Installation erlauben freigeben und danach nochmals Installieren wählen. Bestehende App-Daten bleiben bei einem Update erhalten. Android prüft die APK zusätzlich; Ablehnung und Abbruch werden angezeigt.
  • Debug-Installationen sind vom Updater ausgeschlossen. Suche und Download benötigen WLAN, aber keine aktive TeddyCloud-Verbindung. Abgebrochene Downloads werden nicht fortgesetzt; temporäre Update-Dateien werden bei der nächsten Prüfung bereinigt.

Technische Grundlagen: GitHub Releases API, Android PackageInstaller. Die Installationsfreigabe und der echte Systemdialog erfordern eine separate Geräteabnahme; ein erfolgreicher Build ersetzt diese nicht.

0.1.32

  • Beim MQTT-Wechsel der RUID oder Contentversion wird die Metadatenrevision des vorherigen Inhalts verworfen. Die passende neue Playlist kann direkt übernommen werden, ohne auf den nächsten Box-Zustandsabgleich zu warten. Wiederholte Identitätsmeldungen und Kapitelwechsel behalten die aktuelle Revision.
  • Native Playlists sind versionsgebunden; dezimale Kapiteldauern bleiben intern millisekundengenau. Nachgelieferte Metadaten werden über ihre Revision erkannt, und vollständig bekannte Dauern ergeben eine Gesamtzeit. Die Intro-/Outro-Heuristik wird auf native Collections nicht angewendet.

0.1.31

  • Unter Einstellungen → Darstellung lässt sich Fehlendes Intro und Outro ergänzen aktivieren (standardmäßig aus). Nur wenn die bekannte Kapitelzahl genau zwei größer als die vollständige Namensliste ist, nimmt TeddyRemote ein Intro und ein Outro an.
  • Die Umschaltung wirkt sofort auf geladene Playlists in App und Android-Mediensteuerung, ohne erneute Netzwerkanfrage. Kapitelindizes, Seek-Ziele und gespeicherte Positionen bleiben unverändert.
  • Dauern bleiben den tatsächlichen Kapiteln zugeordnet. Verkürzte Dauerlisten werden nicht verschoben; stattdessen gelten Kapitelstarts und, für das letzte Kapitel, die Gesamtdauer. Fehlen belastbare Zeitdaten, bleibt die Anzeige —.

0.1.30

  • Übersicht zeigt spielende Onlineboxen zuerst, danach weitere Onlineboxen und Offlineboxen nach letztem Kontakt. Offlinekarten sind standardmäßig kompakt und lassen sich durch Antippen aufklappen.
  • Verbinden/Trennen ist direkt in der Übersicht verfügbar. Serverprofile mit API-/MQTT-Details befinden sich zusammen mit der separaten WLAN-Anzeige in den Einstellungen.
  • Die Tonie-ID ist auf Boxkarten standardmäßig verborgen und lässt sich unter Darstellung einblenden. Der Wiedergabeverlauf ist einklappbar und nach Name oder ID durchsuchbar.
  • Kapitelzuordnung und Dauern werden unabhängig von Figurennamen aufgelöst. Die letzte TAF-Dauer benötigt explizite Kapiteldauern oder das additive API-Feld totalSeconds; ohne diese Daten erscheint —.
  • Beenden stoppt Verbindungen und Mediensteuerungen. Beim nächsten bewussten App-Start gilt wieder die gespeicherte Autostartoption; normales Trennen löst keinen automatischen Wiederaufbau durch einen Seitenwechsel aus.

Die separate TeddyCloud-API-Anleitung beschreibt die noch serverseitig erforderliche Ergänzung. TeddyRemote spielt weiterhin selbst kein Audio ab.

TeddyRemote befindet sich in aktiver Entwicklung. Die App setzt die im verwendeten TeddyCloud-TB2-Branch bereitgestellten Zustands- und Steuerendpunkte voraus; andere TeddyCloud-Versionen können noch nicht alle angezeigten Funktionen liefern.

About

Remote Control for Toniebox 2 via Teddiecloud

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages