First stable release. Nothing in the integration's behaviour changes from
v0.2.3 — no new sensors, no new settings, nothing to reconfigure. The version
number marks that this has been running against a live account and a real Home
Assistant instance for a while now, and that it is being submitted to the HACS
default store.
What it does
Seven sensors, one device per Trappers account:
| Sensor | What it tells you |
|---|---|
| Points balance | Points you have to spend in the webshop |
| Points balance value | What that balance is worth in euro, at the shop's gift-card rate |
| Cycling days total | Days cycled since you joined |
| Cycling days this month | Days cycled this calendar month |
| Last cycling day | The most recent date your bike tag was registered |
| Points earned this month | Points credited this calendar month |
| Commute distance | Your registered one-way commute |
English and Dutch throughout. Updates five times a day between 08:00 and 20:00,
nothing overnight — points are credited at most once per working day.
In this release
The README was rewritten for someone who has never heard of Trappers or
FiscFree: what each sensor means rather than how it is worked out, a numbered
install path, and the engineering rationale moved out to the developer notes
where it belongs.
If you are coming from 0.1.x
Two earlier fixes are worth repeating, because both changed numbers you may
have been reading:
- The euro value was overstating your balance by about 5% before v0.2.0.
It used a conversion field from the API that turns out to reproduce the
scheme's own cost basis rather than a price you can buy at. It now reads the
webshop catalogue instead, and reportsunknownrather than a guess when no
clear rate can be read. - Entity IDs contained your email address before v0.1.1, employer domain
included, which then travelled into any dashboard YAML or screenshot you
shared. They are named from your first name now.
Upgrading from 0.1.x renames entities, so dashboards and automations pointing
at the old IDs need updating once.
Install
HACS → ⋮ → Custom repositories → https://github.com/yodax/ha-trappers,
category Integration. Requires Home Assistant 2026.3.0 or newer.
Unofficial and community-built; not affiliated with or endorsed by Trappers or
FiscFree.