https://github.com/andrew-codechimp/ha-periodic-min-max
Periodic Min/Max helpers for Home Assistant
https://github.com/andrew-codechimp/ha-periodic-min-max
hacs hacs-integration home-assistant homeassistant homeassistant-custom-component homeassistant-integration
Last synced: 8 months ago
JSON representation
Periodic Min/Max helpers for Home Assistant
- Host: GitHub
- URL: https://github.com/andrew-codechimp/ha-periodic-min-max
- Owner: andrew-codechimp
- License: mit
- Created: 2025-03-09T11:34:18.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-25T13:36:12.000Z (9 months ago)
- Last Synced: 2025-09-25T15:35:14.283Z (9 months ago)
- Topics: hacs, hacs-integration, home-assistant, homeassistant, homeassistant-custom-component, homeassistant-integration
- Language: Python
- Homepage:
- Size: 1.06 MB
- Stars: 51
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# HA-Periodic-Min-Max
[![GitHub Release][releases-shield]][releases]
[![GitHub Activity][commits-shield]][commits]
[![Downloads][download-latest-shield]]()
[![HACS Installs][hacs-installs-shield]]()
[![License][license-shield]](LICENSE)
[![hacs][hacsbadge]][hacs]
Periodic Min/Max Helpers for Home Assistant
The helpers record the minimum or maximum of a sensor until manually reset via the reset action. The value is maintained through HA restarts.
A `last_modified` attribute is available to check when the min or max was really changed, this attribute does not update on HA restarts giving you an accurate indication on when the new min or max was hit. This can be useful for using as a trigger on an automation or for comparing via a template for a daily update. The attribute is in UTC.
## Example use cases
- Record the maximum temperature today, resetting at midnight via an automation.
- Record the peak solar energy produced ever, reset when you upgrade your solar installation.
_Please :star: this repo if you find it useful_
_If you want to show your support please_
[](https://www.buymeacoffee.com/codechimp)
## Tips
If you have many sensors you want to reset daily, create a label called daily reset, add the label to each sensor you want resetting, then create one automation that resets all sensors with that label at midnight.
```
alias: Periodic Reset Daily at Midnight
description: ""
triggers:
- trigger: time
at: "00:00:00"
conditions: []
actions:
- action: periodic_min_max.reset
target:
label_id: daily_reset
data: {}
mode: single
```
To tell whether a new min or max has been achieved in the last 24 hours use this template
```
{{ (utcnow() - as_datetime(state_attr("sensor.my_sensor", "last_modified"))).total_seconds() < 86400 }}
```
## Installation
### HACS
[](https://my.home-assistant.io/redirect/hacs_repository/?owner=andrew-codechimp&repository=HA-Periodic-Min-Max&category=Integration)
Or search for **Periodic Min/Max** within HACS if My Home Assistant does not work for you
Restart Home Assistant
In the HA UI go to "Configuration" -> "Devices & services" -> "Helpers" click "+" and select "Periodic Min/Max"
### Manual Installation
Show detailed instructions
Installation via HACS is recommended, but a manual setup is supported.
1. Manually copy custom_components/periodic_min_max folder from latest release to custom_components folder in your config folder.
1. Restart Home Assistant.
1. In the HA UI go to "Configuration" -> "Devices & services" -> "Helpers" click "+" and select "Periodic Min/Max"
## Usage
A new Periodic Min/Max helper will be available within Settings/Helpers or click the My link to jump straight there
[](https://my.home-assistant.io/redirect/config_flow_start/?domain=periodic_min_max)
### Translations
You can help by adding missing translations when you are a native speaker. Or add a complete new language when there is no language file available.
Periodic Min/Max uses Crowdin to make contributing easy.
Instructions
**Changing or adding to existing language**
First register and join the translation project
- If you don’t have a Crowdin account yet, create one at [https://crowdin.com](https://crowdin.com)
- Go to the [Periodic Min/Max Crowdin project page](https://crowdin.com/project/periodic-min-max)
- Click Join.
Next translate a string
- Select the language you want to contribute to from the dashboard.
- Click Translate All.
- Find the string you want to edit, missing translation are marked red.
- Fill in or modify the translation and click Save.
- Repeat for other translations.
Periodic Min/Max will automatically pull in latest changes to translations every day and create a Pull Request. After that is reviewed by a maintainer it will be included in the next release of Periodic Min/Max.
**Adding a new language**
Create an [Issue](https://github.com/andrew-codechimp/HA-Periodic-Min-Max/issues/) requesting a new language. We will do the necessary work to add the new translation to the integration and Crowdin site, when it's ready for you to contribute we'll comment on the issue you raised.
---
[commits-shield]: https://img.shields.io/github/commit-activity/y/andrew-codechimp/HA-Periodic-Min-Max.svg?style=for-the-badge
[commits]: https://github.com/andrew-codechimp/HA-Periodic-Min-Max/commits/main
[hacs]: https://github.com/hacs/integration
[hacsbadge]: https://img.shields.io/badge/HACS-Default-41BDF5.svg?style=for-the-badge
[exampleimg]: example.png
[license-shield]: https://img.shields.io/github/license/andrew-codechimp/HA-Periodic-Min-Max.svg?style=for-the-badge
[releases-shield]: https://img.shields.io/github/release/andrew-codechimp/HA-Periodic-Min-Max.svg?style=for-the-badge
[releases]: https://github.com/andrew-codechimp/HA-Periodic-Min-Max/releases
[download-latest-shield]: https://img.shields.io/github/downloads/andrew-codechimp/HA-Periodic-Min-Max/latest/total?style=for-the-badge
[hacs-installs-shield]: https://img.shields.io/endpoint.svg?url=https%3A%2F%2Flauwbier.nl%2Fhacs%2Fperiodic_min_max&style=for-the-badge