{"id":13622369,"url":"https://github.com/audiconnect/audi_connect_ha","last_synced_at":"2026-05-29T00:00:51.723Z","repository":{"id":37087273,"uuid":"186347733","full_name":"audiconnect/audi_connect_ha","owner":"audiconnect","description":"Adds an audi connect integration to home assistant","archived":false,"fork":false,"pushed_at":"2026-04-27T21:37:18.000Z","size":1436,"stargazers_count":327,"open_issues_count":19,"forks_count":113,"subscribers_count":26,"default_branch":"master","last_synced_at":"2026-04-27T23:23:04.484Z","etag":null,"topics":["audi","audi-connect","hacs-integration","homeassistant","integration","sensors"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/audiconnect.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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":"2019-05-13T04:55:01.000Z","updated_at":"2026-04-22T17:07:46.000Z","dependencies_parsed_at":"2024-02-01T07:28:11.321Z","dependency_job_id":"31e76e3e-9347-4c9c-9259-36a69669ec97","html_url":"https://github.com/audiconnect/audi_connect_ha","commit_stats":null,"previous_names":["arjenvrh/audi_connect_ha"],"tags_count":57,"template":false,"template_full_name":null,"purl":"pkg:github/audiconnect/audi_connect_ha","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/audiconnect%2Faudi_connect_ha","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/audiconnect%2Faudi_connect_ha/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/audiconnect%2Faudi_connect_ha/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/audiconnect%2Faudi_connect_ha/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/audiconnect","download_url":"https://codeload.github.com/audiconnect/audi_connect_ha/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/audiconnect%2Faudi_connect_ha/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33630999,"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-05-28T02:00:06.440Z","response_time":99,"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":["audi","audi-connect","hacs-integration","homeassistant","integration","sensors"],"created_at":"2024-08-01T21:01:18.209Z","updated_at":"2026-05-29T00:00:51.702Z","avatar_url":"https://github.com/audiconnect.png","language":"Python","funding_links":[],"categories":["Python","Custom Integrations"],"sub_categories":["🚗 Cars \u0026 EV charging"],"readme":"# Audi Connect Integration for Home Assistant\n\n[![GitHub Activity][commits-shield]][commits]\n[![License][license-shield]](LICENSE.md)\n[![Code Style][blackbadge]][black]\n[![hacs][hacsbadge]](hacs)\n\n## Notices\n\nDue to API changes, **currently not all functionality is available**. Please open a issue to report the topics you are missing.\n\n⚠️ Warning: Excessive use of certain features in this integration may result in temporary or permanent suspension of your Audi Connect account. Please use responsibly — abuse or misuse could potentially impact access for the entire community. Use at your own risk.\n\n## Maintainers Wanted\n\n- Looking for maintainers for Translation documents.\n- Always looking for more help from the community. If you can resolve an issue, please submit a PR or reach out to the maintainers with the working code.\n\n## Description\n\nThe `audiconnect` component provides an integration with the Audi Connect cloud service. It adds presence detection, sensors such as range, mileage, and fuel level, and provides car actions such as locking/unlocking and setting the pre-heater.\n\n**Note:** Certain functions require special permissions from Audi, such as position update via GPS.\n\nCredit for initial API discovery go to the guys at the ioBroker VW-Connect forum, who were able to figure out how the API and the PIN hashing works. Also some implementation credit to davidgiga1993 of the original [AudiAPI](https://github.com/davidgiga1993/AudiAPI) Python package, on which some of this code is loosely based.\n\nFull credit for this integration goes to @arjenvrh for their outstanding work in putting it all together. We wouldn’t have this without their contributions.\n\n## Installation\n\nThere are two ways this integration can be installed into [Home Assistant](https://www.home-assistant.io).\n\nThe easiest and recommended way is to install the integration using [HACS](https://hacs.xyz), which makes future updates easy to track and install.\n\nAlternatively, installation can be done manually by copying the files in this repository into the `custom_components` directory in the Home Assistant configuration directory:\n\n1. Open the configuration directory of your Home Assistant installation.\n2. If you do not have a `custom_components` directory, create it.\n3. In the `custom_components` directory, create a new directory called `audiconnect`.\n4. Copy all files from the `custom_components/audiconnect/` directory in this repository into the `audiconnect` directory.\n5. Restart Home Assistant.\n6. Add the integration to Home Assistant (see **Configuration**).\n\n## Configuration\n\nConfiguration is done through the Home Assistant UI.\n\nTo add the integration, go to **Settings ➤ Devices \u0026 Services ➤ Integrations**, click **➕ Add Integration**, and search for \"Audi Connect\".\n\n### Configuration Variables\n\n| Name            | Type     | Default | Description                                                                                                                                                                                                                          |\n| --------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `Username`      | `string` | –       | The username associated with your Audi Connect account.                                                                                                                                                                              |\n| `Password`      | `string` | –       | The password for your Audi Connect account.                                                                                                                                                                                          |\n| `S-PIN`         | `string` | –       | The S-PIN for your Audi Connect account to perform certain service actions.\u003cbr\u003e(**Optional**)                                                                                                                                        |\n| `Region`        | `string` | `DE`    | The region where your Audi Connect account is registered:\u003cbr\u003e• `DE` – Europe\u003cbr\u003e• `US` – United States\u003cbr\u003e• `CA` – Canada\u003cbr\u003e• `CN` – China                                                                                          |\n| `Scan Interval` | `int`    | `15`    | Frequency (in minutes) to fetch status data from Audi Connect.\u003cbr\u003eMinimum allowed is 15 minutes.\u003cbr\u003e\\* _Can be updated later via the CONFIGURE menu._                                                                                |\n| `API Level`     | `int`    | `0`     | Determines the API structure used for service action calls:\u003cbr\u003e• `0` – _Typically_ Gas vehicles (legacy format)\u003cbr\u003e• `1` – _Typically_ e-tron (electric vehicles, newer format)\u003cbr\u003e\\* _Can be updated later via the CONFIGURE menu._ |\n\n## Options\n\nFind configuration options under **Settings ➤ Devices \u0026 Services ➤ Integrations ➤ Audi Connect ➤ Configure**:\n\n| Name                              | Type   | Description                                                                                                                                                                     |\n| --------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `Cloud Update at Startup`         | `bool` | Toggle the initial cloud update when the integration starts. Useful for development or frequent Home Assistant restarts.                                                        |\n| `Active Polling at Scan Interval` | `bool` | Enable or disable active polling.                                                                                                                                               |\n| `Scan Interval`                   | `int`  | Defines polling frequency in minutes (minimum 15). Only effective if **Active Polling** is enabled.                                                                             |\n| `API Level`                       | `int`  | Determines the API structure used for service action calls:\u003cbr\u003e• `0` – _Typically_ Gas vehicles (legacy format)\u003cbr\u003e• `1` – _Typically_ e-tron (electric vehicles, newer format) |\n\n_Note: The integration will reload automatically upon clicking `Submit`, but a Home Assistant restart is suggested._\n\n## Service Actions\n\n### Audi Connect: Refresh Vehicle Data\n\n`audiconnect.refresh_vehicle_data`\n\nNormal updates retrieve data from the Audi Connect cloud service, and don't interact directly with the vehicle. _This_ service action triggers an update request from the vehicle itself. When data is retrieved successfully, Home Assistant is automatically updated. The service action requires a vehicle identification number (VIN) as a parameter.\n\n#### Parameters\n\n- **`vin`**: The Vehicle Identification Number (VIN) of the Audi you want to control.\n\n### Audi Connect: Refresh Cloud Data\n\n`audiconnect.refresh_cloud_data`\n\n_This_ service action triggers an update request from the cloud.\n\n- Functionality: Updates data for all vehicles from the online source, mirroring the action performed at integration startup or during scheduled refresh intervals.\n- Behavior: Does not force a vehicle-side data refresh. Consequently, if vehicles haven't recently pushed updates, retrieved data might be outdated.\n- Note: This service action replicates the function of active polling without scheduling, offering a more granular control over data refresh moments.\n- **IMPORTANT:** This service action has no built in usage limits. Excessive use may result in a temporary suspension of your account.\n\n#### Parameters\n\n- `none`\n\n### Audi Connect: Execute Vehicle Action\n\n`audiconnect.execute_vehicle_action`\n\nThis service action allows you to perform actions on your Audi vehicle, specified by the vehicle identification number (VIN) and the desired action.\n\n#### Service Parameters\n\n- **`vin`**: The Vehicle Identification Number (VIN) of the Audi you want to control.\n- **`action`**: The specific action to perform on the vehicle. Available actions include:\n  - **`lock`**: Lock the vehicle.\n  - **`unlock`**: Unlock the vehicle.\n  - **`start_climatisation`**: Start the vehicle's climatisation system. (Legacy) -- Deprecated\n  - **`stop_climatisation`**: Stop the vehicle's climatisation system.\n  - **`start_charger`**: Start charging the vehicle.\n  - **`start_timed_charger`**: Start the vehicle's charger with a timer.\n  - **`stop_charger`**: Stop charging the vehicle.\n  - **`start_preheater`**: Start the vehicle's preheater system. (Legacy) -- Deprecated\n  - **`stop_preheater`**: Stop the vehicle's preheater system.\n  - **`start_window_heating`**: Start heating the vehicle's windows.\n  - **`stop_window_heating`**: Stop heating the vehicle's windows.\n\n#### Usage Example\n\nTo initiate the lock action for a vehicle with VIN `WAUZZZ4G7EN123456`, use the following service call:\n\n```yaml\nservice: audiconnect.execute_vehicle_action\ndata:\n  vin: \"WAUZZZ4G7EN123456\"\n  action: \"lock\"\n```\n\n#### Notes\n\n- Certain service actions require the S-PIN to be set in the configuration.\n- When the service action is successfully performed, an update request is automatically triggered.\n\n### Audi Connect: Start Climate Control\n\n`audiconnect.start_climate_control`\n\nThis service action allows you to start the climate control with options for temperature, glass surface heating, and auto seat comfort.\n\n#### Parameters\n\n- **`vin`**: The Vehicle Identification Number (VIN) of the Audi you want to control.\n- **`temp_f`** (_optional_): Desired temperature in Fahrenheit. Default is `70`.\n- **`temp_c`** (_optional_): Desired temperature in Celsius. Default is `21`.\n- **`glass_heating`** (_optional_): Enable (`True`) or disable (`False`) glass heating. Default is `False`.\n- **`seat_fl`** (_optional_): Enable (`True`) or disable (`False`) the front-left seat heater. Default is `False`.\n- **`seat_fr`** (_optional_): Enable (`True`) or disable (`False`) the front-right seat heater. Default is `False`.\n- **`seat_rl`** (_optional_): Enable (`True`) or disable (`False`) the rear-left seat heater. Default is `False`.\n- **`seat_rr`** (_optional_): Enable (`True`) or disable (`False`) the rear-right seat heater. Default is `False`.\n\n#### Usage Example\n\nTo start the climate control for a vehicle with VIN `WAUZZZ4G7EN123456` with a temperature of 72°F, enable glass heating, and activate both front seat heaters, use the following service call:\n\n```yaml\nservice: audiconnect.start_climate_control\ndata:\n  vin: \"WAUZZZ4G7EN123456\"\n  temp_f: 72\n  glass_heating: True\n  seat_fl: True\n  seat_fr: True\n```\n\n#### Notes\n\n- The `temp_f` and `temp_c` parameters are mutually exclusive. If both are provided, `temp_f` takes precedence.\n- If neither `temp_f` nor `temp_c` is provided, the system defaults to 70°F or 21°C.\n- When the service action is successfully performed, an update request is automatically triggered.\n\n### Audi Connect: Start Auxiliary Heating\n\n`audiconnect.start_auxiliary_heating`\n\nThis service action allows you to start auxiliary heating the vehicle, with option for duration.\n\n#### Parameters\n\n- **`vin`**: The Vehicle Identification Number (VIN) of the Audi you want to control.\n- **`duration`** (_optional_): The number of minutes the auxiliary heater should run before turning off. Default is `20` minutes if not provided.\n\n#### Usage Example\n\nTo start the auxiliary heater for a vehicle with VIN `WAUZZZ4G7EN123456`, and a duration of 40 minutes, use the following service call action:\n\n```yaml\nservice: audiconnect.start_auxiliary_heating\ndata:\n  vin: \"WAUZZZ4G7EN123456\"\n  duration: 40\n```\n\n#### Notes\n\n- Requires the S-PIN to be set in the configuration.\n- When the service action is successfully performed, an update request is automatically triggered.\n\n## Example Dashboard Card\n\nBelow is an example Dashboard (Lovelace) card illustrating some of the sensors this Home Assistant addon provides.\n\n![Example Dashboard Card](card_example.png)\n\nThe card requires the following front end mods:\n\n- https://github.com/thomasloven/lovelace-card-mod\n- https://github.com/custom-cards/circle-sensor-card\n\nThese mods can (like this integration) be installed using HACS.\n\nThe card uses the following code in `ui-lovelace.yaml` (or wherever your Dashboard is configured).\n\n```yaml\n     - type: picture-elements\n        image: /local/pictures/audi_sq7.jpeg\n        style: |\n          ha-card {\n            border-radius: 10px;\n            border: solid 1px rgba(100,100,100,0.3);\n            box-shadow: 3px 3px rgba(0,0,0,0.4);\n            overflow: hidden;\n          }\n        elements:\n        - type: image\n          image: /local/pictures/cardbackK.png\n          style:\n            left: 50%\n            top: 90%\n            width: 100%\n            height: 60px\n\n        - type: icon\n          icon: mdi:car-door\n          entity: sensor.doors_trunk_sq7\n          tap_action: more_info\n          style: {color: white, left: 10%, top: 86%}\n        - type: state-label\n          entity: sensor.doors_trunk_sq7\n          style: {color: white, left: 10%, top: 95%}\n\n        - type: state-icon\n          entity: sensor.windows_sq7\n          tap_action: more_info\n          style: {color: white, left: 30%, top: 86%}\n        - type: state-label\n          entity: sensor.windows_sq7\n          style: {color: white, left: 30%, top: 95%}\n\n        - type: icon\n          icon: mdi:oil\n          entity: sensor.audi_sq7_oil_level\n          tap_action: more_info\n          style: {color: white, left: 50%, top: 86%}\n        - type: state-label\n          entity: sensor.audi_sq7_oil_level\n          style: {color: white, left: 50%, top: 95%}\n\n        - type: icon\n          icon: mdi:room-service-outline\n          entity: sensor.audi_sq7_service_inspection_time\n          tap_action: more_info\n          style: {color: white, left: 70%, top: 86%}\n        - type: state-label\n          entity: sensor.audi_sq7_service_inspection_time\n          style: {color: white, left: 70%, top: 95%}\n\n        - type: icon\n          icon: mdi:speedometer\n          entity: sensor.audi_sq7_mileage\n          tap_action: more_info\n          style: {color: white, left: 90%, top: 86%}\n        - type: state-label\n          entity: sensor.audi_sq7_mileage\n          style: {color: white, left: 90%, top: 95%}\n\n        - type: custom:circle-sensor-card\n          entity: sensor.audi_sq7_tank_level\n          max: 100\n          min: 0\n          stroke_width: 15\n          gradient: true\n          fill: '#aaaaaabb'\n          name: tank\n          units: ' '\n          font_style:\n            font-size: 1.0em\n            font-color: white\n            text-shadow: '1px 1px black'\n          style:\n            top: 5%\n            left: 80%\n            width: 4em\n            height: 4em\n            transform: none\n\n        - type: custom:circle-sensor-card\n          entity: sensor.audi_sq7_range\n          max: 630\n          min: 0\n          stroke_width: 15\n          gradient: true\n          fill: '#aaaaaabb'\n          name: range\n          units: ' '\n          font_style:\n            font-size: 1.0em\n            font-color: white\n            text-shadow: '1px 1px black'\n          style:\n            top: 5%\n            left: 5%\n            width: 4em\n            height: 4em\n            transform: none\n```\n\n[commits-shield]: https://img.shields.io/github/commit-activity/y/audiconnect/audi_connect_ha?style=for-the-badge\n[commits]: https://github.com/audiconnect/audi_connect_ha/commits/master\n[hacs]: https://github.com/custom-components/hacs\n[hacsbadge]: https://img.shields.io/badge/HACS-Default-orange.svg?style=for-the-badge\n[license-shield]: https://img.shields.io/github/license/audiconnect/audi_connect_ha?style=for-the-badge\n[maintenance-shield]: https://img.shields.io/badge/maintainer-audiconnect-blue.svg?style=for-the-badge\n[blackbadge]: https://img.shields.io/badge/code%20style-black-000000.svg?style=for-the-badge\n[black]: https://github.com/ambv/black\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faudiconnect%2Faudi_connect_ha","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faudiconnect%2Faudi_connect_ha","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faudiconnect%2Faudi_connect_ha/lists"}