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

Uploaded Source

Built Distribution

audiconnectpy-2.5.21-py3-none-any.whl (34.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: audiconnectpy-2.5.21.tar.gz
  • Upload date:
  • Size: 58.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for audiconnectpy-2.5.21.tar.gz
Algorithm Hash digest
SHA256 04979f7c1508016c0adfb94d316c902fc3700d03b9a769f4cda112cf96ee2fbd
MD5 44db234bedbf253e23484b0561373ba2
BLAKE2b-256 16de27385763a690b088982cd9df3f7ba4af823460cc586cf90b4c18b839b96b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for audiconnectpy-2.5.21-py3-none-any.whl
Algorithm Hash digest
SHA256 8a4b774696a044037a6e14d9c3bf58d26e730bd93e3d26ec8fb16764ddcb6493
MD5 662aa9ec16e8fb43550d881d8ca79872
BLAKE2b-256 4d086bf990f237500570c6942c17bc83a732929f9bb4b04bb524f35c56345f0a

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