This project provides a subscription-free alternative for WHOOP 4.0 users by enabling local data computation on iOS and Android devices. It targets users who find their WHOOP hardware unusable without a paid subscription, offering a way to continue leveraging the sensor through reverse-engineered protocols and self-implemented analytics based on published research.

How It Works

The application connects to the WHOOP 4.0 band via Bluetooth, employing a reverse-engineered protocol to extract raw sensor data. This data is then processed locally on the user's smartphone using analytics derived from published research papers, rather than relying on WHOOP's proprietary algorithms. The system architecture comprises a Bluetooth protocol decoder, local data storage, an analytics engine, and a user interface, ensuring all computations and data persistence occur entirely on-device.

Quick Start & Requirements

• Primary install/run command:

  git clone https://github.com/OpenStrap/edge.git
  cd edge
  cp .env.example .env
  flutter pub get
  flutter run --dart-define-from-file=.env
  

• Non-default prerequisites: WHOOP 4.0 band required. iOS or Android device. Sideloading is necessary (APK for Android, unsigned IPA for iOS via guides/IOS_SIDELOAD.md). A Flutter development environment is needed for building. The official WHOOP app must be closed before pairing. iOS users require additional setup for widgets and Live Activities (guides/IOS_INSTALLATION.md).
• Relevant links: Project repository: https://github.com/OpenStrap/edge.git. Protocol repository: https://github.com/OpenStrap/protocol. Analytics repository: https://github.com/OpenStrap/analytics.

Highlighted Details

• Enables full functionality of the WHOOP 4.0 band without requiring a paid subscription.
• All data processing, analytics, and storage are performed locally on the device; no cloud backend is utilized.
• Leverages a reverse-engineered Bluetooth protocol and analytics based on cited, published research methods.
• Supports core health metrics including heart rate, HRV, sleep staging, recovery, strain, stress, and breathing coherence.
• Features auto-detected and live workout tracking with GPS, historical trends, on-device correlation insights, and a deterministic coach.
• iOS users benefit from home-screen widgets, Dynamic Island Live Activities, and Siri shortcuts.

Maintenance & Community

The project encourages bug reporting via GitHub issues and contributions via pull requests. Protocol-level changes should be directed to the separate protocol repository, while metric/formula adjustments belong in the analytics repository. Application-specific issues (Bluetooth, storage, UI) are handled within this repository. No specific community channels (e.g., Discord, Slack) or roadmap details are provided in the README.

Licensing & Compatibility

The project's README does not explicitly state a software license. This omission requires further investigation for determining usage rights, particularly for commercial applications or integration into closed-source projects.

Limitations & Caveats

This application is exclusively for the WHOOP 4.0; compatibility with other models, such as the WHOOP 5, is not guaranteed. The metrics provided are approximations derived from published research and are not medical-grade or clinically validated. Installation requires sideloading, as the app is not available on official app stores. iOS background synchronization is described as "best-effort" due to platform limitations. Users should avoid switching between this app and the official WHOOP app, as firmware updates from the official app could potentially disrupt data compatibility. The project acknowledges the existence of known and unknown bugs.