GarminDB

從 Garmin Connect 或 Garmin 手錶、FitBit CSV 及 MS Health CSV 檔案下載並解析資料,存入 Sqlite 無伺服器資料庫,並以 Jupyter 進行分析。

GarminDB 是什麼?

從 Garmin Connect 或 Garmin 手錶、FitBit CSV 及 MS Health CSV 檔案下載並解析資料,存入 Sqlite 無伺服器資料庫,並以 Jupyter 進行分析。

GarminDB 概覽

這是什麼

GarminDB 是一組 Python 腳本,用於將健康資料解析並操作到 SQLite 資料庫中。SQLite 是一個輕量級且不需要伺服器的資料庫。這些腳本可以從 Garmin Connect 或 Garmin 手錶下載並解析資料,也支援 FitBit CSV 和 MS Health CSV 檔案。

主要功能

  • 自動從 Garmin Connect 的「每日摘要」頁面下載並匯入 Garmin 每日監測檔案(全天心率、活動、爬升/下降、壓力與強度分鐘數)。
  • 從 Garmin Connect 提取睡眠、體重與靜止心率資料,儲存為 JSON 檔案並匯入資料庫。
  • 從 Garmin Connect 下載並匯入活動檔案,包含所有活動的摘要表格,以及部分活動類型的詳細資料(圈數與記錄條目)。
  • 將資料彙總為每日、每週、每月與每年的摘要表格。
  • 可透過命令列或 Jupyter notebook 繪製資料圖表。
  • 保留已下載的 JSON 與 FIT 檔案,以便無需重新連線或重新下載 Garmin Connect 資料即可重建資料庫。
  • 將活動匯出為 TCX 檔案。

使用情境

分析來自 Garmin 裝置、FitBit 與 Microsoft Health 的健康與活動資料。使用提供的 Jupyter notebook、第三方 Jupyter notebook 或 SQLite 瀏覽器(如 SQLite Studio、HeidiSQL 或 DB Browser for SQLite)來瀏覽與操作資料。

快速開始

使用 pip 從 PyPI 安裝最新版本:pip install garmindb將範例設定檔複製到 ~/.GarminDb/GarminConnectConfig.json,編輯並加入您的 Garmin Connect 使用者名稱與密碼,並調整開始日期。然後執行:garmindb_cli.py --all --download --import --analyze若要增量更新,請加上 --latest。備份資料庫檔案請執行 garmindb_cli.py --backup。或者,您可以從原始碼建置:複製儲存庫、執行 make setup、複製設定檔,然後執行一次 make create_dbs,之後執行 make 以保持資料更新。更多細節請參閱儲存庫的 README。

授權與價格

授權:GPL-2.0。此為開源專案,未標示價格。

內容整理自該專案公開的 README 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/tcgoetzgarmindb.svg)](https://yunodb.com/tools/tcgoetzgarmindb?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/tcgoetzgarmindb?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/tcgoetzgarmindb.svg" alt="Featured on YunoDB" height="20"></a>