# WeConnect-python
[](https://github.com/tillsteinbach/WeConnect-python/)
[](https://github.com/tillsteinbach/WeConnect-python/releases/latest)
[](https://github.com/tillsteinbach/WeConnect-python/blob/master/LICENSE)
[](https://github.com/tillsteinbach/WeConnect-python/issues)
[](https://pypi.org/project/weconnect/)
[](https://pypi.org/project/weconnect/)
[](https://www.paypal.com/donate?hosted_button_id=2BVFF5GJ9SXAJ)
[](https://github.com/sponsors/tillsteinbach)
Python API for the Volkswagen WeConnect Services. If you are not a developer and ended up here you probably want to check out a project using this library (see below).
## Projects in which the library is used
- [VWsFriend](https://github.com/tillsteinbach/VWsFriend): VWsFriend records statistics about your car (charging sessions, battery, trips, fueling, etc.) and displays them nicely. It also allows you to forward data from the car to other applications such as [A better routeplanner](https://abetterrouteplanner.com/) and allows you to integrate your car into [Apple HomeKit](https://www.apple.com/ios/home/)
- [WeConnect-cli](https://github.com/tillsteinbach/WeConnect-cli): A commandline interface to interact with WeConnect
- [WeConnect-MQTT](https://github.com/tillsteinbach/WeConnect-mqtt): A MQTT Client that provides WeConnect data to the MQTT Broker of your choice (e.g. your home automation solution such as [ioBroker](https://www.iobroker.net), [FHEM](https://fhem.de) or [Home Assistant](https://www.home-assistant.io))
## WARNING
Use this API with care. If you use it wrong (e.g. too many logins, repeated login attempts with wrong password, ...) your account may get blocked.
## Install
```
pip3 install weconnect[Images]
```
The minimum required python version is 3.8
## Getting started
- To get started have a look in the [examples folder](https://github.com/tillsteinbach/WeConnect-python/tree/main/examples)
## Tested with
- Volkswagen ID.3 Modelyear 2021
- Volkswagen Passat GTE Modelyear 2021
## Login & Consent
WeConnect-python is based on the new WeConnect API that was introduced with the new series of ID cars. If you use another car or hybrid you probably need to agree to the terms and conditions of the new WeConnect interface. Easiest to do so is by installing the Volkswagen app on your smartphone and login there. If necessary you will be asked to agree to the terms and conditions.
## Reporting Issues
Please feel free to open an issue at [GitHub Issue page](https://github.com/tillsteinbach/WeConnect-python/issues) to report problems you found.
### Known Issues
- The API is in alpha state and may change unexpectedly at any time! Please conscider this and pin to a specific version if you depend on it.
- Examples and API documentation is missing
## Credits
Inspired by [TA2k/ioBroker.vw-connect](https://github.com/TA2k/ioBroker.vw-connect/) that gave me a point to start working with the API
## Seat, Cupra, Skoda IV, ...
In an effort to try to make WeConnect-python also to work with latest generation of vehicles from other volkswagen brands I'm looking for users to temporarily share access to their accounts. If you are willing to support please send me a message.
- Already tried: Cupra Born (The API looks a bit different, maybe it is older, I will check again in some weeks), thanks to the user initdebugs
Raw data
{
"_id": null,
"home_page": "https://github.com/tillsteinbach/WeConnect-python",
"name": "weconnect",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "weconnect,we connect,carnet,car net,volkswagen,vw,telemetry",
"author": "Till Steinbach",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/96/0b/4ca55ed5754f7a8bfb891fa9158ec0aa82d6ccb7830c8004dab1b440168c/weconnect-0.60.2.tar.gz",
"platform": null,
"description": "\n\n# WeConnect-python\n[](https://github.com/tillsteinbach/WeConnect-python/)\n[](https://github.com/tillsteinbach/WeConnect-python/releases/latest)\n[](https://github.com/tillsteinbach/WeConnect-python/blob/master/LICENSE)\n[](https://github.com/tillsteinbach/WeConnect-python/issues)\n[](https://pypi.org/project/weconnect/)\n[](https://pypi.org/project/weconnect/)\n[](https://www.paypal.com/donate?hosted_button_id=2BVFF5GJ9SXAJ)\n[](https://github.com/sponsors/tillsteinbach)\n\nPython API for the Volkswagen WeConnect Services. If you are not a developer and ended up here you probably want to check out a project using this library (see below).\n\n## Projects in which the library is used\n- [VWsFriend](https://github.com/tillsteinbach/VWsFriend): VWsFriend records statistics about your car (charging sessions, battery, trips, fueling, etc.) and displays them nicely. It also allows you to forward data from the car to other applications such as [A better routeplanner](https://abetterrouteplanner.com/) and allows you to integrate your car into [Apple HomeKit](https://www.apple.com/ios/home/)\n- [WeConnect-cli](https://github.com/tillsteinbach/WeConnect-cli): A commandline interface to interact with WeConnect\n- [WeConnect-MQTT](https://github.com/tillsteinbach/WeConnect-mqtt): A MQTT Client that provides WeConnect data to the MQTT Broker of your choice (e.g. your home automation solution such as [ioBroker](https://www.iobroker.net), [FHEM](https://fhem.de) or [Home Assistant](https://www.home-assistant.io))\n\n## WARNING\nUse this API with care. If you use it wrong (e.g. too many logins, repeated login attempts with wrong password, ...) your account may get blocked.\n\n## Install\n```\npip3 install weconnect[Images]\n```\nThe minimum required python version is 3.8\n\n## Getting started\n- To get started have a look in the [examples folder](https://github.com/tillsteinbach/WeConnect-python/tree/main/examples)\n\n## Tested with\n- Volkswagen ID.3 Modelyear 2021\n- Volkswagen Passat GTE Modelyear 2021\n\n## Login & Consent\nWeConnect-python is based on the new WeConnect API that was introduced with the new series of ID cars. If you use another car or hybrid you probably need to agree to the terms and conditions of the new WeConnect interface. Easiest to do so is by installing the Volkswagen app on your smartphone and login there. If necessary you will be asked to agree to the terms and conditions.\n\n## Reporting Issues\nPlease feel free to open an issue at [GitHub Issue page](https://github.com/tillsteinbach/WeConnect-python/issues) to report problems you found.\n\n### Known Issues\n- The API is in alpha state and may change unexpectedly at any time! Please conscider this and pin to a specific version if you depend on it.\n- Examples and API documentation is missing\n\n## Credits\nInspired by [TA2k/ioBroker.vw-connect](https://github.com/TA2k/ioBroker.vw-connect/) that gave me a point to start working with the API\n\n## Seat, Cupra, Skoda IV, ...\nIn an effort to try to make WeConnect-python also to work with latest generation of vehicles from other volkswagen brands I'm looking for users to temporarily share access to their accounts. If you are willing to support please send me a message.\n- Already tried: Cupra Born (The API looks a bit different, maybe it is older, I will check again in some weeks), thanks to the user initdebugs\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python API for the Volkswagen WeConnect Services",
"version": "0.60.2",
"project_urls": {
"Bug Tracker": "https://github.com/tillsteinbach/WeConnect-python/issues",
"Funding": "https://github.com/sponsors/tillsteinbach",
"Homepage": "https://github.com/tillsteinbach/WeConnect-python",
"Source": "https://github.com/tillsteinbach/WeConnect-python"
},
"split_keywords": [
"weconnect",
"we connect",
"carnet",
"car net",
"volkswagen",
"vw",
"telemetry"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "de4027461353179ef255fe2f986958371603dc03f616032da2db328347e9f057",
"md5": "d327e629e73180eff638a163a9b6bbd6",
"sha256": "7d7ee54b3a4fb02a9739c2fbe42024ecb2fff781a01e76c6d171b7963b664c35"
},
"downloads": -1,
"filename": "weconnect-0.60.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d327e629e73180eff638a163a9b6bbd6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 165931,
"upload_time": "2024-02-28T22:40:30",
"upload_time_iso_8601": "2024-02-28T22:40:30.353275Z",
"url": "https://files.pythonhosted.org/packages/de/40/27461353179ef255fe2f986958371603dc03f616032da2db328347e9f057/weconnect-0.60.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "960b4ca55ed5754f7a8bfb891fa9158ec0aa82d6ccb7830c8004dab1b440168c",
"md5": "cb4e63e904d6e1e4f7f93b2b8bcbe913",
"sha256": "12cbfd19c9d0e2f9f9e503db45aa661e02acd25a95d8372c61ac90a03a554407"
},
"downloads": -1,
"filename": "weconnect-0.60.2.tar.gz",
"has_sig": false,
"md5_digest": "cb4e63e904d6e1e4f7f93b2b8bcbe913",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 130656,
"upload_time": "2024-02-28T22:40:33",
"upload_time_iso_8601": "2024-02-28T22:40:33.647474Z",
"url": "https://files.pythonhosted.org/packages/96/0b/4ca55ed5754f7a8bfb891fa9158ec0aa82d6ccb7830c8004dab1b440168c/weconnect-0.60.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-28 22:40:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tillsteinbach",
"github_project": "WeConnect-python",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [
{
"name": "requests",
"specs": [
[
"~=",
"2.31.0"
]
]
},
{
"name": "oauthlib",
"specs": [
[
"~=",
"3.2.2"
]
]
}
],
"test_requirements": [
{
"name": "pytest",
"specs": []
},
{
"name": "pytest-cov",
"specs": []
}
],
"lcname": "weconnect"
}
JSON
