README.md

⌚ Fitibt Minimal Clock Face

A clock face compatible with Fitbit Sense and Versa 3 that shows a couple of info. It was made by eye so don't mind the position of the UI elements and some weather icons on the clock

You can install it here
Or here https://gallery.fitbit.com/details/9c63e95d-d584-48cb-b315-f83e0737aa2a.
The builds are done via Travis CI and published on the releases page

TODO:

• ✅ AOD (https://dev.fitbit.com/blog/2019-12-19-announcing-fitbit-os-sdk-4.1/#always-on-display-api)
• Finish localization (like all languages) (https://dev.fitbit.com/build/guides/localization/)
• ✅ Add suport for a 12h hour watches
• ✅ Builds with Travis CI
• Better error handling
• ✅ Lat Lng in settings Add support for geo-location
• Validate inputs on setttings page (https://dev.fitbit.com/build/reference/settings-api/#components)
• ✅ change weather to city country
• check if old value is equal to new value on change event

BUGS:

• Invalid longitude and latitude values

Configurations & Functionality

Configurations

The app provides some configurations specifically for the weather:

• City, Country: You can specify a city to get the weather from, such as Lisbon, Portugal
• Open Weather API: If you have an API key, then you can add your own. The app uses a "public" API key, that can be blocked if it reaches the maximum requests
• Use geolocation: You can toggle this check to use the geolocation from the watch. This will override the "City, Country" setting. If for some reason it's not possible to get the coordinates, then the app will fallback to the "City, Country" setting so i advise you to fill both.

Functionality

• Compatible with 12h and 24h clocks
• The app fetches weather info every hour.
• If for some reason it's not possible to get the coordinates, then the app will fallback to the "City, Country" setting so i advise you to fill both.

Development

• git clone https://github.com/alicescfernandes/fitibt-minimal-clock.git
• npm install
• For this project you don't need to use the npx commands provided on the Fitbit dev starter page. The package.json exposes some commands that use the installed packages
  • npm run start will start the fitbit cli shell (it's the same as npx fitbit)
  • npm run build will build the app (it's the same as running npx fitbit-build)

Resources

Weather Icons

The weather icons come from this page

Weather data

It's provided by the Open Weather Map API