garmin-grafana

garmin-grafana 概覽

這是什麼

這是一個 Docker 化的 Python 腳本，用於從 Garmin Connect 伺服器擷取健康資料，並儲存到本機的 InfluxDB 資料庫中，再透過 Grafana 進行長期健康趨勢的視覺化。此專案為開源且自架，提供 Garmin 資料的私有備份。

主要功能

• 自動定期從 Garmin 收集資料（設定後無需再手動操作）
• 收集多項健康指標，包括心率、步數、睡眠資料（血氧、呼吸率、HRV）、壓力、身體電量、卡路里、活動分鐘數、心率區間、運動 GPS 資料等
• 支援歷史資料回填（大量匯入舊資料）
• 提供預先配置的 Grafana 儀表板（Garmin-Stats）
• 完全開源（BSD-3-Clause 授權），不與第三方分享資料

使用情境

• 長期追蹤個人健康與健身資料
• 在單一 Grafana 面板上結合多項指標以獲得深入洞察
• 匯出資料進行進階分析（Python、Excel）或設定自訂警示
• 維護 Garmin Connect 資料的完整私有本機備份

快速開始

複製儲存庫並執行簡易安裝腳本（需要 Linux 或 Windows 的 WSL）：bashcd ~ && git clone https://github.com/arpanghosh8453/garmin-grafana.git garmin-grafanacd garmin-grafana && sudo bash ./easy-install.sh依提示輸入 Garmin Connect 憑證。設定完成後，透過 http://localhost:3000 存取 Grafana，預設帳號密碼為 admin/admin。儀表板 Garmin-Stats 會自動配置完成。

授權與價格

採用 BSD-3-Clause 授權。此專案為開源且免費使用、修改與散布，但需標註原作者。

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