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-1.4.5.tar.gz (33.8 kB view details)

Uploaded Source

Built Distribution

audiconnectpy-1.4.5-py3-none-any.whl (34.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: audiconnectpy-1.4.5.tar.gz
  • Upload date:
  • Size: 33.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.2 CPython/3.11.7

File hashes

Hashes for audiconnectpy-1.4.5.tar.gz
Algorithm Hash digest
SHA256 2da609bbe90a2fc6f9b094e1fcffc8cccc15d7370fc5d46c086b6021f7c521ab
MD5 0ad5b073bb8325e7b48562fef0fccced
BLAKE2b-256 4d43b1e57bbe0b88ca9cdc5579ec1c9819b3f45680212d17123ef7452717047c

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for audiconnectpy-1.4.5-py3-none-any.whl
Algorithm Hash digest
SHA256 4202dacb7a78225aaaa6806f162554e4f377e6df00a8c19a44268dda4b1cf7d7
MD5 c9b44a6239c1fc6917e55ef71a5dcc90
BLAKE2b-256 88cd6f4d9b546b91406f88ba00457b72375fd68b30a299bc9ff9bb225dc5246b

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