search

nabelekt / HealthKit_data_convert

Convert a HealthKit XML file – containing health and fitness data from iOS (iPhone) and watchOS (Apple Watch) devices – to a CSV file.
GNU General Public License v3.0
11 stars 2 forks source link

readme

HealthKit_data_convert

Convert a HealthKit XML file – containing health and fitness data from iOS (iPhone) and watchOS (Apple Watch) devices – to a CSV file. Plot the data with nabelekt/HealthKit_data_plot.

While there are other scripts, websites, and apps (http://quantifiedself.com/qs-access-app/) to accomplish the same task, I found each one that I tried lacking in some way.

This project makes use of Python version 3. The version of Python installed by default in macOS, as of macOS 10.14 (Mojave), is Python 2.7.10. Instructions for installing Python 3 on macOS can be found at https://docs.python-guide.org/starting/install3/osx/. Python installers for Windows can be found at https://www.python.org/downloads/windows/.

Usage

The first step is to obtain your HealthKit data from your iPhone. To do this (as of iOS 12):

  1. Launch the Health app.

  2. Tap the icon in the top right corner:

    alt text

  3. Tap "Export Health Data":

    alt text

This will give you an 'export.zip' archive. Transfer this to your computer. In the unzipped 'apple_health_export' directory, you will see a 'export_cda.xml' and 'export.xml'. Select file 'export.xml' file. Once you have the XML file where you want it on your computer, with Python 3 or later installed, at the command line do:

python HealthKit_data_convert.py [input_file] [output_file]

For example:

cd ~/Downloads/HealthKit_data_convert

python HealthKit_data_convert.py ../apple_health_export/export.xml ../apple_health_export/converted_data.csv