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.
- ❤️ 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
- 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
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.
To exit Fitbit CLI, press Ctrl-C
twice.
- 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.