Skip to content

smirko-dev/fitbit-homeassistant

Repository files navigation

Fitbit Homeassistant

languages platform version FitbitBuild Actions Status CodeQL Actions Status Github All Releases

Description

This app allows to control Home Assistant entities from a Fitbit watch via the HomeAssistantAPI module .

Supported languages: de-DE, en-US, it-IT.

Supported entity types:

Action Entities
on / off switch, light, group
open / close cover
execute automation, script, button

App icon is from https://icon-icons.com/de/symbol/home-assistant/138491 (Apache License, Version 2.0).

Requirements

  • Home Assistant needs to be accessible via HTTPS or local network (via IP address) due to Fetch API limitations.
  • The RESTful API needs to be enabled in Home Assistant.
  • A Home Assistant Long-Lived Access Token, described in Authentication.

Settings

  • Home Assistant URL (text)
  • Port number (text)
  • Long-Lived Access Token (text)
  • List of up to 10 entities (text)
  • Force status (toggle)

Entities should be added by ID and not by name!

Force status schould be used in case of HA responds with an empty JSON object on POST messages!

Screenshots

App

How to build

Clone the repository

git clone git@github.com:smirko-dev/fitbit-homeassistant.git
cd fitbit-homeassistant

Choose SDK version

SDK Device
4 Versa, Versa Lite, Versa 2, Ionic
6 Versa 3, Sense
cp package.sdkX.json package.json

Setup SDK and build the application

npm add --also=dev @fitbit/sdk
npm add --also=dev @fitbit/sdk-cli
npx fitbit-build generate-appid
npx fitbit-build

Known issues