BMS Battery Cells Card
Visualization of individual cell voltages of your battery storage system (BMS)
I would like to present my new card to you. The
BMS Battery Cells Card is a custom Lovelace card for visualizing the individual cell voltages of your battery storage system (BMS). It provides a clear overview of the status of all cells, including min/max values and balancing drift status.
The card can be fully configured via the card editor user interface and is translated to eng and ger. You need the corresponding entities from your BMS (e.g. Victron, JK-BMS, Daly) that provide the cell voltages in Home Assistant. Regular batteries (AGM and similar) also work, as long as you have suitable entities available in Home Assistant.
If you like the Card, I would appreciate a Star rating on my github
. ![]()
Features
Visualizations & Layouts
- Individual Cell Voltage: Bar charts with dynamic color thresholds (Min/Max/Avg)
- Multiple Layout Modes:
Standard View: Classic bar chart visualization
Table View: Compact grid showing only numbers (no bars)
List View: Horizontal layout for a list-like appearance
Detailed View: A full BMS dashboard view
- Compact Mode: Option to hide bars and show only header stats
- Animations: Charging (power in) and Discharging (power out) animations on cell bars
Detailed View (optional)
- Integrated Charts: Live history graphs for Total Voltage and Cell Drift (using Chart.js)
- Extended BMS Metrics: Display of SoH, Cycles, Capacity (Ah), and MOS Temperature
- Remaining Capacity: Auto-calculation based on Amp-hours and SoC
- Cell List: detailed table of all cell voltages including individual balancing status
- Hybrid View: Option to show the standard cell bars inside the detailed view
BMS Control & Interactive Elements
- Interactive Status Switches: Toggle Charge, Discharge, and Balance directly from the card (supports Switches, Input Booleans, and Input Selects)
- Custom State Logic: Define custom values for âOnâ and âOffâ states (e.g.,
True/False,On/Off) - Click Actions: Click on sensors, charts, or cells to open the Home Assistant âMore Infoâ dialog
Statistics & Monitoring
- Real-time Stats: Total Voltage, Current, Power (Watt), and Temperature
- Smart Drift Calculation: Automatically calculates the delta between Min and Max cells (or uses an external sensor)
- Min/Max Indicators: Visual highlighting of the highest and lowest voltage cells
- Average Voltage: Option to display the calculated average cell voltage
Configuration & Customization
- UI Editor: Fully configurable via the Home Assistant UI editor (no YAML required)
- Thresholds: Adjustable Minimum and Maximum voltage for color scaling
- Visual Tweaks: Options for thicker borders, hiding header values, and a lot more
Standard view:
Detailed view:
Installation
HACS (Recommended)
-
Add the GitHub repository via the link in Home Assistant.
-
The âBMS Battery Cells Cardâ should now be available in HACS. Click âINSTALLâ.
-
The resource will be automatically added to your Lovelace configuration.
Manual Installation via Hacs
Manual Installation via Hacs
Open HACS in Home AssistantâŚ
- Go to âFrontendâ and click the three dots in the upper right corner.
- Select âCustom repositoriesâ.
- Add the URL of your GitHub repository and select âLovelaceâ as the category.
- Click âADDâ.
- The âBMS Battery Cells Cardâ should now be available in HACS. Click âINSTALLâ.
- The resource will be automatically added to your Lovelace configuration.
Manual Installation via Hacs
Manual Installation in HA
-
Download files:
- Download the bms-battery-cells-card.js from this repository.
-
import files to Home Assistant:
- Create a new folder named
bms-battery-cells-cardin thewww/community-directory of your Home Assistant configuration. (The www directory is located in the same folder as your configuration.yaml). - Copy all downloaded files into this new folder. Your folder structure should look like this:
/config/www/community/bms-battery-cells-card/bms-battery-cells-card.js
- Create a new folder named
-
Add the resource to Home Assistant::
- In Home Assistant, go to Settings > Dashboards.
- Click the three-dot menu in the top right corner and select Resources.
- Click + Add resource.
- Enter /local/community/bms-battery-cells-card/bms-battery-cells-card.js as the URL.
- Select JavaScript module as the resource type.
- Click Create.
Configuration
After installation, you can add the card to your dashboard:
-
Enable edit mode:
- Open the dashboard where you want to add the card and click Edit..
-
Add card:
- Click + Add card and search for âBMS Battery Cells Cardâ.
-
Configure options:
- A configuration dialog will open where all settings can be conveniently adjusted.
- BMS Entity: The main entity or list of sensors.
- Voltage Range: Define the minimum and maximum voltage for the graphical display.
- Details: Display additional values ââsuch as battery power, temperature, drift, or average voltage.
simple example:
type: custom:bms-battery-cells-card
title: Battery Cells
cells:
- entity: sensor.cell_1
name: "1"
- entity: sensor.cell_2
name: "2"
- entity: sensor.cell_3
name: "3"
- entity: sensor.cell_4
name: "4"
advanced example:
type: custom:bms-battery-cells-card
cells:
- name: "1"
entity: sensor.vrm_maximum_cell_voltage_batt_1
- name: "2"
entity: sensor.vrm_minimum_cell_voltage_batt_1
- name: "3"
entity: sensor.vrm_maximum_cell_voltage_batt_2
- name: "4"
entity: sensor.vrm_minimum_cell_voltage_batt_2
soc_entity: sensor.victron_system_battery_soc
watt_entity: sensor.vrm_battery_power_batt_1024
cell_diff_sensor: sensor.vrm_minimum_cell_voltage_batt_1
temp_entity: sensor.vrm_battery_temperature_batt_1
show_values_on_top: false
enable_animations: true
title: Battery Cells
thicker_borders: true
min_voltage: 2.6
max_voltage: 3.65
show_average: false
More Details you can find in my github. ![]()






