Awesome
battery-entity-row
Show battery states or attributes with dynamic icon on entity rows in Home Assistant's Lovelace UI
Rewritten and improved version of cbulock's battery-entity card (deprecated/unmaintained).
NOTE: This is not a standalone lovelace card, but a row element for the entities card. If you need a standalone card or want a lot more customizability, check out maxwroc's battery-state-card.
Installation
Manually add battery-entity-row.js
to your <config>/www/
folder and add the following to the configuration.yaml
file:
lovelace:
resources:
- url: /local/battery-entity-row.js?v=1.3.1
type: module
OR install using HACS and add this (if in YAML mode):
lovelace:
resources:
- url: /hacsfiles/lovelace-battery-entity-row/battery-entity-row.js
type: module
The above configuration can be managed directly in the Configuration -> Lovelace Dashboards -> Resources panel when not using YAML mode, or added by clicking the "Add to lovelace" button on the HACS dashboard after installing the plugin.
Configuration
This card produces an entity-row
and must therefore be configured as an entity in an entities card.
The battery level value is fetched from the entity state
, from the attribute battery
or battery_level
,
or from a custom attribute defined with the attribute
option. Numeric values (0-100
) and some predefined
string values (high
, normal
, low
, etc..) are supported as a battery level value.
Name | Type | Default | Description |
---|---|---|---|
type | string | Required | custom:battery-entity-row |
entity | string | Required | domain.my_entity_id |
attribute | string | battery_level | Override battery level attribute |
name | string | friendly_name | Override entity friendly_name |
secondary_info | string | last-changed , last-updated or an attribute of the entity. | |
unit | string/bool | % | Override default unit , or hide with false |
icon | string | Override dynamic battery icon | |
warning | number | 35 | Level at which the icon will appear yellow |
critical | number | 15 | Level at which the icon will appear red |
charging | bool/object | false | Indicate charging based on entity state. See charging object for more options. |
Currently limited support for secondary_info
option with value last-changed
.
Charging object
Name | Type | Default | Description |
---|---|---|---|
entity | string | main entity | Get charging state from another entity |
attribute | string | Get charging state from an attribute | |
state | string/list | "on" , "charging" | Add values that indicate charging (case insensitive) |
Examples
type: entities
entities:
- type: custom:battery-entity-row
entity: sensor.bedroom_temperature
- type: custom:battery-entity-row
entity: sensor.bedroom_temperature
attribute: battery_percent
name: Some battery
unit: percent
icon: mdi:battery-alert
secondary_info: last-changed
warning: 50
critical: 25
charging: true
- type: custom:battery-entity-row
entity: sensor.bedroom_temperature
name: Charging battery
charging:
entity: binary_sensor.bedroom_temperature_charger
attribute: charging
state:
- Enabled
- is_charging
Usage in auto-entities card:
type: custom:auto-entities
card:
type: entities
filter:
include:
- entity_id: sensor.battery* # or use other matchers
options:
type: custom:battery-entity-row
<battery-entity-row options>
My cards
xiaomi-vacuum-card |
multiple-entity-row |
github-entity-row |
battery-entity-row |
attribute-entity-row