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/.
The first step is to obtain your HealthKit data from your iPhone. To do this (as of iOS 12):
-
Launch the Health app.
-
Tap the icon in the top right corner:
-
Tap "Export Health Data":
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