ioBroker.leapmotor

Unofficial Leapmotor electric vehicle integration for ioBroker. Tested on T03.

⚠️ Important: Use a Second Account

Do not use your main Leapmotor account!

The adapter maintains a permanent session with the Leapmotor cloud. If the same account is used simultaneously in the Leapmotor app, both sessions will conflict and log each other out.

Recommended setup:

1. Create a second Leapmotor account (e.g. with a second email address)
2. In the Leapmotor app, navigate to: Personal Center → My Vehicle → [Vehicle Name] → Shared Members → Add Shared Member
3. Enter the second account's email and grant all rights
4. Use the second account credentials in the adapter configuration

This way your main account stays logged in to the app at all times.

Features

• Vehicle status polling every 1–60 minutes (configurable)
• Battery SOC, range, temperature, tire pressure, GPS, doors, windows
• Remote control: climate (heat/cool/vent), lock/unlock, windows, trunk, find
• Consumption statistics with weekly history
• Dynamic vehicle dashboard (composite HTML widget for VIS)
• Automatic token refresh
• Picture cache (downloaded once, stored locally)

Tested Vehicles

• Leapmotor T03 ✅

Installation

Install via ioBroker Admin UI.

Configuration

| Setting | Description | |---------|-------------| | Email | Leapmotor account email (recommend using a dedicated second account) | | Password | Leapmotor account password | | Vehicle PIN | 4-digit vehicle PIN – required for all remote commands | | Polling interval | Status update interval in minutes (default: 5) |

Datapoints

leapmotor.0.<VIN>.status.*                → Vehicle status (read-only)
leapmotor.0.<VIN>.consumption.*           → Consumption & statistics (read-only)
leapmotor.0.<VIN>.pictures.*              → Vehicle images (read-only)
leapmotor.0.<VIN>.pictures.composite_html → Full dashboard HTML widget
leapmotor.0.<VIN>.cmd.*                   → Commands (writable)

VIS Dashboard Widget

Add a basic - string (unescaped) widget in VIS and set the Object ID to:

leapmotor.0.<VIN>.pictures.composite_html

Available Commands

| Command | Description | PIN required | |---------|-------------|:------------:| | cmd.ac_heiz | Start heating | ✅ | | cmd.ac_kuehl | Start cooling | ✅ | | cmd.ac_luft | Start ventilation | ✅ | | cmd.ac_off | Stop climate | ✅ | | cmd.ac_temp | Target temperature (16–30°C) | – | | cmd.defrost | Windshield defrost | ✅ | | cmd.lock | Lock vehicle | ✅ | | cmd.unlock | Unlock vehicle | ✅ | | cmd.trunk_open | Open trunk | ✅ | | cmd.trunk_close | Close trunk | ✅ | | cmd.windows_open | Open windows | – | | cmd.windows_close | Close windows | – | | cmd.find | Find vehicle (horn/lights) | – | | cmd.battery_preheat | Battery preheat on | ✅ | | cmd.battery_preheat_off | Battery preheat off | ✅ | | cmd.refresh | Trigger immediate status update | – |

Changelog

0.2.5 (2026-06-12)

• fix: use dynamic vehicle name from API in HTML dashboard
• fix: remove debug log messages

0.2.4 (2026-06-12)

• Fix: GitHub release permissions in workflow

0.2.3 (2026-06-12)

• Fix: add missing news entries

0.2.2 (2026-06-11)

• Fix: workflow, test scripts

0.2.1 (2026-06-10)

• Fix: release script, logo size, workflow improvements

License

MIT License

Copyright (c) 2026 Henrik Schönhofen (backfisch88)