franklinwh 2026.2.1

Python wrapper for FranklinWH

franklinwh-python

Python bindings to the FranklinWH API, such as it is.

In order to use this, you'll need an access token, and your gateway ID. There's a bundled script which can generate an access token, your gateway ID can be found in the app under More -> Site Address. It's shown as your SN.

python3 -m pip install franklinwh

Informational scripts

Scripts in bin use the API to show detailed information about your installation but have extra dependencies, install with

python3 -m pip install franklinwh[bin]

Most scripts require email address, password, and probably gateway id (referenced above).

python3 bin/get_info.py $FRANKLINWH_EMAIL $FRANKLINWH_PASSWORD $FRANKLINWH_GATEWAY_ID

Development

The Makefile has a target to assist development and eventual release:

• prepare - run this once to install franklinwh in editable mode and prerequisites for bin and build.

This should be run in the context where you will eventually develop, which could be

• franklinwh-python

  In this case a virtual environment is recommended.

  python3 -m venv .venv
  source .venv/bin/activate
  

• Home Assistant Core with FranklinWH integration

  This has too many permutations to discuss here but is a primary use for this API.

make prepare

Release

The Makefile has targets to assist the release process:

• build - build the distribution.
• release - upload to PyPi.

The release process involves these steps:

• bump and commit version

  pyproject.toml/project/version must be unique and conform to semantic versioning.

[!NOTE] This may already be included in a Pull Request.

• build

  make build
  

  Fix any errors and commit the changes.

• upload

  make release