a9eelsh/heliocore

★ 13SwiftAudience · developerComplexity · 3/5Setup · hard

Mindmap

mindmap
  root((repo))
    What It Does
      Helio wearable reader
      Bypass Zepp cloud
      Local biometric data
    Live Data Streams
      Heart rate
      Blood oxygen
      Stress and HRV
    How It Works
      Zepp API auth token
      Bluetooth handshake
      On-device decoding
    Audience
      Data privacy users
      Wearable developers
    Requirements
      Zepp account
      Paired Helio device

mindmap root((repo)) What It Does Helio wearable reader Bypass Zepp cloud Local biometric data Live Data Streams Heart rate Blood oxygen Stress and HRV How It Works Zepp API auth token Bluetooth handshake On-device decoding Audience Data privacy users Wearable developers Requirements Zepp account Paired Helio device

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Stream live heart rate, blood oxygen, and stress readings from your Helio wearable to your iPhone or Mac without any cloud dependency.

USE CASE 2

Build a custom health app on Apple platforms that pulls biometric data directly from Huami-family devices over Bluetooth.

USE CASE 3

Study how Zepp's authentication and Bluetooth encryption protocol works as a starting point for supporting other devices in the same family.

Tech stack

SwiftBluetoothZepp API

Getting it running

Difficulty · hard Time to first run · 1h+

No build instructions in the README, requires a valid Zepp or Huami account, a paired Helio device, and manual Xcode setup.

In plain English

HelioCore is an open-source iOS and macOS app that lets you read health data directly from a Helio Smart Strap, a fitness wearable that belongs to the Zepp and Huami family of devices. The app is built in Swift and bypasses the official Zepp app and cloud dashboard entirely, streaming your biometric data straight to your Apple device over Bluetooth. The way it works: you enter your Zepp or Huami account credentials into the app, which contacts the official Zepp API to fetch your account's authentication token and encryption key. The app then uses those credentials to connect to your Helio wearable over Bluetooth and perform the encrypted handshake the device expects. Once connected, it reads the raw data streams coming from the hardware and decodes them on the spot, displaying live readings for heart rate, heart rate variability, blood oxygen saturation, skin temperature, and stress level. The project is built for people who want to own their biometric data rather than routing it through a proprietary cloud service. All credential handling and data processing happens on your Apple device and never leaves it beyond the initial authentication call to Zepp's own servers. The app does not collect or share any personal data. The README is brief and does not include build instructions or an App Store link. It references two open-source projects that provided the Zepp authentication logic and Bluetooth protocol details used to build HelioCore. A valid Zepp or Huami account paired with a Helio device is required.

Copy-paste prompts

Prompt 1

I have a Helio Smart Strap and a Zepp account. Walk me through how HelioCore authenticates with the Zepp API, performs the Bluetooth handshake, and starts streaming heart rate data to my iPhone.

Prompt 2

I want to add support for a new Huami-family wearable to HelioCore. The two open-source projects referenced in the README provided the Zepp auth logic and Bluetooth protocol, how do I adapt those to a different device model?

Prompt 3

Show me how HelioCore decodes the raw Bluetooth data stream from the Helio device into a heart rate variability reading. Which part of the code handles the decryption and parsing?

Open on GitHub → Explain another repo

← a9eelsh on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.