Porsche Connect smart home integration, free and open source
Your Porsche in Gladys: battery, range, charge, lock, climate, position and scenes.
Published by William-De71
- Devices
- Version 0.1.1
- Requires Gladys >=5.2.0
- ★ 0
Overview
This integration brings the Porsche cars of your My Porsche account into Gladys, through the servers of the My Porsche app, like the pyporscheconnectapi library and its Home Assistant integration:
- one device per car: battery and electric range, fuel and total range, odometer, lock, doors, trunk, front lid, windows, sunroof or top, charge, charge target, pre-climatisation, tire pressures, service and distance from home;
- commands when the car accepts them: lock, unlock, pre-climatisation, charge target, direct charge, flash the lights, horn and lights;
- scene triggers and actions, and a dashboard widget per car.
The integration reads what the car last sent to Porsche, every 15 minutes by default: it never wakes the car up. Everything goes through the Porsche cloud (cloud transport): the car is never reached on your network. This is a community integration, not affiliated with Porsche; the servers of the My Porsche app have no public documentation and may change.
Prerequisites
- Gladys Assistant 5.2.0 or later (the captcha form of the widget needs it).
- A car with an active Porsche Connect contract (Taycan, Macan Electric, 911 from the 992, 718, Panamera from 2021, Cayenne from 2017), and the e-mail and password of the My Porsche account.
- The 4-digit PIN of the My Porsche app, only to unlock the car from Gladys.
- The Porsche widget on a dashboard: Porsche sometimes asks for a captcha at the sign-in, and the widget is where you type it.
Configuration
| Field | What to enter |
|---|---|
| E-mail / Password | The My Porsche account |
| PIN (4 digits) | Optional: needed only to unlock |
| Reading interval | 15 minutes by default (10 to 60) |
| Pre-climatisation temperature | 21 °C by default |
| Home radius | 200 m by default, for the distance from home and the arrived/left scenes |
| Language of the texts | Automatic: the language of your dashboard |
Add the Porsche widget to a dashboard, then click Save and Test the connection: it lists your cars and the number of commands each accepts. If Porsche asks for a captcha, the widget shows its picture: click Enter the code, type the characters, and the integration signs in. The session is then kept and refreshed: the captcha is rare. The houses of Gladys need a position on the map for the distance from home.
Usage
Devices
Open Discover, then add your cars. A feature appears once the car has reported its value: the integration offers the device again when a new one shows up (a first charge…). Lock, pre-climatisation and charge target can be changed from the dashboard when the car accepts these commands. A command takes a few seconds to a minute and a half: the car wakes up, runs it, then the integration reads it again.
Dashboard widget
The Porsche widget shows the battery or the fuel, the range, the odometer, a status list (lock, openings, charge, climate, tires, position) and buttons: lock or unlock (unlock asks first, and needs the PIN), pre-climatise, flash the lights, and the position on a map. Choose the car in its settings, or leave it empty for the first car. While Porsche asks for a captcha, every Porsche widget shows it instead.
Scenes
Triggers: locked or unlocked, locked but left open, charging status changed, cable plugged or unplugged, arrived home or left, tire pressure low, account problem. They are seen at the next reading of the car. Actions: send a command (and wait for the car to run it), read the status of a car (with a sentence ready for a message).
Examples:
- When the car is locked but left open → send me a message with the summary.
- When charging becomes "Charging completed" → notify and switch the charging socket off.
- Every working day at 7:30 in winter → send the command "Start the pre-climatisation".
Transport
The badge of a car says cloud. It turns unreachable when Porsche refuses the account or waits for a captcha, and shows an orange dot while Porsche limits the requests: the readings are then spaced out.
Troubleshooting
- Wrong e-mail or password: check them in the My Porsche app first, then save the settings again.
- Captcha: open the dashboard with the Porsche widget and type the code. A wrong code shows a new picture; a captcha older than 10 minutes is replaced.
- Account locked: Porsche locks an account after too many sign-ins. Unlock it in the My Porsche app or on the Porsche ID website, then save the settings.
- Values a few minutes old: the car sends its data when it parks, while it charges and after a command. A shorter interval does not make it send more.
- A value or a command is missing: not every car reports everything, and the privacy mode of the car hides most values. Click Diagnostic, then copy the lines of the Logs tab into an issue on GitHub: they contain what the car reports, without VIN nor position.
- Unlock refused: enter the 4-digit PIN of the My Porsche app.
Configuration settings
These are the settings Porsche Connect asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| My Porsche account | section | No | The account of the My Porsche app, with an active Porsche Connect contract. Porsche sometimes asks for a captcha at the sign-in: the integration then shows it in its dashboard widget, where you type it. Add the widget to a dashboard before saving. |
string | Yes | ||
| Password | secret | Yes | |
| PIN (4 digits) | secret | No | The PIN of the My Porsche app. Only needed to unlock the car from Gladys. |
| Options | section | No | The integration reads what the car last sent to Porsche: it never wakes the car up. A Porsche sends its data when it parks, while it charges and after a command. |
| Reading interval | select | No | |
| Pre-climatisation temperature | select | No | |
| Home radius (m) | number | No | A car closer than this to a house of Gladys (with its position set) is home: distance feature and arrived/left scenes. |
| Language of the texts | select | No | Language of the device names, the charging status and the scene summaries. Automatic: the language of your dashboard. |
How to install Porsche Connect in Gladys
- In Gladys, open Integrations: Porsche Connect appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/william-de71/gladys-porsche-connect:0.1.1), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/William-De71/gladys-porsche-connect.
Porsche Connect requires Gladys >=5.2.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
Porsche Connect is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by William-De71, not by the Gladys core team.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation