Screenshots From the README of andrew-codechimp/HA-Battery-Notes.
About
Battery Notes is an integration that adds battery details such as type and replacement dates to devices in Home Assistant. It tracks the battery type, when the battery was last replaced, when a battery is low against device or global thresholds, and when a device has not reported its level for a while. A built-in battery library identifies the battery type for known devices and discovers them automatically, and notes can also be added manually. Each note gets a low battery binary sensor, a replaced button, and sensors for Battery+, battery type and last replaced date. Actions check for low batteries, stale reports and overdue replacements, and events from these checks can drive automations and notifications. Per-device options include templates for non-standard battery levels, retaining state for sleeping devices, and filtering outlier drops. It runs locally and is set up in the UI.
Automatic summary of the README and code of andrew-codechimp/HA-Battery-Notes. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Works locally Talks to your devices on your own network. No vendor cloud in between.
Device triggers Its devices can start automations directly.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Battery
- Battery type
- Battery quantity
- Note
- Battery low threshold0 will use the global default threshold.
- Battery increase thresholdThe threshold is the difference in increase between previous and current battery level. 0 will use the global default threshold.
- Battery percentage templateTemplate to create a battery percentage. Only needed for devices that do not have a standard battery percentage.
- Battery low templateTemplate to determine a battery is low, should return true if low. Only needed for non-standard battery levels.
- Retain stateRetain the last battery state when the source entity is unavailable. Useful for devices that sleep and become unavailable.
- Filter outliersFilter out large battery level drops, reducing falsely firing events on devices that erroneously report levels occasionally.
After setup
- Show all devicesShow all devices in the device dropdown, otherwise only those with batteries will be shown.
- Hide batteryHide the standard battery when adding Battery+.
- Round batteryRound Battery+ to whole percentages.
- Default battery low thresholdThe default threshold where a devices battery_low entity is set to true and the battery_notes_battery_threshold event is fired if the battery is below this threshold, can be overriden per device in device configuration.
- Default battery increase thresholdThe default threshold where the battery_notes_battery_increased event is fired, use this event for battery replaced automations. The threshold is the difference in increase between previous and current battery level, can be overriden per device in device configuration.
- Auto discoveryAuto discovery of devices that are in the library.
- Enable battery replacedEnable the battery replaced button on each battery note.
- Hide battery lowHide the battery low binary sensor when a battery percentage is available, avoiding duplication on generated dashboards.
- User libraryIf specified then a user library file will be searched prior to the main library, the user library must be in the same format as the library and placed in config/.storage/battery_notes.
Texts from the code of andrew-codechimp/HA-Battery-Notes.
Entities
- Binary sensorsBattery low
- ButtonsBattery replaced
- SensorsBattery+, Battery type, Battery last replaced
Actions
- Set battery replacedSet the battery last replaced.Fields: Device, Entity, Date
- Check battery last replacedGet a response or raise events for devices that haven't had their battery replaced.Fields: Days, Raise events
- Check battery last reportedGet a response or raise events for devices that haven't reported their battery level.Fields: Days, Raise events
- Check battery lowGet a response or raise events for devices that have a low battery.Fields: Raise events
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
- Repair noticesNotices it can show in Settings, Repairs:Orphaned Battery Note
From the README
Integration to add battery notes to a device or entity, with automatic discovery via a growing battery library for devices.
Track the battery type, when the battery was replaced, when a battery is low based on device or global thresholds and also when a battery hasn't been reported for a while.
Shows in Vulpo
Button card, Chart card, Apple Watch.Information
- Installs
- 15k sharing analytics
- GitHub stars
- 1.2k
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- 3.7.2,
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
battery_notes- Issues
- Report an issue
