Skip to content

Export

The Export tab is organized as three small decisions: confirm readiness, choose a destination, then pick the date range before previewing or exporting.

Health badge

A green dot means HealthKit is authorized. A red dot means access is not granted. Tap to retry the iOS permission sheet. The sheet appears only once per installation. After that, open Settings → Privacy & Security → Health.

Vault badge

Green dot = a vault folder is selected. Tap to re-pick or change the vault. The label shows the folder name.

The Export action stays disabled until HealthKit, output format, and the selected destination are ready. This prevents the most common failure mode: trying to export with no destination.

The Export Target card decides where data goes:

Local iPhone Folder

Writes directly into the folder or Obsidian vault you picked on this device.

Connected Mac

Sends captured daily data and an exact settings snapshot to the nearby Mac app. The iPhone reads HealthKit. The Mac renders the selected formats and writes the files.

API Endpoint

POSTs a JSON envelope directly from iPhone to a user-configured HTTP(S) endpoint. See API Endpoint.

Date presets cover the common paths:

Today

Export the current day. Useful for testing output formatting.

Yesterday

The safest daily-export choice because the day is complete.

All Time

Backfill from the earliest HealthKit data Health.md can find.

Custom

Pick start and end dates for a specific range.

Preview

Shows the files and contents that will be generated before anything is written.

Export

Runs the export, shows progress on the main screen, and records the outcome in history.

Summary

Compact daily totals and roll-ups for reading, notes, and dashboards.

Detailed Time-Series

Selected timestamped samples and intervals. This level is available on both Apple and Android when the chosen metric exposes suitable detail.

Lossless Health Records

The canonical HealthKit source-record archive. This level is Apple-only. Android does not turn Health Connect records into a HealthKit archive.

  1. For each day in the range, capture selected summary projections. Add compatible samples for Detailed Time-Series. And, for Lossless Health Records, add canonical source records and query diagnostics.
  2. Apply your chosen format (Markdown, Bases, JSON, or CSV) and template.
  3. Write one file per day into {vault}/{subfolder}/, transfer files through the connected Mac workflow, or POST a versioned JSON envelope to your API endpoint.
  4. If Individual Tracking is on, derive selected per-entry Markdown files from the canonical archive for file-based targets.
  5. If Daily Note Injection is on, merge selected summary fields into your daily notes.

JSON and CSV can preserve canonical records. Markdown and Bases stay readable and expose compact capture diagnostics rather than embedding the archive. See the complete export reference for exact schemas and omission rules.

Stopping or cancelling ends only the current attempt. Files and dates already completed stay completed, while unresolved dates remain available to retry. Cancelling a scheduled attempt does not disable its recurring schedule.

A saved profile freezes its settings and destination for the run. Profile-aware scheduled and automation history rows keep the run-time profile, while history retains a privacy-safe label for the destination actually used. A manual Export-tab row may omit the profile name. Later renames and destination changes do not rewrite existing history. Missing profile references fail closed instead of falling back. See Export profiles.

The four tabs at the bottom of the screen, Export, Schedule, Sync, Settings, cover the entire app surface area. Everything else lives one or two layers deep inside Settings.

Unlock behavior.

On Apple platforms, the free allowance covers 10 manual or scheduled export actions. Full Access removes that limit and unlocks Mac destination workflows and Shortcuts. Android instead offers 10 free manual actions and requires its lifetime unlock for scheduling. See the Paywall page for Apple purchase details.