Skip to main content

Provides asynchronous authentication and access to Audi Connect

Project description

audiconnectpy

GitHub sourcecode GitHub release (latest by date) Code Style PyPI - Downloads PyPI - Python Version

The 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.

Note: Certain functions require special permissions from Audi, such as position update via GPS.

Credit 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 Python package, on which some of this code is loosely based.

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

Use the PIP package manager

pip install audiconnectpy

Or manually download and install the last version from github

git clone https://github.com/cyr-ius/audiconnectpy.git
python setup.py install

Get started

# Import the audiconnectpy package.
from audiconnectpy import AudiConnect

async def main():
    async with ClientSession() as session:
        api = AudiConnect(session, VW_USERNAME, VW_PASSWORD, COUNTRY, SPIN)
        await api.async_update()
        print(api.vehicles)


if __name__ == "__main__":
    loop = asyncio.get_event_loop()
    loop.run_until_complete(main())

Have a look at the example.py for a more complete overview.

Login & Consent

Audiconectpy is based on the new Carnet ID 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 My Audi interface. Easiest to do so is by installing the My Audi app on your smartphone and login there. If necessary you will be asked to agree to the terms and conditions.

Credits

Inspired by :

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

audiconnectpy-2.1.5.tar.gz (47.7 kB view details)

Uploaded Source

Built Distribution

audiconnectpy-2.1.5-py3-none-any.whl (32.8 kB view details)

Uploaded Python 3

File details

Details for the file audiconnectpy-2.1.5.tar.gz.

File metadata

  • Download URL: audiconnectpy-2.1.5.tar.gz
  • Upload date:
  • Size: 47.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for audiconnectpy-2.1.5.tar.gz
Algorithm Hash digest
SHA256 67403d8555eeac4599d1a6bdc508fef9a40e8fe6bc8b753ac19a176a4c4b09dd
MD5 728a0b21a32420b0481c9159b9eb9231
BLAKE2b-256 ca65896f8c1949109770d407320a35ee66db3cf4c3282f12146ebf67288fab16

See more details on using hashes here.

File details

Details for the file audiconnectpy-2.1.5-py3-none-any.whl.

File metadata

File hashes

Hashes for audiconnectpy-2.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 ce4660e2ced45d205af472ea6e04dee3ded46bd03640da1b9087fc9a0f75a418
MD5 2e059fd9bca7b7da494d4bc7c13b7091
BLAKE2b-256 805ea75c5b62e6b8f8682fbb293cc7123bad2547e34e0a0584bc874d1ebc0532

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page