# CarConnectivity Connector for Audi
A Python connector for Audi vehicles that integrates with the [CarConnectivity framework](https://github.com/tillsteinbach/CarConnectivity) by Till Steinbach, allowing you to interact with your Audi vehicle's data and controls through a standardized API.
## About CarConnectivity
This connector is built for the [CarConnectivity](https://github.com/tillsteinbach/CarConnectivity) framework, which provides a unified interface for connecting to various car manufacturers' APIs. CarConnectivity is developed and maintained by [Till Steinbach](https://github.com/tillsteinbach).
## Features
- 🚗 **Vehicle Status**: Access battery/fuel levels, range, odometer readings
- 🔐 **Remote Control**: Lock/unlock doors, start/stop charging and climatization
- 📍 **Location Services**: Get vehicle position and parking information
- 🔧 **Maintenance**: Check inspection and service due dates
- 🌡️ **Climate Control**: Remote climate control and window heating
- 💡 **Vehicle Lights**: Monitor and control vehicle lighting
- ⚡ **Charging**: Monitor and control electric vehicle charging
## Installation
Install the connector using pip:
```bash
pip install carconnectivity-connector-audi
```
You'll also need the CarConnectivity CLI:
```bash
pip install carconnectivity-cli
```
For more information about the CarConnectivity framework, visit:
- **Main Repository**: [CarConnectivity](https://github.com/tillsteinbach/CarConnectivity)
- **CLI Repository**: [CarConnectivity-CLI](https://github.com/tillsteinbach/CarConnectivity-cli)
- **Documentation**: See the [CarConnectivity Wiki](https://github.com/tillsteinbach/CarConnectivity/wiki)
## Configuration
### Quick Start with Template
1. Copy the provided template and customize it with your credentials:
```bash
cp audi_config_template.json audi_config.json
# Edit audi_config.json with your actual Audi credentials
```
2. Or create a configuration file manually (e.g., `audi_config.json`) with your Audi credentials:
```json
{
"carConnectivity": {
"connectors": [
{
"type": "audi",
"config": {
"username": "your.email@example.com",
"password": "your_password"
}
}
]
}
}
```
## Usage
### List all available resources
```bash
carconnectivity-cli audi_config.json list
```
### Get vehicle state
```bash
carconnectivity-cli audi_config.json get /garage/YOUR_VIN/state
```
### Get battery/fuel level
```bash
carconnectivity-cli audi_config.json get /garage/YOUR_VIN/drives/primary/level
```
### Get vehicle position
```bash
carconnectivity-cli audi_config.json get /garage/YOUR_VIN/position/latitude
carconnectivity-cli audi_config.json get /garage/YOUR_VIN/position/longitude
```
### Control charging (for electric vehicles)
```bash
carconnectivity-cli audi_config.json set /garage/YOUR_VIN/charging/commands/start-stop start
```
### Control climatization
```bash
carconnectivity-cli audi_config.json set /garage/YOUR_VIN/climatization/commands/start-stop start
```
### Lock/unlock doors
```bash
carconnectivity-cli audi_config.json set /garage/YOUR_VIN/doors/commands/lock-unlock lock
```
## Running with Docker
You can run the Audi connector using Docker with the [CarConnectivity-MQTT](https://github.com/tillsteinbach/CarConnectivity-plugin-mqtt) image made by Till. This allows you to publish vehicle data to an MQTT broker for integration with home automation systems.
### Docker Compose Setup
Create a `docker-compose.yml` file:
```yaml
services:
carconnectivity-mqtt:
image: "tillsteinbach/carconnectivity-mqtt:latest"
environment:
- ADDITIONAL_INSTALLS=carconnectivity-connector-audi
- TZ=Europe/Berlin # Set your timezone
volumes:
- ./carconnectivity.json:/carconnectivity.json
restart: unless-stopped
```
### Configuration for Docker
Create a `carconnectivity.json` configuration file:
```json
{
"carConnectivity": {
"log_level": "info",
"connectors": [
{
"type": "audi",
"config": {
"interval": 600,
"username": "your.email@example.com",
"password": "your_password"
}
}
],
"plugins": [
{
"type": "mqtt",
"config": {
"broker": "192.168.1.100",
"port": 1883,
"username": "mqtt_user",
"password": "mqtt_password"
}
}
]
}
}
```
### Running the Container
```bash
docker-compose up -d
```
For detailed Docker configuration options, refer to the [CarConnectivity-MQTT Docker documentation](https://github.com/tillsteinbach/CarConnectivity-plugin-mqtt/blob/main/docker/README.md).
## Development
### Building from source
1. Clone the repository:
```bash
git clone https://github.com/acfischer42/CarConnectivity-connector-audi.git
cd CarConnectivity-connector-audi
```
2. Create a virtual environment:
```bash
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
```
3. Install dependencies:
```bash
pip install build
```
4. Build the package:
```bash
python -m build
```
5. Install locally:
```bash
pip install dist/carconnectivity_connector_audi-*.whl
```
## Requirements
- Python 3.9 or higher
- [CarConnectivity framework](https://github.com/tillsteinbach/CarConnectivity) >= 0.8
- Valid myAudi account with connected vehicle
## Related Projects
This connector is part of the CarConnectivity ecosystem:
- **[CarConnectivity](https://github.com/tillsteinbach/CarConnectivity)** - The main framework by Till Steinbach
- **[CarConnectivity-CLI](https://github.com/tillsteinbach/CarConnectivity-cli)** - Command-line interface
- **[WeConnect-python](https://github.com/tillsteinbach/WeConnect-python)** - Volkswagen connector
- **[VWConnect](https://github.com/tillsteinbach/VWConnect)** - Alternative VW solution
## Supported Vehicles
This connector works with Audi vehicles that support myAudi connected services, including:
- Electric vehicles (e-tron models)
- Hybrid vehicles
- Modern ICE vehicles with connectivity features
## Security
- Credentials are securely handled through OAuth2 authentication
- Tokens are cached locally and refreshed automatically
- No credentials are stored in plain text after initial setup
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## Credits
- **Till Steinbach** for creating the [CarConnectivity framework](https://github.com/tillsteinbach/CarConnectivity)
- Based on authentication patterns from the broader CarConnectivity ecosystem
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Disclaimer
This is an unofficial connector not affiliated with Audi AG or Till Steinbach's original CarConnectivity project. Use at your own risk and ensure you comply with your vehicle's terms of service.
Raw data
{
"_id": null,
"home_page": null,
"name": "carconnectivity-connector-audi",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "audi, car, connectivity, api, myaudi, automotive, carconnectivity",
"author": "Achim Fischer based on work of Till Steinbach",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/67/e8/e68c70ae7a3e35bf56c2cc1394eb5c3b990eb6c69113ce604256e8478a2d/carconnectivity_connector_audi-0.2.0.tar.gz",
"platform": null,
"description": "# CarConnectivity Connector for Audi\n\nA Python connector for Audi vehicles that integrates with the [CarConnectivity framework](https://github.com/tillsteinbach/CarConnectivity) by Till Steinbach, allowing you to interact with your Audi vehicle's data and controls through a standardized API.\n\n## About CarConnectivity\n\nThis connector is built for the [CarConnectivity](https://github.com/tillsteinbach/CarConnectivity) framework, which provides a unified interface for connecting to various car manufacturers' APIs. CarConnectivity is developed and maintained by [Till Steinbach](https://github.com/tillsteinbach).\n\n## Features\n\n- \ud83d\ude97 **Vehicle Status**: Access battery/fuel levels, range, odometer readings\n- \ud83d\udd10 **Remote Control**: Lock/unlock doors, start/stop charging and climatization\n- \ud83d\udccd **Location Services**: Get vehicle position and parking information\n- \ud83d\udd27 **Maintenance**: Check inspection and service due dates\n- \ud83c\udf21\ufe0f **Climate Control**: Remote climate control and window heating\n- \ud83d\udca1 **Vehicle Lights**: Monitor and control vehicle lighting\n- \u26a1 **Charging**: Monitor and control electric vehicle charging\n\n## Installation\n\nInstall the connector using pip:\n\n```bash\npip install carconnectivity-connector-audi\n```\n\nYou'll also need the CarConnectivity CLI:\n\n```bash\npip install carconnectivity-cli\n```\n\nFor more information about the CarConnectivity framework, visit:\n- **Main Repository**: [CarConnectivity](https://github.com/tillsteinbach/CarConnectivity)\n- **CLI Repository**: [CarConnectivity-CLI](https://github.com/tillsteinbach/CarConnectivity-cli)\n- **Documentation**: See the [CarConnectivity Wiki](https://github.com/tillsteinbach/CarConnectivity/wiki)\n\n## Configuration\n\n### Quick Start with Template\n\n1. Copy the provided template and customize it with your credentials:\n ```bash\n cp audi_config_template.json audi_config.json\n # Edit audi_config.json with your actual Audi credentials\n ```\n\n2. Or create a configuration file manually (e.g., `audi_config.json`) with your Audi credentials:\n\n```json\n{\n \"carConnectivity\": {\n \"connectors\": [\n {\n \"type\": \"audi\",\n \"config\": {\n \"username\": \"your.email@example.com\",\n \"password\": \"your_password\"\n }\n }\n ]\n }\n}\n```\n\n## Usage\n\n### List all available resources\n```bash\ncarconnectivity-cli audi_config.json list\n```\n\n### Get vehicle state\n```bash\ncarconnectivity-cli audi_config.json get /garage/YOUR_VIN/state\n```\n\n### Get battery/fuel level\n```bash\ncarconnectivity-cli audi_config.json get /garage/YOUR_VIN/drives/primary/level\n```\n\n### Get vehicle position\n```bash\ncarconnectivity-cli audi_config.json get /garage/YOUR_VIN/position/latitude\ncarconnectivity-cli audi_config.json get /garage/YOUR_VIN/position/longitude\n```\n\n### Control charging (for electric vehicles)\n```bash\ncarconnectivity-cli audi_config.json set /garage/YOUR_VIN/charging/commands/start-stop start\n```\n\n### Control climatization\n```bash\ncarconnectivity-cli audi_config.json set /garage/YOUR_VIN/climatization/commands/start-stop start\n```\n\n### Lock/unlock doors\n```bash\ncarconnectivity-cli audi_config.json set /garage/YOUR_VIN/doors/commands/lock-unlock lock\n```\n\n## Running with Docker\n\nYou can run the Audi connector using Docker with the [CarConnectivity-MQTT](https://github.com/tillsteinbach/CarConnectivity-plugin-mqtt) image made by Till. This allows you to publish vehicle data to an MQTT broker for integration with home automation systems.\n\n### Docker Compose Setup\n\nCreate a `docker-compose.yml` file:\n\n```yaml\nservices:\n carconnectivity-mqtt:\n image: \"tillsteinbach/carconnectivity-mqtt:latest\"\n environment:\n - ADDITIONAL_INSTALLS=carconnectivity-connector-audi\n - TZ=Europe/Berlin # Set your timezone\n volumes:\n - ./carconnectivity.json:/carconnectivity.json\n restart: unless-stopped\n```\n\n### Configuration for Docker\n\nCreate a `carconnectivity.json` configuration file:\n\n```json\n{\n \"carConnectivity\": {\n \"log_level\": \"info\",\n \"connectors\": [\n {\n \"type\": \"audi\",\n \"config\": {\n \"interval\": 600,\n \"username\": \"your.email@example.com\",\n \"password\": \"your_password\"\n }\n }\n ],\n \"plugins\": [\n {\n \"type\": \"mqtt\",\n \"config\": {\n \"broker\": \"192.168.1.100\",\n \"port\": 1883,\n \"username\": \"mqtt_user\",\n \"password\": \"mqtt_password\"\n }\n }\n ]\n }\n}\n```\n\n### Running the Container\n\n```bash\ndocker-compose up -d\n```\n\n\nFor detailed Docker configuration options, refer to the [CarConnectivity-MQTT Docker documentation](https://github.com/tillsteinbach/CarConnectivity-plugin-mqtt/blob/main/docker/README.md).\n\n## Development\n\n### Building from source\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/acfischer42/CarConnectivity-connector-audi.git\ncd CarConnectivity-connector-audi\n```\n\n2. Create a virtual environment:\n```bash\npython -m venv .venv\nsource .venv/bin/activate # On Windows: .venv\\Scripts\\activate\n```\n\n3. Install dependencies:\n```bash\npip install build\n```\n\n4. Build the package:\n```bash\npython -m build\n```\n\n5. Install locally:\n```bash\npip install dist/carconnectivity_connector_audi-*.whl\n```\n\n## Requirements\n\n- Python 3.9 or higher\n- [CarConnectivity framework](https://github.com/tillsteinbach/CarConnectivity) >= 0.8\n- Valid myAudi account with connected vehicle\n\n## Related Projects\n\nThis connector is part of the CarConnectivity ecosystem:\n\n- **[CarConnectivity](https://github.com/tillsteinbach/CarConnectivity)** - The main framework by Till Steinbach\n- **[CarConnectivity-CLI](https://github.com/tillsteinbach/CarConnectivity-cli)** - Command-line interface\n- **[WeConnect-python](https://github.com/tillsteinbach/WeConnect-python)** - Volkswagen connector\n- **[VWConnect](https://github.com/tillsteinbach/VWConnect)** - Alternative VW solution\n\n## Supported Vehicles\n\nThis connector works with Audi vehicles that support myAudi connected services, including:\n- Electric vehicles (e-tron models)\n- Hybrid vehicles\n- Modern ICE vehicles with connectivity features\n\n## Security\n\n- Credentials are securely handled through OAuth2 authentication\n- Tokens are cached locally and refreshed automatically\n- No credentials are stored in plain text after initial setup\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Credits\n\n- **Till Steinbach** for creating the [CarConnectivity framework](https://github.com/tillsteinbach/CarConnectivity)\n- Based on authentication patterns from the broader CarConnectivity ecosystem\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Disclaimer\n\nThis is an unofficial connector not affiliated with Audi AG or Till Steinbach's original CarConnectivity project. Use at your own risk and ensure you comply with your vehicle's terms of service.\n",
"bugtrack_url": null,
"license": null,
"summary": "CarConnectivity connector for Audi services - integrates with Till Steinbach's CarConnectivity framework",
"version": "0.2.0",
"project_urls": {
"CarConnectivity CLI": "https://github.com/tillsteinbach/CarConnectivity-cli",
"CarConnectivity Framework": "https://github.com/tillsteinbach/CarConnectivity",
"Homepage": "https://github.com/acfischer42/CarConnectivity-connector-audi",
"Issues": "https://github.com/acfischer42/CarConnectivity-connector-audi/issues",
"Repository": "https://github.com/acfischer42/CarConnectivity-connector-audi"
},
"split_keywords": [
"audi",
" car",
" connectivity",
" api",
" myaudi",
" automotive",
" carconnectivity"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8d133bb863b572915497414558766c86ea306743f7b716da730089b6f33505a6",
"md5": "eaa77cf1ffb906e8a03bfbb0f9d1be04",
"sha256": "193d8d8fdf9a90fea2b37c3a102dd20bfd6ed3fe9896a06b62074a64bc9973f3"
},
"downloads": -1,
"filename": "carconnectivity_connector_audi-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "eaa77cf1ffb906e8a03bfbb0f9d1be04",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 60375,
"upload_time": "2025-10-18T21:33:16",
"upload_time_iso_8601": "2025-10-18T21:33:16.098749Z",
"url": "https://files.pythonhosted.org/packages/8d/13/3bb863b572915497414558766c86ea306743f7b716da730089b6f33505a6/carconnectivity_connector_audi-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "67e8e68c70ae7a3e35bf56c2cc1394eb5c3b990eb6c69113ce604256e8478a2d",
"md5": "f2addd8d2a4263a4f99052958189cf11",
"sha256": "3c23bf8926734451aa9b1c1bcfcfd12064fc7234fdcf3ff561554e3ba0828fe2"
},
"downloads": -1,
"filename": "carconnectivity_connector_audi-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "f2addd8d2a4263a4f99052958189cf11",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 77906,
"upload_time": "2025-10-18T21:33:17",
"upload_time_iso_8601": "2025-10-18T21:33:17.474445Z",
"url": "https://files.pythonhosted.org/packages/67/e8/e68c70ae7a3e35bf56c2cc1394eb5c3b990eb6c69113ce604256e8478a2d/carconnectivity_connector_audi-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-18 21:33:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tillsteinbach",
"github_project": "CarConnectivity-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "carconnectivity-connector-audi"
}
JSON
