Getting Started

Installation

Quick install (recommended)

curl -fsSL https://healthsync.sidv.dev/install | bash

Downloads the latest release for your platform (macOS and Linux, arm64 and amd64) and installs to /usr/local/bin.

Manual download

Download a pre-built binary for your platform from GitHub Releases:

Platform	Architecture	Download
macOS	Apple Silicon	`healthsync-darwin-arm64.tar.gz`
macOS	Intel	`healthsync-darwin-amd64.tar.gz`
Linux	ARM64	`healthsync-linux-arm64.tar.gz`
Linux	x86_64	`healthsync-linux-amd64.tar.gz`

Extract and install:

tar -xzf healthsync-darwin-arm64.tar.gz
sudo mv healthsync /usr/local/bin/

With `go install`

go install github.com/BRO3886/healthsync@latest

From source

git clone git@github.com:BRO3886/healthsync.git
cd healthsync
go build -o healthsync .

Export your Apple Health data

Open the Health app on your iPhone
Tap your profile picture (top right)
Scroll down and tap Export All Health Data
Wait for the export to complete (can take a few minutes)
Share the export.zip file to your Mac

Parse the export

healthsync parse export.zip

This will:

Extract export.xml from the zip
Stream-parse ~500k+ records in constant memory
Store data in ~/.healthsync/healthsync.db
Deduplicate on re-import (safe to run weekly)

Use -v for verbose output with progress rate:

healthsync parse export.zip -v

Query your data

# Recent heart rate
healthsync query heart-rate --limit 10

# Steps in a date range
healthsync query steps --from 2024-01-01 --to 2024-06-30

# Workouts as JSON
healthsync query workouts --format json

# All available tables
# heart-rate, steps, spo2, vo2max, sleep, workouts

Override database path

All commands accept --db to use a custom database location:

healthsync parse export.zip --db ./my-health.db
healthsync query heart-rate --db ./my-health.db