How tcgoetz/garmindb works
GarminDB downloads and imports Garmin Connect health and activity data, stores it in databases, derives period summaries, and exposes analysis and visualization. README also documents retained source files, activity export, and Jupyter/command-line graphing; Fitbit and Microsoft Health data have separate import and analysis modules. The graph preserves these distinct stages and storage domains. Some subsystem links rely on README descriptions or SOURCE INDEX references; unsampled code is not treated as inspected, so uncertain runtime wiring is omitted.
Main entry points: garmindb_cli.py Command-line workflow · download.py Data download · summary_base.py Period summaries · garmin_connect_auth_adapter.py Connect authentication
Components 20
Garmin acquisition
- Command-line workflow
scripts/garmindb_cli.py - Connect configuration
garmindb/garmin_connect_config_manager.py - Connect authentication
garmindb/garmin_connect_auth_adapter.py - Data download
garmindb/download.py
Parsing and import
- Retained FIT and JSON
garmindb/garmin_json_data.py - FIT parsing
garmindb/fit_file_processor.py - Activity processing
garmindb/activity_fit_file_processor.py - Monitoring import
garmindb/import_monitoring.py - Fitbit import and analysis
garmindb/fitbitdb/fitbit_db.py - Microsoft Health import and analysis
garmindb/mshealthdb/mshealth_db.py - FIT plugins
garmindb/plugin_manager.py
Health data stores
- Activity database
garmindb/garmindb/activities_db.py - Monitoring database
garmindb/garmindb/monitoring_db.py - Garmin data database
garmindb/garmindb/garmin_db.py - Period summaries
garmindb/summarydb/summary_base.py
Analysis and export
- Garmin analysis
garmindb/analyze.py - Jupyter graphs
Jupyter/graphs.py - Activity export
garmindb/export_activities.py
Other components
- User
- Garmin Connect
Connections 21
- User → Command-line workflow: runs workflow
- Command-line workflow → Data download: downloads data
- Command-line workflow → Monitoring import: imports monitoring
- Command-line workflow → Garmin analysis: analyzes data
- Data download → Connect authentication: uses authentication
garmindb/download.py - Connect authentication → Connect configuration: reads credentials
garmindb/garmin_connect_auth_adapter.py - Connect authentication → Garmin Connect: authenticates and requests
garmindb/garmin_connect_auth_adapter.py - Data download → Garmin Connect: downloads data
- Data download → Retained FIT and JSON: retains downloaded files
- Activity processing → FIT parsing: delegates processing
garmindb/activity_fit_file_processor.py - Activity processing → Activity database: stores activity data
- Monitoring import → FIT parsing: uses FIT data
garmindb/import_monitoring.py - Monitoring import → Monitoring database: imports monitoring records
garmindb/import_monitoring.py - Garmin analysis → Period summaries: writes summaries
garmindb/analyze.py - Garmin analysis → Garmin data database: reads Garmin data
garmindb/analyze.py - Fitbit import and analysis → Period summaries: summarizes Fitbit data
- Microsoft Health import and analysis → Period summaries: summarizes health data
- Jupyter graphs → Period summaries: graphs summaries
Jupyter/graphs.py - User → Jupyter graphs: views data
- User → Activity export: exports activities
- FIT plugins → Activity database: initializes activity plugins
garmindb/plugin_manager.py