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

Green shows the app's Connected setup state, not confirmed read access to every category. HealthKit does not reveal denied read permissions. Tap the badge to request access. iOS may show a sheet for types needing a decision; for choices already recorded, Health.md shows permission guidance. Review categories in Apple Health. Empty results can mean withheld access or no matching data. Troubleshoot missing data.

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. If a referenced profile is missing, the operation fails without substituting other settings. 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.

The subscription-enabled iPhone/iPad and Google Play phone releases require active trial, subscription, Lifetime, or preserved permanent access for exports and scheduling. No local free-export allowance remains. The Mac companion and F-Droid included-access build retain their documented exceptions. See the Paywall page for Apple purchase details.