Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 35 additions & 10 deletions profile/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,25 +7,38 @@ dark. OpenStrap is what I built so a 4.0 band that would otherwise sit in a draw
doing something: read your own data off it over Bluetooth, keep the raw bytes, and turn
them into the numbers you actually look at.

**Everything runs on your phone.** The band talks to the app over Bluetooth, the app
decodes the bytes, computes the metrics, and stores the results locally. There's no
account, no cloud, and no server that ever sees your raw data. That isn't a privacy
setting you switch on — it's the architecture.

Is it a replacement for WHOOP? No, and I'm not going to pretend it is. They've got years
of research and a whole team; this is one person and textbook methods. But it's a real
second life for hardware you already own, and your data stays yours.

Tested on WHOOP 4.0 only. Once you start using it, don't reconnect the band to the
official WHOOP app — a firmware update could change or break the events this relies on.

### Get the app

- **iOS** — [join the TestFlight beta →](https://testflight.apple.com/join/2BVSwq65)
- **Android** — [download the APK →](https://github.com/OpenStrap/edge/releases/latest)

### The pieces

- **[edge](https://github.com/OpenStrap/edge)** — the phone app. Connects to the band,
drains it, shows your day. [Download the APK →](https://github.com/OpenStrap/edge/releases)
- **[backend](https://github.com/OpenStrap/backend)** — the server. Ingests raw frames
and computes everything. One Cloudflare Worker; self-host it or use mine.
- **[analytics](https://github.com/OpenStrap/analytics)** — the math. Published methods
(Banister TRIMP, Cole-Kripke, and friends) turn heart rate and motion into metrics.
- **[edge](https://github.com/OpenStrap/edge)** — the phone app, and where everything
actually happens: Bluetooth, local storage, the compute pipeline, every screen.
- **[protocol](https://github.com/OpenStrap/protocol)** — the decoders. Raw WHOOP 4.0
record bytes into named fields.
- **[research](https://github.com/OpenStrap/research)** — the protocol reference, plus a
client to talk to a band yourself.
record bytes into named fields. Pure Dart, zero dependencies, runs on-device.
- **[analytics](https://github.com/OpenStrap/analytics)** — the math. Published,
peer-reviewed methods (Banister TRIMP, Cole-Kripke, Lomb-Scargle and friends) turn heart
rate and motion into metrics — each carrying its own confidence and tier, and returning
nothing rather than guessing when the data isn't there.
- **[research](https://github.com/OpenStrap/research)** — the lab notebook. The protocol
written down, plus a one-file Python client so you can talk to a band from a terminal.
- **[backend](https://github.com/OpenStrap/backend)** — *optional, and not required.* A
small self-hostable companion for importing an old cloud account and for opt-in
telemetry. The app doesn't need it and doesn't use it by default.

### A few honest notes

Expand All @@ -34,4 +47,16 @@ the protocol — the events especially — is empirical guesswork, and no one pe
confirm it to 100%. The more people poke at it, the closer we get to nailing every field
down with real confidence.

Not affiliated with, endorsed by, or connected to WHOOP. MIT licensed.
The metrics are approximations built from published research, not medical-grade
measurements. Nothing here is a diagnosis.

### Support the work

This is free, MIT-licensed, and has nothing behind it. If it gave your band a second life
and you want to chip in:

- **BTC** — `bc1qvtcch38dcwp967ar764uu6eetw7tf907844wfq`
- **EVM** (ETH / Base / Arbitrum / Polygon) — `0x8310C89393366b7eBCD47ABa82e1dfB5ECeFFbD9`

Not affiliated with, endorsed by, or connected to WHOOP. "WHOOP" is their trademark, used
only to say which device this talks to. MIT licensed.