explaingit

mikrohard/hass-vw-eu-data-act

Analysis updated 2026-05-18

25PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

A Home Assistant integration that pulls Volkswagen's EU Data Act telemetry portal into trackable sensors like battery charge, odometer, and door locks.

Mindmap

mindmap
  root((repo))
    What it does
      VW EU Data Act integration
      Home Assistant sensors
      Vehicle telemetry tracking
    Tech stack
      Python
      Home Assistant
      HACS
    Use cases
      Track battery and charging
      Monitor door and brake status
      Debug login issues
    Audience
      VW EU owners with Home Assistant
    Caveats
      No historical data import
      Requires portal data stream activated

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Track your Volkswagen's battery charge, charging power, and charge state inside Home Assistant.

USE CASE 2

Monitor odometer, interior temperature, door lock, and parking brake status as home automation sensors.

USE CASE 3

Enable extra diagnostic sensors beyond the default curated set for deeper vehicle data.

USE CASE 4

Debug Volkswagen ID login problems using the bundled command-line tool.

What is it built with?

PythonHome AssistantHACS

How does it compare?

mikrohard/hass-vw-eu-data-actalexrosbach/replibookarlandaren/proagents
Stars252525
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/52/51/5
Audiencegeneralops devopsvibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires activating a 15-minute continuous data request on the Volkswagen portal before the integration has anything to fetch.

In plain English

This project is a custom integration for Home Assistant that pulls in live data from Volkswagen's EU Data Act portal and turns it into trackable sensors. Under EU data regulations, Volkswagen is required to make your vehicle's telemetry available to you, and this portal generates a snapshot of that data roughly every 15 minutes. The integration downloads those snapshots automatically and makes the values visible inside your Home Assistant dashboard. Once set up, you log in with your Volkswagen ID credentials and select which car to monitor. The integration then provides a set of ready-to-use sensors covering things like battery charge level, target charge setting, current charging power, odometer, interior temperatures, charge state, door lock status, and whether the parking brake is engaged. Anything beyond that curated set is also exposed as a diagnostic sensor, disabled by default, that you can turn on individually if you want it. Before the integration will work, you need to set up a continuous data request on the Volkswagen portal itself. The integration only downloads data that the portal is already generating. If you have not activated a 15-minute data stream on your account, there is nothing for it to fetch. The setup steps for enabling that are described in the README. Installation can be done through HACS, which is a community add-on manager for Home Assistant, or manually by copying the component folder into the right directory. After restarting Home Assistant, you add it like any other integration through the settings menu. One noted limitation is that the integration does not import historical data. It only records values from the moment it is running. There is also a bundled command-line tool for debugging login problems outside Home Assistant, and a script for regenerating the data field dictionary from an updated official PDF. The project is licensed under MIT.

Copy-paste prompts

Prompt 1
Walk me through activating the 15-minute data stream on my Volkswagen EU Data Act portal.
Prompt 2
How do I install this integration through HACS in Home Assistant?
Prompt 3
Which sensors does this integration expose by default versus as optional diagnostics?
Prompt 4
Help me troubleshoot a Volkswagen ID login failure using the bundled debug tool.

Frequently asked questions

What is hass-vw-eu-data-act?

A Home Assistant integration that pulls Volkswagen's EU Data Act telemetry portal into trackable sensors like battery charge, odometer, and door locks.

What language is hass-vw-eu-data-act written in?

Mainly Python. The stack also includes Python, Home Assistant, HACS.

How hard is hass-vw-eu-data-act to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is hass-vw-eu-data-act for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.