carconnectivity-connector-volkswagen 0.10.5

CarConnectivity connector for Volkswagen services

CarConnectivity Connector for Volkswagen Vehicles

CarConnectivity will become the successor of WeConnect-python in 2025 with similar functionality but support for other brands beyond Volkswagen!

CarConnectivity is a python API to connect to various car services. This connector enables the integration of volkswagen vehicles through the WeConnect API. Look at CarConnectivity for other supported brands.

Configuration

In your carconnectivity.json configuration add a section for the volkswagen connector like this:

{
    "carConnectivity": {
        "connectors": [
            {
                "type": "volkswagen",
                "config": {
                    "username": "[e-mail]",
                    "password": "testpassword123"
                }
            }
        ]
    }
}

Credentials

If you do not want to provide your username or password inside the configuration you have to create a ".netrc" file at the appropriate location (usually this is your home folder):

# For WeConnect
machine volkswagen
login [e-mail]
password testpassword123

In this case the configuration needs to look like this:

{
    "carConnectivity": {
        "connectors": [
            {
                "type": "volkswagen",
                "config": {
                }
            }
        ]
    }
}

You can also provide the location of the netrc file in the configuration.

{
    "carConnectivity": {
        "connectors": [
            {
                "type": "volkswagen",
                "config": {
                    "netrc": "/some/path/on/your/filesystem"
                }
            }
        ]
    }
}

The optional S-PIN needed for some commands can be provided in the account section of the netrc:

# For WeConnect
machine volkswagen
login [e-mail]
password testpassword123
account 1234

Known issues

Locking/Unlocking and door status

Some cars do not announce the ACCESS capability although being able to lock/unlock and/or show the door status. You can fix this by adding "force_enable_access": true to the configuration of the connector

Unexpected keys found

Not all items that are presented in the data from the server are already implemented by the connector. Feel free to report interesting findings in your log data in the Discussions section or as an Issue (Enhancement). My time is very limited, so usually new features take some time to get into the library, also because I need to align functionallity between the connectors of all brands.

2 Factor Authentification

Some users currently report that the API is asking for a two factor auth. I have not seen this behaviour myself and currently also do not see an easy way to automate 2FA with a code coming in via email. The work-around that seems to work is to login via the browser on the machine running carconnectivity and put in the 2FA code.

Limitations

The connector is not working with US based vehicles. If you are looking for a connector for your Volkswagen in North America, use this connector instead: CarConnectivity-connector-volkswagen-na