zhoop README

The project's README from github.com/hackyguru/zhoop. As one markdown file: README.md.

Zhoop

Zhoop

A WHOOP companion for iPhone, built around one goal: losing weight.

A personal fork of NOOP. Offline, on-device, no account, no cloud.


Why this fork exists

NOOP is an excellent open-source, local-first app for WHOOP straps: it pairs over Bluetooth, keeps everything on your device, and computes recovery, strain, HRV and sleep itself. It shows a lot.

I forked it to cater to my own fitness needs. I'm on a calorie deficit, working out, and trying to get from where I am to a goal weight by a date. I wanted the app to answer one question every day: how much can I eat today, and am I on track? So Zhoop strips the app down to that and adds the weight-loss pieces NOOP doesn't have.

What's different from NOOP

Today is rebuilt around the deficit:

Built for someone without a scale:

And less of everything else:

The Bluetooth, strap protocol, storage, sleep staging and heart-rate calorie model are NOOP's, unchanged.

Status

This is a personal build for my iPhone and my WHOOP 5.0 / MG. The Mac and Android apps from NOOP are still in the repository but have not been reworked beyond the name. Everything is an estimate, not medical advice.

Build and run on an iPhone

Needs a Mac with Xcode and XcodeGen.

  1. cp Config/BundleIdSecrets.example.xcconfig Config/BundleIdSecrets.xcconfig, then set your own BUNDLE_ID_PREFIX and DEVELOPMENT_TEAM in it. That file is gitignored.
  2. xcodegen generate
  3. Open Strand.xcodeproj, choose the NOOPiOS scheme and your iPhone, and run.

Pairing a WHOOP 5.0 / MG needs the strap freed from the official WHOOP app first; see docs/IOS.md and the pairing notes in NOOP's README.

Credit

All the hard work under the hood belongs to NOOP and its contributors: github.com/ryanbr/noop. NOOP in turn builds on johnmiddleton12/my-whoop and b-nnett/goose; see ATTRIBUTION.md and NOTICE.

The documents in docs/, CHANGELOG.md and the contributor guides are NOOP's own and describe NOOP. They're kept as they are.

License

Zhoop is a fork of NOOP and stays under NOOP's license, PolyForm Noncommercial 1.0.0: free for noncommercial use.

Required Notice: Copyright 2026 NoopApp

Zhoop is not affiliated with, endorsed by, or connected to WHOOP, Inc. or the NOOP project. "WHOOP" is used only to identify the hardware the app works with.

zhoop (hackyguru/zhoop)

personal
Searching Database…

269 ·GitHub
What is this?Zhoop is an iPhone app that pairs with a WHOOP fitness strap over Bluetooth and tracks your daily calorie deficit, weight-loss goal, sleep and heart rate. It's a personal fork of the NOOP app, stripped down and rebuilt entirely around hitting a goal weight by a date.
How do I build and run it?Copy Config/BundleIdSecrets.example.xcconfig to BundleIdSecrets.xcconfig and set your own bundle ID prefix and dev team, run 'xcodegen generate', then open Strand.xcodeproj, pick the NOOPiOS scheme and your iPhone, and run.
What do I need before I can build it?A Mac with Xcode and XcodeGen, and a WHOOP 5.0 or MG strap that has first been unpaired/freed from the official WHOOP app.
Is this a polished app for any WHOOP owner?No — it's a personal build tuned for the author's own iPhone and WHOOP 5.0/MG strap. The Mac and Android apps carried over from NOOP haven't been reworked beyond the name, and all numbers are estimates, not medical advice.
Why did the author fork NOOP instead of just using it?NOOP shows a lot of WHOOP metrics but nothing for weight loss. The author wanted the app to answer one question daily — how much can I eat and am I on track — so Zhoop strips NOOP down and adds deficit tracking, a food log and a goal planner.
How does it estimate my weight if I don't own a scale?It computes an estimated weight day by day from your logged calorie deficit, and you can overwrite it with a real weigh-in at any time to restart the calculation.
What is the 'logging buffer'?An adjustable multiplier (default +10%) applied to every logged calorie, since most people under-log what they actually eat.
What parts still come straight from NOOP unchanged?The Bluetooth pairing, strap protocol, local storage, sleep staging and heart-rate calorie model are all carried over from NOOP without modification.
Creator
hackyguru
Size
193.3 MB
Stars
269
Updated
CommitSep 28
Age
23d
Commits · 90 Days