Skip to content

πŸ”‹ Material Battery Dialog ​

NOTE

✨ Available on πŸ’Ž Pro & Ultimate Version Only

✨ Overview ​

The Battery Dialog provides a specialized view for monitoring battery levels. It features a circular progress card for a quick visual assessment of the remaining charge and lists other related entities from the same device, offering a comprehensive overview of your device's power status.

This dialog gives users a fast and elegant way to check the battery life of sensors, remotes, and other peripherals without leaving the main Lovelace dashboard.

β˜€οΈ Light Mode

Dialog Light
πŸŒ™ Dark Mode

Dialog Dark

βœ… How to Open the Battery Dialog ​

The dialog opens automatically. There is no need for manual configuration.

  • If you do not define a tap_action, the dialog will open automatically on tap.

Example: The dialog is automatic

yaml
type: custom:material-button-card
entity: sensor.phone_battery
# No tap_action needed!

ℹ️ Action trigger ​

Action TypeCard TypeSensor (By Device Class)Attributes
tap_actionmaterial-button-cardbatteryunit_of_measurement = %

βš™οΈ Supported Device Classes ​

The Battery Dialog is designed specifically for sensors with the following device_class:

Device TypeDescription
batteryDisplays the battery level as a percentage, along with other entities from the same device.

🎨 Dialog Features ​

FeatureDescription
Circular ProgressShows the battery percentage in a large, easy-to-read circular progress bar.
Dynamic HeaderShows the device name and area.
Related Entities SectionLists all entities associated with the same device (e.g., temperature, signal strength).
History ButtonOpens Home Assistant’s built-in history panel for the entity.
Dark/Light Theme SupportAutomatically adapts to HA theme settings.
Responsive LayoutAdopts a fullscreen view on mobile and a centered dialog on desktop.

πŸ’‘ Example Use Cases ​

  • Tap a remote control button card β†’ view its exact battery percentage.
  • Tap a door sensor card β†’ check its battery level to see if it needs replacing soon.
  • Tap any battery-powered sensor β†’ get a full overview of the device's status.