{"id":22128924,"url":"https://github.com/rootasjey/metrix-fitbit","last_synced_at":"2025-07-25T18:31:59.883Z","repository":{"id":33585553,"uuid":"154190739","full_name":"rootasjey/metrix-fitbit","owner":"rootasjey","description":"A Fitbit Ionic \u0026 Versa clock face ","archived":false,"fork":false,"pushed_at":"2023-01-06T01:40:59.000Z","size":1739,"stargazers_count":16,"open_issues_count":8,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-08-13T23:10:46.764Z","etag":null,"topics":["clockface","fitbit","fitbit-clock","fitbit-clockface","fitbit-ionic","watchface"],"latest_commit_sha":null,"homepage":"https://gallery.fitbit.com/details/33702990-cf56-4f66-944c-fb578a37ebf2","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rootasjey.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-10-22T17:58:53.000Z","updated_at":"2023-03-08T03:58:15.000Z","dependencies_parsed_at":"2023-01-15T01:32:14.625Z","dependency_job_id":null,"html_url":"https://github.com/rootasjey/metrix-fitbit","commit_stats":null,"previous_names":[],"tags_count":4,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootasjey%2Fmetrix-fitbit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootasjey%2Fmetrix-fitbit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootasjey%2Fmetrix-fitbit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootasjey%2Fmetrix-fitbit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rootasjey","download_url":"https://codeload.github.com/rootasjey/metrix-fitbit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227606487,"owners_count":17792795,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clockface","fitbit","fitbit-clock","fitbit-clockface","fitbit-ionic","watchface"],"created_at":"2024-12-01T17:56:56.635Z","updated_at":"2024-12-01T17:56:57.267Z","avatar_url":"https://github.com/rootasjey.png","language":"JavaScript","funding_links":["https://www.paypal.me/rootasjey"],"categories":[],"sub_categories":[],"readme":"# metrix-fitbit\n\nA Fitbit Ionic \u0026 Versa clock face showing metrics activities.\n\nYou can change each metric to one of the 9 available. You can even have the same activity multiple times and showing different stats format.\n\nFor example, for steps, you could show both:\n\n* the total steps\n* percentage achievement goal\n\n| Ionic | Versa |\n|----------|:-------------:|\n| ![ionic.png](screenshots/ionic.png) | ![versa.png](screenshots/versa.png) |\n| ![ionic2.png](screenshots/ionic2.png) | ![versa2.png](screenshots/versa2.png) |\n| ![ionic.gif](screenshots/ionic.gif) |![versa.gif](screenshots/versa.gif) |\n\n## Changelog\n\n### 05/03/19\n\n![changelog.png](screenshots/changelog.png);\n\n* Add battery metric indicator\n* Add miles units for distance metric\n* Add lock clock face UI in settings app\n* Add manual location for weather\n* Add a reset all metrics (panic) button\n\n### 29/11/18\n\n* You can now personalize metric's color\n* Metric's color personalization can be reset in mobile settings\n* Add new time and date format\n* Add new colors for metrics and background\n* Add donation button (mostly for weather API)\n\n## Features\n\n* Colorful design\n* 9 available metrics (clock, weather, calories, ...)\n* 3 different states meter (total, percent, missing/over)\n* The switch mode button let you be in 2 different states:\n  * **Stats:** you can change between 3 differents stats for metric value (total, percent, missing/over) _(note that some metric don't necessarly have all stats like the clock metric)_\n  * **Next:** switch to the next available activity\n\n## Activities metrics\n\n* active minutes\n* battery level\n* calories\n* clock\n* date\n* distance\n* elevation gain\n* heart rate\n* steps\n* weather\n\n## Permissions and Privacy\n\nBecause this clock face shows personal goals, heart rate and weather data, it uses these exact same information:\n\n* Personal goals (steps, calories, distance, ...)\n* Heart rate sensor\n* **GPS location** for the weather\n\nNo data is kept nor send to first or third parties entities, companies or individuals. You can check by looking at the source code.\n\nWhen installing the clock face, it'll ask you for these permissions. You can deny all, some or none. The non-functional activities metrics won't show on the clock face in that case.\n\n## Ionic \u0026 Versa\n\nThe clock face support both Ionic \u0026 Versa with a layout adaptation.\n\n## Settings\n\nIn the settings, you can change the color background of the clock face and you can find some contact information.\n\n## Weather\n\nThe weather data is provided by [DarkSky](https://darksky.net).\n\nYou can change the refresh time rate in the settings. By default, the cache lasts 1 hour (60 min).\n\nWeather data is only updated when the clock face is active (i.e. screen turned on) and is not updated in background every X time. This is because there's a usage limite of the API.\n\nAs I pay for for the DarkSky API usage, I can't afford all API requests. Feel free to support the clock face if you use this daily. Feel free to help me with the cost by donating some penies.\n\n_Because there's a API usage limit, the weather data may not update right away. This will depend on the amount of users using this clock face._\n\n## GPS\n\nBy default, the weather uses the device GPS if available (for Ionic).\n\nIf the device doen't have one (like the Versa), the weather will try to use the phone's GPS.\n\nHowever, if sometimes it doesn't work or if you want to use a manual location, you can set one through the (mobile) companion's settings app.\n\n![manual-location-settings.png](screenshots/manual-location-settings.png)\n\n* Activate the 'Use Manual Location' toggle\n* Fill the address values\n* Tap on the 'Update' button\n\n## Contributing\n\nFeel free to contribute to this project by:\n\n* Opening a PR with a change proposition\n* Openning an issue if\n  * you want to propose a new feature\n  * or if you encounter a problem\n* Pay me a tea\n\n## Resources\n\nAcitivities icons are provided by:\n\n* [Fitbit's icons](https://github.com/Fitbit/sdk-design-assets)\n\nWeather API wrapper is provided by:\n\n* [fitbit-weather](https://github.com/gregoiresage/fitbit-weather)\n\nWeather icons are from [www.flaticon.com](https://www.flaticon.com/\"), is licensed by [CC 3.0 BY](http://creativecommons.org/licenses/by/3.0), and provided by:\n\n* [Good Ware](https://www.flaticon.com/authors/good-ware)\n* [Freepik](https://www.freepik.com)\n* [Iconixar](https://www.flaticon.com/authors/iconixar)\n* [RNS](https://www.flaticon.com/authors/rns)\n* [Smalicons](https://www.flaticon.com/authors/smashicons)\n* [Yannick](https://www.flaticon.com/authors/yannick)\n\n## Licence\n\nThis project is under MIT Licence.\n\n## Support\n\n[Support OSS by paying me a beer](https://www.paypal.me/rootasjey) 🍺\n\nThank you if you decide to help me :)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frootasjey%2Fmetrix-fitbit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frootasjey%2Fmetrix-fitbit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frootasjey%2Fmetrix-fitbit/lists"}