{"id":50766423,"url":"https://github.com/michelfr/ha-abrp","last_synced_at":"2026-06-11T14:01:28.873Z","repository":{"id":363676686,"uuid":"1264417340","full_name":"MichelFR/ha-abrp","owner":"MichelFR","description":"Unofficial Home Assistant integration that surfaces your A Better Route Planner (ABRP) vehicle telemetry and route-planning settings as entities.","archived":false,"fork":false,"pushed_at":"2026-06-09T22:17:08.000Z","size":178,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-09T23:19:23.004Z","etag":null,"topics":["abrp","electric-vehicle","ev","hacs","home-assistant","homeassistant"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MichelFR.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-09T21:38:37.000Z","updated_at":"2026-06-09T22:17:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/MichelFR/ha-abrp","commit_stats":null,"previous_names":["michelfr/ha-abrp"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/MichelFR/ha-abrp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichelFR%2Fha-abrp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichelFR%2Fha-abrp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichelFR%2Fha-abrp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichelFR%2Fha-abrp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MichelFR","download_url":"https://codeload.github.com/MichelFR/ha-abrp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichelFR%2Fha-abrp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34201842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["abrp","electric-vehicle","ev","hacs","home-assistant","homeassistant"],"created_at":"2026-06-11T14:01:26.492Z","updated_at":"2026-06-11T14:01:28.830Z","avatar_url":"https://github.com/MichelFR.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ABRP\n\n[![hacs_badge](https://img.shields.io/badge/HACS-Custom-41BDF5.svg)](https://github.com/hacs/integration)\n[![Validate](https://github.com/MichelFR/ha-abrp/actions/workflows/validate.yml/badge.svg)](https://github.com/MichelFR/ha-abrp/actions/workflows/validate.yml)\n\nA Home Assistant custom integration for [A Better Route Planner](https://abetterrouteplanner.com)\n(ABRP).\n\n[![Open your Home Assistant instance and open this repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=MichelFR\u0026repository=ha-abrp\u0026category=integration)\n[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=abrp_mate)\n\n\u003e **This integration reads your vehicle telemetry *from* ABRP — it does not push\n\u003e telemetry to it.** It is the opposite of the well-known \"send data to ABRP\"\n\u003e setups: it takes the live data your vehicle already reports to ABRP (via an\n\u003e OBD2 dongle or a connected cloud provider such as Tesla or Enode) and shows it\n\u003e as Home Assistant entities, just like the ABRP app. It can also read and edit\n\u003e your ABRP **route-planning preferences** (these are settings, not telemetry).\n\n## Features\n\n- One device per vehicle on your ABRP account, plus an account device for\n  planning preferences.\n- Realtime telemetry via ABRP's live stream, with adaptive polling as a\n  fallback (fast while the car is active, slow while it's parked).\n- Connection diagnostics (online / asleep, cloud vs. OBD) and the data source.\n- View **and edit** your route-planning preferences from Home Assistant.\n- QR-code login (OAuth2) — no password is entered or stored.\n\n## Installation\n\n### HACS (recommended)\n\n1. Click the button below to add this repository to HACS, or in HACS add it\n   manually as a custom repository (category: *Integration*):\n\n   [![Add repository](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=MichelFR\u0026repository=ha-abrp\u0026category=integration)\n\n2. Install **ABRP** and restart Home Assistant.\n\n### Manual\n\n1. Copy `custom_components/abrp_mate` into your Home Assistant\n   `config/custom_components/` directory.\n2. Restart Home Assistant.\n\n## Configuration\n\n1. Go to **Settings → Devices \u0026 Services → Add Integration** and search for\n   **ABRP** (or use the button below):\n\n   [![Add integration](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=abrp_mate)\n\n2. **Scan the QR code** (or open the link) shown in the dialog on a device that\n   is signed in to ABRP, and approve the connection.\n3. That's it — the dialog continues **automatically** once approved and your vehicles are discovered.\n\nIf the stored login ever expires, Home Assistant prompts you to re-authenticate\nwith the same QR step.\n\n## Entities\n\n### Per vehicle\n\n| Type | Entities |\n| --- | --- |\n| Sensor | State of charge, Power, Charging power, Speed, Odometer, Estimated range, Voltage, Current, Charge energy added, External / Battery / Cabin / Vehicle temperature, Reference consumption, Max speed, Weight, Last update, Data source |\n| Binary sensor | Charging, Driving, Parked, DC fast charging, Online, Asleep, Cloud connected, OBD connected |\n| Device tracker | GPS location (with heading, speed, country, timezone attributes) |\n| Select | Drive profile (the vehicle's ABRP configurations, e.g. Standard / winter tyres) |\n\n### Account (\"ABRP\" device) — route-planning preferences\n\n| Type | Entities |\n| --- | --- |\n| Number | Destination SoC, Minimum charger stalls, Extra weight |\n| Switch | Avoid tolls, Avoid ferries, Avoid border crossings, Avoid motorways, Realtime traffic, Realtime weather, Adjust speed to limits |\n| Select | Charge stops (Optimal / Fewer / Fewest) |\n\nThese are account-wide ABRP settings; changes made here sync to the ABRP app\n(and vice-versa) within a short interval.\n\n## How it works\n\n- **Login:** OAuth2 with a QR/connect link; only the (rotating) refresh token is\n  stored, and the access token is used to talk to ABRP's API.\n- **Telemetry:** a live server-sent-events stream delivers updates while the car\n  is active, backed by an adaptive `get_tlm` poll (faster when active, ~10 min\n  when idle).\n- **Settings:** read via `get_session`, written via `set_settings`, and kept in\n  sync near-realtime by watching ABRP's settings version.\n\n## Notes\n\n- This integration uses ABRP's private web API with a session you explicitly\n  approve; only your own account's vehicles are accessed. There is no official\n  public ABRP API, so endpoints may change without notice.\n- Some values read **unknown** while the vehicle is asleep/parked (e.g. speed,\n  power, voltage) — ABRP only reports them while the car is active, and they\n  populate again once it is. Driving/parked is inferred from charging, sleep and\n  speed when ABRP doesn't report it directly.\n\n## Disclaimer\n\nThis is an unofficial, community-built project. It is **not affiliated with,\nendorsed by, or associated with** A Better Route Planner, Iternio, or Rivian in\nany way. \"A Better Route Planner\", \"ABRP\", \"Iternio\" and \"Rivian\" are\ntrademarks of their respective owners and are used here only to describe what\nthis integration interoperates with. Use at your own risk.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichelfr%2Fha-abrp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichelfr%2Fha-abrp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichelfr%2Fha-abrp/lists"}