tcgoetz/GarminDB
GarminDB
GarminDB is a local fitness data store and self-hosted health data archive designed to import, archive, and analyze health and activity metrics from Garmin accounts. It functions as a fitness data aggregator and metric analysis tool, maintaining a private database of health records for independent tracking and custom querying.
The system features a GPS activity heatmap generator to visualize frequently traveled paths and a plugin system for integrating specialized third-party data fields and custom metrics. It employs a local-first persistence model that retains original source files on disk to allow for full database reconstruction without re-downloading data from external services.
The software covers data management through incremental synchronization and fitness metric aggregation into daily, weekly, monthly, and yearly totals. Its analytical capabilities include activity performance comparison, statistics generation, and health trend visualization via command-line tools or interactive notebooks.
Features
- Local Health Databases - Maintains a private database of health and fitness metrics for custom querying and analysis without relying on cloud services.
- Local-First Databases - Implements a local-first database system for the private storage and ownership of health and fitness metrics.
- Data Ingestion - Provides a system for importing remote fitness data from external API formats into a local database.
- Metric Analysis Tools - Compares performance trends across multiple activities and generates detailed fitness statistics.
- Performance Analysis - Processes raw activity and health data to calculate performance summaries and longitudinal trends over time.
- Self-Hosted Health Archives - Retains original fitness files and parsed data in a local repository for independent health tracking.
- Data Import - Downloads activity files from remote accounts or devices for local database storage.
- Fitness - Summarizes raw health records into structured daily and yearly totals for longitudinal analysis.
- Remote-to-Local Database Synchronizers - Synchronizes remote fitness data with a local database for offline access and ownership.
- Fitness Account Integrations - Implements secure API integration to retrieve fitness data from remote Garmin accounts.
- Fitness Activity Analysis - Analyzes imported fitness files to generate health insights and performance metrics from activity records.
- Fitness Data Parsers - Parses Garmin fitness and health files to store activity metrics in a local database.
- Fitness Metric Aggregators - Summarizes raw activity and health data into daily, weekly, monthly, and yearly totals for longitudinal analysis.
- Health Data Integration - Downloads and parses daily monitoring and health data from remote accounts into a local database.
- Local Data Stores - Provides a local database system for importing, archiving and analyzing health and activity metrics.
- Local Persistence - Persists downloaded health and activity data locally to ensure data ownership and offline availability.
- Fitness Account Archivers - Downloads and stores Garmin fitness and health records locally to ensure long term data ownership and backup.
- Fitness Metric Calculators - Calculates performance metrics and summaries based on stored fitness data to track progress.
- GPS Heatmaps - Creates visual maps of GPS coordinates from stored activity data to identify frequently traveled paths.
- GPS Path Tracking - Provides tools for visualizing movement paths using satellite positioning data for outdoor activities.
- Activity Performance Benchmarking - Analyzes multiple activities over the same course to identify performance differences and trends.
- Health Data Summaries - Aggregates raw health and activity metrics into structured tables for periodic analysis.
- Temporal Trend Visualizers - Generates temporal trend graphs and charts from the health database using command-line tools or notebooks.
- Health Metric Visualizations - Provides capabilities to produce graphs from the database for analyzing health trends via command-line tools or notebooks.
- Incremental Data Synchronization - Fetches only the data generated after the most recent local entry to keep the database current.
- Raw Data Archiving - Preserves original source files locally to allow for future database regeneration without re-downloading.
- Source - Retains original source files on disk to enable full database reconstruction without re-downloading data.
- Third-Party Plugins - Provides a plugin system to extend the data pipeline with specialized parsing for third-party metrics.
- GPS Path Heatmaps - Processes stored GPS coordinates to create visual maps of frequently traveled paths.
