alexei.dolgolyov/haos-blueprints
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity

Make Start Date and Control Flag inputs optional in Periodic Notification

Browse Source 
- Start Date: when empty, day interval is ignored and notifications fire daily
- Control Flag: when empty, notifications always fire (no toggle control)
- Update documentation to reflect optional inputs
- Fix markdown linting issues

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Admin
2026-02-09 12:42:59 +03:00
parent 5da986867d
commit 06177cb9f0
3 changed files with 20 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
Common/Periodic Notification/README.md
View File

@@ -1,6 +1,6 @@
# Periodic Notification
Sends notifications at specified times on a repeating day schedule, controlled by a toggle entity.
Sends notifications at specified times on an optional repeating day schedule with optional toggle control.
## Features
@@ -8,13 +8,13 @@ Sends notifications at specified times on a repeating day schedule, controlled b
- Customizable multiline message
- Flexible time schedule (multiple times per day)
- Configurable day interval (every N days)
- On/off control via input_boolean or switch entity
- Optional on/off control via input_boolean or switch entity
## How It Works
1. The automation triggers at each configured notification time (checked every minute)
2. It verifies the control flag entity is ON
3. It calculates whether today falls on the correct day in the interval cycle, counting from the configured start date
2. It verifies the control flag entity is ON (if configured)
3. It calculates whether today falls on the correct day in the interval cycle (if start date is configured)
4. If all conditions pass, the message is sent to all notification targets
### Day Interval Calculation
@@ -28,13 +28,13 @@ Setting the day interval to **1** sends notifications every day.
## Configuration
| Input | Description |
|---|---|
| --- | --- |
| **Notification Targets** | One or more `notify` entities (e.g., `notify.mobile_app_phone`) |
| **Message** | The notification text to send (supports multiline) |
| **Notification Times** | Comma-separated times in 24-hour `HH:MM` format (e.g., `08:00, 14:30, 20:00`) |
| **Day Interval** | Number of days between notification cycles (1 = daily) |
| **Start Date** | Reference date for the interval calculation (optional — leave empty to send every day) |
| **Control Flag** | `input_boolean` or `switch` entity to enable/disable notifications |
| **Control Flag** | `input_boolean` or `switch` entity to enable/disable notifications (optional — leave empty to always send) |
### Time Format
@@ -50,4 +50,4 @@ Set the `is_debug` variable to `true` in the automation YAML to enable persisten
## Author
Alexei Dolgolyov (dolgolyov.alexei@gmail.com)
Alexei Dolgolyov (<dolgolyov.alexei@gmail.com>)