Renault Car — Indigo Plugin

Control and monitor your Renault electric vehicle (ZOE and other Renault EVs) from Indigo Domotics, using the same API that powers the My Renault mobile app.

Built on top of the excellent renault-api Python library.

Features

• Battery monitoring — charge level (%), estimated range, available energy (kWh), battery temperature
• Charging control — start/stop charging, switch between "Always Charging" and "Schedule Mode", set a charge limit (80/90/100%)
• Charge scheduling — configure up to 4 weekly charge schedules, either the same start time/duration for every day or per-day times
• Pre-conditioning (HVAC) — remotely start or stop cabin pre-heating/cooling with a target temperature
• Vehicle status — plug status, charging status, charging power, remaining charge time, odometer, GPS location
• Remote actions — sound horn, flash lights, request an on-demand battery refresh
• Indigo triggers — fire off automations on charging status changes, battery level thresholds, plug events, HVAC state changes, and charging power changes
• Automatic session recovery — detects expired Renault sessions and silently re-authenticates mid-poll cycle
• Resilient login — failed logins retry with exponential backoff (60s up to 30 minutes) and distinguish permanent failures (bad password, disabled account) from temporary ones (Renault server errors, network blips)

Requirements

• Indigo 2022.1 or later (Server API 3.4+)
• A My Renault account with at least one linked vehicle
• Internet access from the Indigo Mac to Renault's servers

Installation

1. Download the latest RenaultCar.indigoPlugin release.
2. Double-click to install it into Indigo.
3. On first launch, the plugin installs its Python dependencies automatically (renault-api, aiohttp) — see Dependencies below if this fails.

Getting Started

1. Add a Renault Account device

Create a new device of type Renault Account, and provide:

After saving, the plugin connects in the background and populates:

• accountId — your Renault account ID
• connectionStatus — human-readable connection state
• lastLogin — timestamp of last successful login

If login fails, check the Indigo Event Log: - Bad credentials / disabled account → the plugin logs the error and stops retrying (fix the password/locale and restart the device) - Renault server errors / network issues → the plugin retries automatically with increasing delays (1 min, 2 min, 4 min... up to 30 min) until it connects

2. Add a Renault Vehicle device

Create a device of type Renault Vehicle, then:

1. Select the Renault Account device you created above
2. Select the Vehicle (VIN) from the dropdown (populated automatically once the account connects)
3. Set your preferred Update Interval (default: 10 minutes)
4. Choose Distance Unit (km/miles) and Temperature Unit (°C/°F)
5. Optionally enable Verbose Logging for troubleshooting

The vehicle device will wait for its linked account to finish authenticating before it starts polling — you'll see a log entry if it's waiting.

3. (Optional) Add control devices

These are simple relay-style devices for use on Indigo Control Pages or in quick actions:

Each of these links to a Renault Vehicle device via a dropdown.

Device States (Renault Vehicle)

Charging status can be ambiguous at the raw API level (numeric codes and strings both appear across models/regions). The plugin normalises this into three parallel states — chargingStatusRAW (untouched), chargingStatusCP (consistent lowercase tokens like charging, not_charging, waiting, charge_complete — best for automations), and chargingStatus (a friendly display string).

Actions

Available as Indigo Actions against a Renault Vehicle device:

• Start Charging / Stop Charging
• Start Pre-conditioning (with target temperature — most vehicles only accept 19/20/21°C)
• Stop Pre-conditioning (HVAC)
• Set Charge Mode (Always Charging / Schedule Mode)
• Set Charge Schedule — configure one of 4 schedule slots, either one time/duration for every day or individually per weekday
• Set Battery Charge Limit (80% / 90% / 100%)
• Sound Horn
• Flash Lights
• Refresh Vehicle Data — force an immediate poll instead of waiting for the update interval
• Request Battery Refresh — ask the vehicle to push a fresh battery reading (useful when the car has been asleep)

Triggers

Available as Indigo Trigger Events, each scoped to a specific Renault Vehicle device:

How it works

The plugin runs a dedicated asyncio event loop on a background thread (Indigo's plugin host is synchronous, but the underlying renault-api library is async). Each Renault Vehicle device gets its own polling thread that:

1. Waits for its linked Renault Account device to finish authenticating
2. Calls the Renault Kamereon API for battery status, charge mode, cockpit (odometer), location, and HVAC status
3. Writes results back to Indigo device states
4. Sleeps for the configured update interval, then repeats

If the Renault session expires mid-poll, the plugin automatically re-authenticates and retries the failed call before giving up. Connection errors are logged quietly for the first few failures and only escalate to a visible error after repeated failures, to avoid flooding the Event Log during brief Renault outages.

Known Limitations

• Location is unavailable for some vehicles/regions where Renault enforces "privacy mode" — this is a restriction on Renault's end, not a plugin bug.
• Charge mode endpoint isn't supported on all vehicle models — the plugin logs this at debug level and simply skips that field.
• Some vehicles only accept specific pre-conditioning target temperatures (commonly 19, 20, or 21°C) — check your model's supported values if a pre-conditioning request is rejected.
• Two-factor authentication on the My Renault account is not currently handled by this plugin.

Troubleshooting

• Vehicle device never initializes — check that its linked Renault Account device shows a connectionStatus of "Connected". The vehicle device will log "Waiting for account device to connect..." until then.
• "Invalid email or password" — the plugin has classified this as a permanent failure and stopped retrying. Double check credentials and locale, then restart the Account device.
• Intermittent connection errors in the log — transient Renault/Gigya server errors are retried automatically; you'll only see a warning if they persist.
• Enable Verbose Logging on the vehicle device's config for more detailed Event Log output while diagnosing an issue.

Dependencies

This plugin bundles its own copies of renault-api, aiohttp, and their sub-dependencies under Contents/Packages, so no manual pip install should be required. If you see a CRITICAL: renault-api module not found! error in the log, check the Event Log for package install failures and confirm the Contents/Packages folder was installed alongside the plugin.

License

MIT License — see LICENSE for details.

Credits

Built by Durosity, powered by hacf-fr/renault-api.

Disclaimer

This is an unofficial, community-built integration. It is not affiliated with, endorsed by, or supported by Groupe Renault. Use at your own risk — remote vehicle actions (charging, HVAC, horn, lights) directly affect your car.