v1.1.0 — English documentation, honest licensing

Full English documentation, and the licence situation of every bundled library written down honestly.

What you can download

File	What it is
zifferblatt-1.1.0.apk	The example watch face, signed and ready to install

What you have to build yourself, and why

Both remaining apps bundle third-party code whose licence does not allow me to hand you a binary. The source is complete and each has a build.sh that produces a signed APK from the plain Android SDK command line tools.

• herold embeds the Samsung Health Sensor SDK. Samsung's licence says a licensee "must not, directly or indirectly, sell, redistribute, rent, lease, lend or sublicense all or any part of the SDK" (Appendix 1, 3.4), and that before any public release of an app built with it, "Licensee shall obtain prior key signing for the Service from SAMSUNG" (Appendix 1, 4.4(i)). This project has no such agreement, so shipping the APK would breach it. You fetch the SDK yourself, under your own licence with Samsung, and build.
• markt links against gplayapi, which is GPL-3.0. An APK containing it is a combined work and could only be distributed under GPL-3.0 — not under this repository's MIT licence.

Every library and its licence is now listed in DRITTANBIETER.md.

git clone https://github.com/chackrahunter/herold.git
cd herold/herold && ./build.sh --install

What changed since v1.0.0

• All eight documentation pages in English under docs/en/
• A project site built from the docs
• DRITTANBIETER.md — every third-party library with its licence
• Version numbers in all three manifests, so builds can update in place
• Contribution guide, security policy and issue templates
• Test data in the source replaced with generated series — no real measurements from a real person remain

Install

Turn on wireless debugging on the watch, then:

adb connect <watch-ip>:<port>
adb install zifferblatt-1.1.0.apk

If an install fails with Can't install packages while in secure FRP, the watch is in factory reset protection. That blocks every install on an account-less watch and is the most common wall people hit. The fix is one command — see 07 — findings.

./werkzeuge/uhr.sh --id finds the watch over mDNS if you do not know its address.

Please read

• The health measurements are not a medical device. No diagnosis, no condition names, no all-clear. If something feels wrong, see a doctor.
• APKs here are signed with a developer key, not a store key. The watch warns you when installing. That is expected for sideloaded apps.
• A Wear OS system update resets everything: removed bloatware returns, wireless debugging turns off, factory reset protection comes back. Run the scripts again.

Developed and used daily on a Galaxy Watch 6 Classic (SM-R955F) paired to an iPhone 14, Wear OS 4–6. Reports from other models are very welcome.

---

Deutsch

Herunterladen kannst du zifferblatt-1.1.0.apk — das Beispiel-Ziffernblatt, fertig signiert.

Selbst bauen musst du herold und markt. Nicht aus Bequemlichkeit, sondern weil es die Lizenzen nicht anders zulassen: herold bindet das Samsung Health Sensor SDK ein, dessen Lizenz die Weitergabe verbietet und für Apps, die es nutzen, vorher Samsungs Zustimmung verlangt. markt bindet gplayapi ein, das unter GPL-3.0 steht — eine fertige APK wäre ein verbundenes Werk und dürfte nicht unter der MIT-Lizenz dieses Repos weitergegeben werden. Der Quelltext ist vollständig, jedes build.sh erzeugt in einem Durchlauf eine signierte APK. Alle Bibliotheken samt Lizenz stehen in DRITTANBIETER.md.

Neu gegenüber v1.0.0: alle acht Doku-Seiten auf Englisch, eine Projektseite, Versionsnummern in den Manifesten, Beitrags- und Sicherheitshinweise, Vorlagen für Fehlerberichte — und im Quelltext stehen keine echten Messreihen einer realen Person mehr.

Wichtig: Die Gesundheitsmessungen sind kein Medizinprodukt — keine Diagnose, keine Entwarnung. Nach einem Wear-OS-Update sind alle Eingriffe zurückgesetzt.

v1.0.0 — Galaxy Watch am iPhone, ohne Google-Konto

Erste Veröffentlichung.

Was drin ist

• herold/ — Benachrichtigungen per ANCS direkt vom iPhone, dazu EKG, Puls & Rhythmus, SpO₂, Hauttemperatur, Körperanalyse, Atemfrequenz und Pulsankunftszeit; Kacheln, Verlauf, Hintergrundmessungen
• markt/ — App-Laden ohne Google-Konto (anonyme Play-Anmeldung), zeigt gezielt nur Wear-OS-Apps
• zifferblatt/ — vollständiges Beispiel-Ziffernblatt
• werkzeuge/ — adb-Helfer, umkehrbares Entrümpeln, App-Installation

Doku
Acht Seiten, darunter die Einrichtung ohne Samsung-Handy und die gesammelten Erkenntnisse (Werksschutz-Modus als Installationssperre, unsichtbare Dienst-Benachrichtigung, warum ein fremdes iPhone die Uhr nicht findet).

Alles ohne Gradle gebaut. Getestet auf Galaxy Watch 6 Classic (SM-R955F) an einem iPhone 14.