/watchlib

watchlib is a Python module providing tools for loading, analyzing and visualizing Apple Watch health data.

Primary LanguagePythonMIT LicenseMIT

pip install git+https://github.com/aminnj/watchlib.git
# dict of key -> DataFrame
data = watchlib.DataLoader("./apple_health_export").load_health_data()

# single DataFrame with key as column
df = watchlib.DataLoader("./apple_health_export").load_health_data_consolidated()

Original README below

Important: This package is now deprecated. See watchml for a newer and better version of watchlib.

watchlib_transparent

watchlib

watchlib is a Python module providing tools for loading, analyzing and visualizing Apple Watch health data.

Disclaimer: This is still a work in progres! If you want to help with further development feel free to join me on Discord where we can discuss together or write an Issue here on GitHub.

Documentation

A detailed documentation can be found in the Wiki. To see the module in action you can try out the watchlib demonstrator or look at some of the demo notebooks.

Install

To install watchlib simply run:

pip install watchlib

Update to newest version

pip install --upgrade watchlib

How to export Apple Watch health data

  1. Open Health app
  2. Open your profile in the upper right corner
  3. Scroll down
  4. Tap on "Export all health data"
  5. Confirm that you want to export all health data
  6. Wait until the export has finished (this might take some minutes)
  7. Select "Save in files"
  8. Choose a folder and tap "Save"
  9. Last step is to unzip the "Export.zip" file

Contributions

Icon design: Olli Graphics