Custom Lovelace card for ISDT Air BLE chargers and adapters in Home Assistant. Select your device and all entities are discovered automatically. Adapts to your HA theme (light & dark).
Two layouts, picked automatically from the device model:
- Battery-shaped slots with liquid fill level, wave animation & bubbles
- Header with input voltage, current, power, total charging current, beep toggle
- Per-slot details: voltage, current, live charge timer, battery type, mAh/Wh
- Status animations: green glow (charging), blue (done), red pulse (error)
- Power gauge ring showing total W of device maximum, plus active-port count and load %
- 8-port grid — 6× USB-C and 2× USB-A tiles, each with watts, V/A, protocol badge (PD/FAST) and load bar
- Sound popover in the header — click the speaker icon to pick Mute / Low / Med / High
- Rename-aware: port labels follow
name_by_userwhen you rename a sub-device in the HA UI ("USB-A1" → "Toothbrush") - Pulse-charging safe: the tile state follows the integration's phantom-load filter, so actively charging devices (e.g. a NiMH charger on USB-C) don't flip between active/off
- Device-based setup — select your ISDT device, no entity prefix needed
- Auto-discovery of all entities via device identifiers and translation keys
- HA theme-aware — automatically adapts to any light or dark theme
- Click any tile to open the HA more-info dialog
- Open HACS → Frontend → ⋮ → Custom repositories
- Add this repository URL as Dashboard
- Search for "ISDT Charger Card" and install
- Refresh your browser (Ctrl+F5)
- Copy
dist/isdt-charger-card.jstoconfig/www/isdt-charger-card.js - Add the resource in HA:
- Settings → Dashboards → ⋮ → Resources
- URL:
/local/isdt-charger-card.js - Type: JavaScript Module
- Refresh your browser
type: custom:isdt-charger-card
device_id: <your-device-id>The card uses HA's native device picker — just select your ISDT charger from the dropdown. All entities are discovered automatically.
| Option | Default | Description |
|---|---|---|
device_id |
(required) | ISDT Air BLE device ID |
title |
device name | Override the card title |
show_header |
true |
Show header with input stats |
| Status | Color | Effect |
|---|---|---|
| Empty | Dimmed | Battery-off icon |
| Idle | Neutral | Subtle fill |
| Charging | Green | Glow + wave + bubbles |
| Done | Blue | Glow |
| Error | Red | Pulsing border |
- ISDT Air BLE Integration — the Home Assistant integration this card is built for
This is an independent community project and is not affiliated with, endorsed by, or sponsored by ISDT. All product names, trademarks, and registered trademarks are property of their respective owners.
MIT

