Important
Beta: This integration is in beta phase. Correct functioning is not guaranteed and may contain errors; use it at your own risk.
A custom Home Assistant integration that creates max and min sensors based on a selected numeric sensor, with support for different time periods.
- Max/Min Sensors: Creates sensors that maintain the maximum or minimum value of a source sensor during a specified period
- Configurable Periods: Daily, weekly, monthly, yearly or all time (never resets)
- Flexibility: Create individual sensors (only max or only min) or in pairs
- Automatic Reset: At the end of each period, sensors reset to the current value of the source sensor
- Real-time Updates: Sensors update immediately when the source sensor value changes
- Open HACS in your Home Assistant instance.
- Go to "Integrations" > "Custom repositories".
- Add
https://github.com/PacmanForever/max-minas a custom repository with category "Integration". - Search for "Max Min" and install it.
- Restart Home Assistant.
- Add the integration through the UI.
- Download the
max_minfolder from the latest release. - Copy it to
custom_components/max_minin the Home Assistant configuration directory. - Restart Home Assistant.
- Add the integration through the UI.
After installation, add the integration via the Home Assistant UI:
- Go to Settings > Devices and services > Add integration.
- Search for "Max Min".
- Select the source sensor (an existing numeric sensor).
- Choose the period: Daily, Weekly, Monthly, Yearly or All time.
- Select sensor types: Max, Min, or both.
- (Optional) Select a device to link the new sensors to.
- (Optional) Set an Offset/Margin in seconds (default 0).
- (Optional) Set initial values for max and/or min to start with existing values.
Note: When you link sensors to a device, Home Assistant will show a screen at the end of the setup asking you to assign an area. This is standard Home Assistant behavior; if the device already has an area, it will be pre-selected.
You can configure an offset (in seconds) to handle synchronization delays or sensor restarts near the end of a period.
- How it works: If you set an offset of e.g. 10 seconds, the period reset will be delayed by 10 seconds (e.g., at 00:00:10).
- Dead Zone: Updates received during the window
[Reset Time - Offset]to[Reset Time + Offset]will be ignored. - Why use it?: This prevents data from the previous period (arriving late) from counting towards the new period, and prevents values from near-instantaneous restarts just before midnight from overwriting the day's true min/max.
You can set initial values for the max and min sensors when configuring the integration. This is useful for migrating from other integrations or when you want to start with known baseline values.
- Max Daily Temperature: Shows the maximum temperature value from 00:00 to 23:59 of the current day
- Min Weekly Humidity: Shows the minimum humidity value from Monday 00:00 to Sunday 23:59
- Max Monthly Pressure: Shows the maximum pressure value from day 1 00:00 to the last day of the month 23:59
- Min Annual Voltage: Shows the minimum voltage value from January 1 00:00 to December 31 23:59
You can set initial values for the max and min sensors when configuring the integration. This is useful for migrating from other integrations or when you want to start with known baseline values.
- Initial Max: Set a starting maximum value. The sensor will only update if the source sensor exceeds this value.
- Initial Min: Set a starting minimum value. The sensor will only update if the source sensor goes below this value.
If no initial values are set, the sensors will start with the first value received from the source sensor.
- Sensor Selection: The user chooses an existing numeric sensor in Home Assistant.
- Period Configuration: The time cycle is defined (daily, weekly, etc.).
- Sensor Creation: Max and/or min sensors are created with descriptive names.
- Value Accumulation: During the period, sensors maintain the observed max/min.
- Automatic Reset: At the end of the period, sensors reset to the current value of the source sensor and a new cycle begins.
- Daily: From 00:00 to 23:59 of the same day. Reset at 00:00 of the next day.
- Weekly: From Monday 00:00 to Sunday 23:59. Reset at Monday 00:00 of the next week.
- Monthly: From day 1 00:00 to the last day of the month 23:59. Reset at day 1 00:00 of the next month.
- Yearly: From January 1 00:00 to December 31 23:59. Reset at January 1 00:00 of the next year.
You can use these sensors in automations, for example:
- Notifications when the daily max exceeds a threshold
- Historical records of weekly mins
- Alerts for extreme monthly values
When Home Assistant restarts, the Max Min integration behaves as follows:
- Accumulated values are lost: The max and min values accumulated during the current period are completely lost
- Current value is preserved: Only the current value of the source sensor at restart time is maintained
- Reset is reprogrammed: The reset timer is recalculated based on the current time
- Sensors unavailable: If the source sensor is not available during restart, sensors will show "Unavailable"
Important note: This integration does not save historical values to disk, by design. If you need data persistence, consider using Home Assistant's native history functionality or external databases.
- Verify that the source sensor exists and has valid numeric values
- Check Home Assistant logs for errors
- The source sensor is not available or does not have a valid numeric value
- Wait for the source sensor to reconnect
- Make sure you have selected an existing numeric sensor
- Verify that the period is correctly configured
Contributions are welcome! Please see CONTRIBUTING.md for details.
This project is licensed under the GPL-3.0 License - see the LICENSE file for details.