Contents of the docs
komoot2mqtt · Docs
Overview
Service that polls your komoot tours regularly and sends statistics and your latest tour to Home Assistant via MQTT.
On this page
komoot2mqtt fetches your recorded tours from komoot at fixed intervals, computes statistics and publishes them via
MQTT. With discovery enabled, Home Assistant creates the matching sensors by itself: speed, distance, duration and
elevation (minimum, average, maximum, total) plus the values of your latest tour.
How it runs
- On start the service connects to the MQTT broker and reports itself as
online. - It loads all recorded tours (optionally filtered by sport and date) and publishes the statistics, the latest tour and the list of all tours.
- With discovery enabled it sends Home Assistant the sensor configuration.
- After that it repeats steps 2 and 3 every 10 minutes. Unchanged values are not sent again.
If the connection drops, the broker sets the state to offline via the last will, and Home Assistant shows the sensors
as unavailable.
The service can also write your past tours once as history into the Home Assistant database, see Home Assistant.
Warning
Through komoot-client the service uses the internal API of the komoot app. If komoot changes it, no new values arrive.
Status
Version 1.2.2, actively used and maintained. Runs as a Docker container.
Related projects
- komoot-client: the client the service is built on.
- komoot2csv: writes your tours into a CSV file.