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)

Searching Database…

274 ·GitHub
这是什么?Zhoop 是一款 iPhone 应用,通过蓝牙与 WHOOP 健身手环配对,跟踪你每日的热量缺口、减重目标、睡眠和心率。它是 NOOP 应用的个人 fork,经过精简并以“在截止日期前达到目标体重”为核心彻底重构。
怎么构建并运行它?把 Config/BundleIdSecrets.example.xcconfig 复制为 BundleIdSecrets.xcconfig,设置你自己的 bundle ID 前缀和开发团队,运行“xcodegen generate”,然后打开 Strand.xcodeproj,选择 NOOPiOS scheme 和你的 iPhone,点击运行。
构建之前我需要准备什么?一台装有 Xcode 和 XcodeGen 的 Mac,以及一条先在官方 WHOOP 应用中解除配对/解绑的 WHOOP 5.0 或 MG 手环。
这是一个适合任何 WHOOP 用户的成熟应用吗?不是——这是一个为作者自己的 iPhone 和 WHOOP 5.0/MG 手环调校的个人版本。从 NOOP 沿用过来的 Mac 和 Android 应用除了名字之外没有做过改造,而且所有数字都只是估算,不构成医疗建议。
作者为什么 fork NOOP 而不是直接用它?NOOP 展示很多 WHOOP 指标,却完全没有减重相关的内容。作者希望应用每天回答一个问题——我能吃多少、进度是否正常——所以 Zhoop 精简了 NOOP,并加入缺口跟踪、饮食记录和目标规划。
如果我没有体重秤,它怎么估算我的体重?它根据你记录的热量缺口逐日推算出估算体重,你可以随时用一次真实称重覆盖它,从而重新开始计算。
“记录缓冲”(logging buffer)是什么?一个应用于每条热量记录的可调乘数(默认 +10%),因为大多数人记录的热量都比实际吃的少。
哪些部分仍然原封不动地来自 NOOP?蓝牙配对、手环协议、本地存储、睡眠分期和心率热量模型全部原样沿用自 NOOP,未经修改。
Creator
hackyguru
Size
193.3 MB
Stars
274
Updated
CommitSep 28
Age
24d
Commits · 90 Days