tcgoetz/GarminDB

⌚ Biến toàn bộ dữ liệu Garmin của bạn thành database SQLite cá nhân, sẵn sàng phân tích

Tự động tải, parse và lưu trữ dữ liệu sức khỏe từ Garmin Connect vào SQLite — không cần server, phân tích bằng Jupyter notebooks.

GarminDB là bộ script Python giúp bạn tải dữ liệu từ Garmin Connect hoặc đồng hồ Garmin, cũng như file CSV từ FitBit và MS Health, rồi nhập vào database SQLite. SQLite là database nhẹ, không cần server, phù hợp để lưu trữ và truy vấn dữ liệu sức khỏe cá nhân. Sau khi có dữ liệu trong DB, bạn có thể dùng Jupyter notebooks hoặc các công cụ như SQLite Studio, HeidiSQL, DB Browser for SQLite để khám phá.

✨ Điểm nổi bật

• Tự động tải dữ liệu hằng ngày: kéo dữ liệu từ trang Daily Summary của Garmin Connect gồm nhịp tim cả ngày, hoạt động, leo/xuống dốc, stress và intensity minutes.
• Hỗ trợ nhiều loại dữ liệu: sleep, weight, resting heart rate từ Garmin Connect được lưu thành JSON rồi import vào DB.
• Chi tiết hoạt động: tải và import file activity, có bảng tổng hợp cho tất cả hoạt động và dữ liệu chi tiết hơn cho một số loại, kèm lap và record entries.
• Tổng hợp theo ngày/tuần/tháng/năm: tự động tạo bảng summary giúp nhìn xu hướng dài hạn dễ dàng.
• Vẽ biểu đồ từ command line hoặc Jupyter notebooks: linh hoạt trong cách khám phá dữ liệu.
• Giữ lại file JSON và FIT đã tải: cho phép tái tạo database mà không cần kết nối lại Garmin Connect.
• Xuất hoạt động dạng TCX: dễ dàng chia sẻ hoặc chuyển dữ liệu sang nền tảng khác.
• Plugin mở rộng: hỗ trợ plugin để xử lý dữ liệu từ các app Connect IQ của bên thứ ba.

💡 Vì sao đáng chú ý

Điểm khác biệt lớn của GarminDB là nó không chỉ dừng ở việc tải dữ liệu, mà còn tổ chức thành database có cấu trúc rõ ràng với các view mặc định giúp duyệt dữ liệu dễ hơn. Việc giữ lại file gốc JSON/FIT cũng là một lợi thế: nếu schema DB thay đổi, bạn chỉ cần chạy lệnh rebuild, dữ liệu sẽ được tái tạo từ file đã tải mà không phải tải lại từ Garmin.

Dự án phù hợp với những ai muốn làm chủ dữ liệu sức khỏe của mình — từ theo dõi nhịp tim, giấc ngủ, cân nặng đến phân tích hiệu suất tập luyện — mà không phụ thuộc vào giao diện đóng của Garmin Connect. Kết hợp với Jupyter notebooks, bạn có thể tự xây dựng các phân tích và biểu đồ theo nhu cầu cá nhân.

#Garmin #HealthData #SQLite #Python #Jupyter #TiniX