- Fix brightness threshold falsely resetting state to NONE during light
transition ramp-up (brightness temporarily below threshold != light off)
- Fix false manual override from Zigbee attribute-only updates (on→on)
by requiring meaningful state change (on→off or off→on)
- Fix disable guard to also accept ENABLING state (not just ENABLED)
- Move state updates before service calls to survive mode:restart cancellation
- Add ENABLING sub-case handler for motion-cleared-during-enable scenario
- Add CASE 1 default handler for restart recovery disable path
- Add comprehensive debug logging at automation entry and CASE 1 entry
- Change default timeout_delay to 0 and grace_period to 2s
- Remove unused is_debug/is_base_debug variables
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add configurable grace period (default 10s) to prevent false manual
override detection from delayed device state reports (e.g., Zigbee)
- Fix any_device_on guard to respect brightness_threshold so lights
below the threshold don't block the automation from triggering
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Maps color sensor states to lights in real-time with index-based pairing.
Supports FPS throttling, brightness override, configurable behavior when
sensors are unavailable, and a post-update callback action.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace interval-based scheduling with explicit time lists for more flexibility:
- Periodic Summary: Replace interval_hours + start_hour with notification_times
- Scheduled Assets: Replace interval_hours + start_hour with notification_times
- Memory Mode: Replace start_hour with notification_times
Changes:
- Remove `periodic_interval_hours` and `periodic_start_hour` inputs
- Remove `scheduled_assets_interval_hours` and `scheduled_assets_start_hour` inputs
- Replace `memory_mode_start_hour` with `memory_mode_notification_times`
- Add three new time text inputs accepting comma-separated HH:MM format
- Replace hourly time_pattern trigger with three template triggers
- Update trigger logic to match current time against configured times
- Update documentation to reflect new time-based scheduling
Users can now specify any times (e.g., "09:00, 14:30, 21:00") instead of
calculating intervals. Times must use 24-hour format with leading zeros.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- 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>
Sends notifications at specified times every N days when a control
flag is enabled. Supports multiple notification targets, flexible
time scheduling, and optional day interval with configurable start date.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add delays between text and media messages within each notification,
and between periodic summary, scheduled assets, and memory mode
when they trigger at the same hour.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Simplify Telegram recipient configuration to only use input_text
entities for chat IDs. Removes the notify entity friendly name
parsing which was complex and error-prone.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
New input `allowed_chat_ids` restricts which Telegram chats can trigger
the automation. Leave empty to allow all chats (no filtering).
Useful for security-sensitive commands.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Use 'photo' type (not 'IMAGE') to match service format
- Update default to immich-logo-inline-light.png
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Use `urls` parameter (list) instead of `image_url`. Pass empty list
when image URL is not configured.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
New input `periodic_summary_image_url` allows customizing the image
attached to periodic summary Telegram messages. Defaults to official
Immich logo. Set empty for text-only notifications.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Note that the service uses transcoded/optimized versions of assets
when available, not the original files.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Change telegram_max_asset_size input minimum from 0 to 1 (service
requires at least 1 byte). Set default to 50 MB for no extra filtering.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add telegram_max_asset_size input (0-50 MB slider)
- Pass max_asset_data_size parameter to send_telegram_notification
- Allows filtering out large files before sending to Telegram
- Set to 0 for no filtering (default Telegram 50 MB limit)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add chat_action parameter to all Telegram notifications
- Support typing, upload_photo, upload_video, upload_document actions
- Make memory mode interval fixed at 24h (daily notifications)
- Remove configurable interval input for memory mode
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
New notification settings for "assets added" events:
- Sort Assets By: date, rating, name, or original order
- Sort Direction: ascending or descending
- Notify Favorites Only: filter to only favorite assets
Rating sort handles null values by placing unrated assets last
(descending) or first (ascending).
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Replace the previous memory order_by option with a dedicated Memory Mode
feature that has its own enable toggle, schedule (interval/start hour),
and settings. Users can now run both Scheduled Assets and Memory Mode
independently at different times.
Memory Mode fetches photos taken on today's date in previous years using
the memory_date parameter, sorted by date ascending (oldest first).
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add new "Memory (On This Day)" option to scheduled assets Order By
selector. When selected, fetches photos taken on today's date in
previous years using the on_this_day parameter from get_assets service.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Inline periodic_albums_list computation into periodic_summary_formatted
using {%- -%} whitespace control to prevent unwanted whitespace in the
formatted output. Add documentation about this Jinja2 pattern to CLAUDE.md.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The album entity uses 'last_updated_at' not 'updated_at' for the
last update timestamp attribute.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Added {album_created} and {album_updated} placeholders to album-related
templates, using the existing date_format for formatting:
- periodic_album_template: reads from entity attributes
- scheduled_assets_message: reads from entity attributes (per_album/random mode)
- message_assets_added: looks up entity by event_album_id
- message_assets_removed: looks up entity by event_album_id
- message_asset_image/video: added placeholders
For combined mode, album dates are empty (no single album).
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Added guards to event data variables (event_hub_name, event_album_name,
etc.) to check if trigger.event is defined before accessing it.
Previously, these variables would error when the trigger was time_pattern
(hourly_timer) since trigger.event doesn't exist for non-event triggers,
causing the entire automation to fail silently.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Renamed the shared time_pattern trigger from "periodic_summary" to
"hourly_timer" since it serves both periodic summary and scheduled
assets features. This makes the trigger's purpose clearer.
Updated all references in should_send_periodic_summary,
should_send_scheduled_assets, and the condition block.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Applied the same inline computation fix to {video_warning} placeholder
that was previously done for {common_date} and {common_location}.
Computes video_warning_text inline using {%- set -%} syntax instead of
storing as a separate HA variable, which strips leading whitespace.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Videos without a playback_url are now filtered out in all contexts:
- Realtime event notifications
- Scheduled assets (per_album/random mode)
- Scheduled assets (combined mode)
This prevents sending video entries that cannot be played back.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Compute common_date and common_location inline using {%- set -%} syntax
instead of as separate HA variables, which strips leading whitespace
- Fix CASE 3 (Changed) handler missing common_date/common_location support
- Remove unused global common_date and common_location variable definitions
- Apply fix to all message templates: scheduled assets (per_album, combined),
realtime notifications (assets_added, changed), and Telegram messages
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add location template inputs (common_location_template, location_if_unique_template, location_format)
- Display common location in header when all assets share the same location
- Show per-asset location when locations differ using {location_if_unique}
- Location only shown when all three fields (city, state, country) are present
- Fix TypeError on NoneType length check when asset.created_at is null
- Add defensive checks for date parsing to prevent template errors
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Each blueprint now has its own folder containing:
- blueprint.yaml: The automation code with a short header
- README.md: Detailed documentation extracted from headers
Updated CLAUDE.md with repository structure guidelines.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add support for album renamed and deleted events with notification templates
- Fix missing response_variable for all telegram service calls
- Enhance debug notifications with formatted sections and Telegram diagnostics
- Add reply_to_message_id debug logging for troubleshooting
- Update version to 1.14.8
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- CONTRIBUTING.md with blueprint submission guidelines
- Issue templates for bugs and feature requests
- Pull request template
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
