Skip to content

Fitbit Clock Face for tracking imminent phase of day (e.g. Civil Twilight, Golden Hour, Astronomical Dusk etc.) by calculating sun position timings. GPS connection required. Compatible with Fitbit Sense and Fitbit Versa 3.

License

elliotwutingfeng/DayBreak

DayBreak

Fitbit Clock Face for tracking imminent phase of day (e.g. Civil Twilight, Golden Hour, Astronomical Dusk etc.) by calculating sun position timings. GPS connection required. Compatible with Fitbit Sense and Fitbit Versa 3.

Fitbit NodeJS

GitHub stars GitHub license

Logo

Features

  • ❤️ Heart Rate reading
  • 👟 Daily Step counter
  • 🔋 Battery Status
  • ⌚ Date & Time
  • 🌐 GPS connection status & GPS coordinates
  • 🌄 Names and timings of Current and Next phases of day
  • ⏳ Progressbar and countdown timer to Next phase of day

Getting Started

Prerequisites

  • Node.js 16 (currently not compatible with Node.js 17+)
  • Fitbit account
  • Fitbit OS Simulator (Windows/Mac only) or Fitbit Sense or Fitbit Versa 3

Setup Instructions

git clone and cd into the project directory, then run the following

npx fitbit-build && npx fitbit

After logging in, you should be in the Fitbit CLI (i.e. fitbit $).

If you are using your Fitbit device, ensure that Developer Bridge is enabled and Connected. If you are using Fitbit OS Simulator, ensure that it is launched and Connected. In the Fitbit CLI, run

build-and-install

The Clock Face should now be running on your Fitbit device or Fitbit OS Simulator.

Tip

To exit Fitbit CLI, press Ctrl-C twice.

Notes

  • The sun position timings are calculated using suncalc3.
  • The sun position timings are theoretically accurate to within a minute for locations between +/- 72° latitude, and within 10 minutes outside of those latitudes. The nearer you are to the equator, the more accurate the timings. However, due to variations in weather conditions, observed values may vary from calculations. More information is available here.
  • GPS tracker is disabled when Fitbit is off the wrist to conserve battery life.

Acknowledgements