Skip to content

Tutorial Importing Your History

Jump to bottom
NoopApp edited this page Jun 10, 2026 · 1 revision

Tutorial: Importing Your History

Bringing your past WHOOP data and Apple Health export into NOOP is a one-time, one-tap process. Once imported, your full history stays on your device — nothing is uploaded. This page walks you through exporting from WHOOP and Apple Health, then importing both into NOOP.

Why import?

If you have years of data in WHOOP or Apple Health, importing fills NOOP with context instantly:

  • Your recovery, strain, and sleep scores appear across trends, insights, and analytics.
  • The app learns your personal baselines (HRV, resting HR, respiratory patterns) so today's metrics make sense relative to your history.
  • On Android, Health Connect read (and optional write) syncs native activity and health data from your phone.

Without an import, NOOP computes recovery and strain live from the strap, but needs ~2 weeks of data before the scores stabilize.

Part 1: Export from WHOOP

Step 1: Open the official WHOOP app or web dashboard

You can export from either your phone's WHOOP app or the web (app.whoop.com).

What you'll see:

  • Phone (iOS/Android): Your home screen with the recovery ring and daily metrics.
  • Web (app.whoop.com): Your dashboard with the recovery graph and rings.

Step 2: Find Data Management

On the phone app:

  1. Tap the menu or settings (usually ⋮ or a gear icon in the corner).
  2. Find Account, Settings, or a Data section.
  3. Look for Data Management or Download my data.

On web (app.whoop.com):

  1. Click your profile icon (top right).
  2. Go to Account Settings or Preferences.
  3. Scroll to Data Management or Export data.

Step 3: Export your data

Tap or click Export / Download / Get my data. WHOOP will compile your full history (physiological cycles, sleeps, workouts, journal entries) into a .zip file.

What you'll see:

  • A prompt to confirm the export.
  • A download link, or the file appears in your Downloads folder.

The .zip typically contains:

  • physiological_cycles.csv — your recovery, strain, HRV, resting HR, temperature, respiratory rate per day
  • sleeps.csv — sleep sessions with stage breakdowns
  • workouts.csv — detected exercise with HR zones and calories
  • journal_entries.csv — any behaviours you logged (alcohol, caffeine, meditation, etc.)

Step 4: Move the file to your computer (if exporting from phone)

If you exported on your phone:

  • iPhone: Use AirDrop or email the file to yourself.
  • Android: Move it to a computer or cloud folder you can access from NOOP.

Keep the file where NOOP can find it (your Downloads folder works fine).

Part 2: Export from Apple Health

WHOOP exports are optional but recommended. Apple Health export is only available on macOS and iOS; Android users can skip to #part-3-import-into-noop.

Step 1: Open the Health app (macOS or iOS)

macOS: Open Health from your Applications > Utilities folder, or search with Spotlight.

iOS: The built-in Health app (red icon with a heart).

Step 2: Go to your profile and find Export

macOS:

  1. Click the Health Data tab (top of the window).
  2. Click your profile name or icon (bottom left).
  3. Look for Export All Health Data.

iOS:

  1. Tap the Profile or account tab (bottom right).
  2. Tap Export All Health Data (or scroll down to find it).

What you'll see: A prompt to export all health data (7 years of history or everything you have). NOOP streams and deduplicates this on-device — large exports (thousands of samples) take 1–2 minutes.

Step 3: Save the export

The Health app generates export.zip (or sometimes export.xml on iOS). Save it somewhere accessible from NOOP (Downloads is fine).

Note: Apple Health exports can be large (500 MB — 2 GB for years of data). On first import, NOOP ingests the whole file locally, so the import may take 1–3 minutes depending on the size.

Part 3: Import into NOOP

macOS

  1. Open NOOP and go to Data Sources in the sidebar (or the main screen menu).

    What you'll see: Three cards: "WHOOP Export", "Apple Health", and "WHOOP Strap (Live BLE)". Each has a blue Choose export... button.

  2. Import WHOOP (optional):

    • Click Choose export... under the WHOOP Export card.
    • Select your .zip folder or unzipped export folder from WHOOP.
    • NOOP reads physiological_cycles.csv, sleeps.csv, workouts.csv, and journal_entries.csv.
    • A progress spinner appears briefly; once done, you'll see: "X days · Y sleeps imported" and a count of days/sleeps now stored.

    What to expect:

    • Recovery, strain, HRV, resting HR, temperature, and respiratory rate appear in the Trends view.
    • Sleep sessions populate the Sleep screen with hypnograms and stage breakdowns.
    • Workouts fill the Workouts screen.
    • Journal entries (logged behaviours) power the Insights view.

  3. Import Apple Health (optional):

    • Click Choose export.zip... under the Apple Health card.
    • Select your export.zip (or the unzipped export.xml folder).
    • NOOP streams the file locally — a progress spinner shows while it reads. Large exports take 1–2 minutes.
    • Once done, you'll see: "X samples imported" (HR, HRV, sleep, SpO₂, steps, weight, body composition).

    What to expect:

    • Steps, resting HR, HRV, VO₂ Max, weight, and body composition appear in the Apple Health view.
    • Sleep data may overlap with WHOOP sleeps (NOOP keeps both and cross-references them).
    • Workouts from Apple Health (e.g. Workouts app, third-party fitness apps) appear in the Workouts screen alongside WHOOP workouts.

  4. All done. Your full history is now on your Mac. Check Trends to see your recovery history, or Insights to correlate behaviours with outcomes.

Remember: Everything stays on your device. No upload, no sync, no cloud.

Android

  1. Open NOOP and navigate to Data Sources (usually bottom-nav or the app menu).

    What you'll see: Cards for WHOOP Export, Health Connect, Apple Health export, and WHOOP Strap status.

  2. Import WHOOP CSV or ZIP (optional):

    • Tap Choose export under the WHOOP Export card.
    • Select your .zip folder or unzipped export.csv / physiological_cycles.csv from WHOOP.
    • NOOP reads and ingests the file. A progress bar shows while it imports; you'll see day and workout counts when done.

  3. Import from Health Connect (native Android):

    • This is Android's built-in health platform — many apps (Google Fit, Samsung Health, Oura, etc.) write to it.
    • Tap Connect or the permission toggle under the Health Connect card.
    • Grant NOOP permission to read steps, heart rate, HRV, sleep, SpO₂, weight, and workouts.
    • NOOP automatically reads Health Connect data (no explicit import needed).
    • Optional writeback: If you toggle Write back recovery/strain, NOOP sends its computed scores back into Health Connect so other apps can see them. (Writeback is an advanced feature; leave it off unless you specifically want other apps to read NOOP's scores.)

  4. Import from Apple Health (optional, if you have an iOS device that synced to this Android device):

    • If you've exported from Apple Health on an iOS device and moved the .zip or export.xml to your Android phone, tap Choose export.
    • Select the file.
    • NOOP ingests it just like on macOS.

Note: Android has no cloud-backup of Health Connect data, so imports are your explicit choice. Once you import, the data sits in NOOP's local SQLite database (on-device, private).

What gets imported and what stays private

WHOOP CSV import

NOOP imports and stores:

  • Physiological cycles — recovery %, strain (0–21), HRV, resting HR, sleep efficiency, sleep need, skin temperature (°C), respiratory rate, blood oxygen (%), average/max HR, calories.
  • Sleep sessions — stage breakdown (light/deep/REM/awake), efficiency, performance, consistency, in-bed duration.
  • Workouts — activity name, duration, HR zones, calories, strain.
  • Journal entries — behaviours you logged (Alcohol, Caffeine, Meditation, etc.) for Insights correlation.

NOOP does not import:

  • Any WHOOP-proprietary models or algorithms (those stay in WHOOP).
  • Personal account info (email, name, subscription status).
  • The WHOOP cloud credentials (NOOP never needs them).

Bottom line: You get years of your biometric data, nothing proprietary or identifying.

Apple Health export import

NOOP imports and stores:

  • Heart rate samples (per-sample, or aggregated daily).
  • HRV (RMSSD / SDNN from Heart Rate Variability samples).
  • Sleep sessions — dates, stage breakdown where available (Core / Deep / REM).
  • Blood oxygen (SpO₂), respiratory rate, body temperature.
  • Steps, active energy (kcal), basal energy, VO₂ Max.
  • Body composition — weight, body fat %, lean mass.
  • Workouts — type, duration, energy, distance from third-party apps.

Apple Health can hold up to 7 years of history. On first import, this can be 100,000+ samples; NOOP streams and deduplicates locally.

Bottom line: All your health data from Apple Health becomes queryable and correlated in NOOP — no data leaves your device.

Health Connect (Android)

Health Connect is Android's platform for apps to read and write health data. NOOP can read:

  • Steps, heart rate, HRV, sleep, SpO₂, weight, workouts from Health Connect sources (Google Fit, Samsung Health, Fitbit, Oura, etc.).
  • Optionally write back: NOOP's computed recovery and strain, so other apps can use them.

Health Connect data stays on-device in Android's own health database; NOOP reads from it and stores a copy in its local SQLite.

Bottom line: You own the Health Connect data. NOOP reads it; what it reads stays local and encrypted.

After import: What fills in where

Once imported, your data populates every screen:

Screen What appears How
Control Center (Today) Recovery ring, key metrics (HRV, resting HR, sleep, strain) with 14-day sparklines. Cached dailyMetric rows from imports.
Sleep Hypnogram, stage breakdown, efficiency, performance. From imported sleepSession rows.
Trends 3M/1Y/ALL recovery, strain, HRV recovery history. From dailyMetric; recovered from raw metrics if available.
Workouts All imported workouts (WHOOP + Apple) with HR zones, calories, distance. From imported workout rows; source badge shows which app.
Insights Correlations between your metrics, behaviour effects (alcohol → recovery, etc.). From your journal (logged behaviours) and daily metrics.
Compare Plot any two metrics against each other over time. From metricSeries (generic key-value store of every metric NOOP knows).
Explore Drill into any single metric (HRV, resting HR, blood oxygen, etc.) with stats and correlations. From metricSeries.
Apple Health Per-source dashboard of Apple Health stats (steps, weight, VO₂ Max, etc.). Cached in appleDaily + dailyMetric from the Apple Health import.
Strap (Live BLE) Live heart rate, battery, real-time R-R intervals. Streams from the connected strap. Imports don't affect this.

Troubleshooting

"Import failed" — what went wrong?

WHOOP export:

  • Make sure the file is from app.whoop.com → Data Management → Export, not a manual CSV export.
  • The .zip must contain physiological_cycles.csv or sleeps.csv (at least one).
  • If you unzipped it, make sure you select the unzipped folder, not the inner .csv files.

Apple Health export:

  • The file must be export.zip or export.xml from Health app → Profile → Export All Health Data.
  • If the .zip is corrupted or incomplete, try exporting again.
  • Large exports (2+ GB) may take 2–3 minutes; don't quit NOOP while importing.

The data imported, but some metrics are blank

This is normal. WHOOP exports include recovery, strain, and sleep because the official WHOOP app computed them; NOOP displays them as-is. If WHOOP didn't record a metric on a day, it won't appear in NOOP either — that's honest.

Apple Health doesn't include recovery or strain (those are WHOOP-specific). So Apple Health imports fill in steps, HR, weight, etc., but not recovery or strain.

I want to re-import with a newer export

You can import the same file again; NOOP deduplicates on the key (device ID, timestamp) so you won't see double entries. To do a clean import:

  1. macOS: Delete NOOP's database: rm ~/Library/Application\ Support/com.noopapp.noop/noop.db (this wipes all local history). Then re-import.
  2. Android: Settings → Clear app data (or Storage → Clear local data), then re-import. (You can also export your database first via Data Sources → Backup if you want to be cautious.)

Privacy & what stays on your device

  • No cloud. NOOP never uploads to WHOOP, Apple, or any server.
  • No sync. Your device runs NOOP standalone; imports are one-time, one-direction transfers into the local database.
  • No credentials. NOOP never stores your WHOOP password or Apple ID — it only reads the exported files.
  • Encrypted on-device. All data is persisted locally in SQLite (macOS: ~/Library/Application Support/com.noopapp.noop/noop.db; Android: the app's private storage directory). Your operating system's own encryption (FileVault on macOS, full-disk encryption on Android) protects it.
  • Deletable. You can clear your NOOP data anytime by uninstalling the app or wiping the database directory.

See also

Last note: NOOP computes recovery, strain, and sleep locally from the imported (or live-captured) raw streams using published sports-physiology methods. These are approximations, not the official WHOOP scores, and not medical advice. See Features for the exact methods and DISCLAIMER for the full notice.

NOOP is an independent, unofficial, non-commercial interoperability project — not affiliated with, endorsed by, or sponsored by WHOOP, Inc. "WHOOP" is a trademark of WHOOP, Inc., used nominatively. Works only with a device you own; not a medical device; every metric is an approximation, not medical advice. · Privacy and Security · Donations · Releases

Home

Get started

Tutorials

Reference

Project

Clone this wiki locally