Merge pull request #396 from valentinfrlch/v1.5.0-beta

v1.5.0 Changes

Author: valentinfrlch

README.md

@@ -1,10 +1,13 @@
 <p align="center">
-<img src="https://github.com/user-attachments/assets/bebd92b8-765e-4d63-bb3d-47e1bb8b51ad" width=500px>
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="./logos/dark_logo@2x.png">
+  <img alt="LLM Vision Logo" src="./logos/logo@2x.png" width="512">
+</picture>
 </p>
 <p align=center>
 <img src=https://img.shields.io/badge/HACS-Default-orange.svg>
 <img src="https://img.shields.io/maintenance/yes/2025.svg">
-<img src=https://img.shields.io/badge/version-1.4.3-blue>
+<img src=https://img.shields.io/badge/version-1.5.0-blue>
 <img alt="Issues" src="https://img.shields.io/github/issues/valentinfrlch/ha-llmvision?color=0088ff">
 <img alt="Static Badge" src="https://img.shields.io/badge/support-buymeacoffee?logo=buymeacoffee&logoColor=black&color=%23FFDD00&link=https%3A%2F%2Fbuymeacoffee.com%2Fvalentinfrlch">
     <p align=center style="font-weight:bold">
@@ -15,9 +18,9 @@
   <p align="center">
     <a href="#features">🌟 Features </a>
     ·
-    <a href="#resources">📖 Resources</a>
+    <a href="#quick-start-guide">⬇️ Quick Start Guide</a>
     ·
-    <a href="#installation">⬇️ Installation</a>
+    <a href="#resources">📖 Resources</a>
     ·
     <a href="#how-to-report-a-bug-or-request-a-feature">🪲 How to report Bugs</a>
     ·
@@ -33,21 +36,35 @@
 </p>
 
 ## Features
-- Compatible with OpenAI, Anthropic Claude, Google Gemini, AWS Bedrock, Groq, [LocalAI](https://github.com/mudler/LocalAI), [Ollama](https://ollama.com/), [Open WebUI](https://github.com/open-webui/open-webui) and providers with OpenAI compatible enpoints.
+- Compatible with OpenAI, Anthropic Claude, Google Gemini, AWS Bedrock, Groq, [Ollama](https://ollama.com/), [Open WebUI](https://github.com/open-webui/open-webui), [LocalAI](https://github.com/mudler/LocalAI) and providers with OpenAI compatible enpoints.
 - Analyzes images and video files, live camera feeds and Frigate events
-- Can remembers people, pets and objects
-- Maintains a timeline of camera events, so you can display them on your dashboard as well as ask about them later
-- Seamlessly updates sensors based on image input
+- Remembers people, pets and objects
+- Maintains a timeline of camera events, so you can display them on your dashboard and ask Assist about them
+- Seamlessly updates sensors based on data extracted from camera streams, images or videos
 
 <br>
 
 See the [website](https://llmvision.org) for the latest features as well as examples.
-<img width="1122" alt="bento-board" src="https://github.com/user-attachments/assets/a87091a4-314e-42e3-b068-51e8d6a97f1b" />
+<img width="1027" alt="Bentoboard" src="https://github.com/user-attachments/assets/68af19b0-7000-4e5f-a3d3-c180ec2905f2" />
+
 
 
 
 <br>
 
+## Quick Start Guide
+>[!TIP]
+>LLM Vision is available in the default HACS repository. You can install it directly through HACS or click the button below to open it there.
+
+[![Open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=valentinfrlch&repository=ha-llmvision&category=Integration)
+1. **Install `LLM Vision`** from HACS
+2. **Restart** Home Assistant
+3. **Search for `LLM Vision`** in Home Assistant Settings/Devices & services
+4. **Press submit** to continue setup with default settings
+5. **Press 'Add Entry'** to add your first AI Provider
+
+Detailed setup instructions and documentation is available here: [LLM Vision Documentation](https://llm-vision.gitbook.io/getting-started/setup/providers)
+
 ## Blueprint
 With the easy to use blueprint, you'll get camera event notifications intelligently summarized by AI. LLM Vision can also store events in a timeline, so you can see what happened on your dashboard.
 <br>
@@ -67,18 +84,6 @@ Check the docs for detailed instructions on how to set up LLM Vision and each of
 For technical questions see the discussions tab.
 
 
-## Installation
->[!TIP]
->LLM Vision is available in the default HACS repository. You can install it directly through HACS or click the button below to open it there.
-
-[![Open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=valentinfrlch&repository=ha-llmvision&category=Integration)
-1. Install `LLM Vision` from HACS
-2. Search for `LLM Vision` in Home Assistant Settings/Devices & services
-3. Select your provider
-4. Follow the instructions to add your AI providers.
-
-Continue with setup here: https://llm-vision.gitbook.io/getting-started/setup/providers
-
 ## How to report a bug or request a feature
 > [!IMPORTANT]
 > **Bugs:** If you encounter any bugs and have followed the instructions carefully, file a bug report. Please check open issues first and include debug logs in your report. Debugging can be enabled on the integration's settings page.

blueprints/event_summary.yaml

@@ -1,6 +1,12 @@
+# Fix Group and Channel to First Camera Entity, user edits - DONE
+# Add time to notificaion title or message, with user choose between 12/24h - DONE
+# Take snapshot of triggered camera entity if using multiple cameras (? help needed)
+# Snooze blueprint or notifications
 blueprint:
-  name: AI Event Summary (v1.4.3)
+  name: AI Event Summary (v1.5.0)
   author: valentinfrlch
+  homeassistant:
+    min_version: 2024.10.0
   description: >
     AI-powered summaries for security camera events.
     Sends a notification with a preview to your phone that is updated dynamically when the AI summary is available.
@@ -75,9 +81,9 @@ blueprint:
       collapsed: true
       input:
         remember:
-          name: Remember
+          name: Store in Timeline
           description: Stores this event in the Timeline so you can ask about it. If important is enabled, only events classified as Normal or Critical will be saved.
-          default: false
+          default: true
           selector:
             boolean:
         use_memory:
@@ -120,16 +126,7 @@ blueprint:
           selector:
             number:
               min: 1
-              max: 100
-        temperature:
-          name: Temperature
-          description: Randomness. Lower is more accurate, higher is more creative.
-          default: 0.1
-          selector:
-            number:
-              min: 0.1
-              max: 1.0
-              step: 0.1
+              max: 300
     # Notificaion Section
     notification_section:
       name: Notification Settings
@@ -171,26 +168,39 @@ blueprint:
                 - Consolidated
         preview_mode:
           name: Preview Mode
-          description: "Choose between a live preview or a snapshot of the event. \n\n **Important:** Live Preview is only supported on iOS."
+          description: "Choose between a live preview or a snapshot of the event. The Snapshot of the last camera, if using multiple Camera Entities, will be used but the notification will be udated with the camera view that triggered the automation. \n\n **Important:** Live Preview is only supported on iOS."
           default: Snapshot
           selector:
             select:
               options:
                 - Snapshot
                 - Live Preview
+        notification_time:
+          name: Notification Time
+          description: "Add time to Notification Title and choose between 12-hour or 24-hour time format for the notification title."
+          default: ''
+          selector:
+            select:
+              options:
+                - label:  No Time Added
+                  value: ''
+                - label: 12 Hour
+                  value: 'at {{ now().strftime("%I:%M %p") }}'
+                - label: 24 Hour
+                  value: 'at {{ now().strftime("%H:%M") }}'
         file_path:
           name: File Path - To send snapshot in Dynamic Mode with Snapshot Preview Mode
-          description: "The file path to store the most current snapshot for the FIRST camera if using multiple camera entities.\n\nDefaults
-            to `/media/local/snapshots/{{ camera_file_path }}/last_motion.jpg` that references **/media/snapshots/<CAMERA_NAME>/last_motion.jpg** \n\n Try `/local/snapshots/{{ camera_file_path }}/last_motion.jpg` that references **/config/www/snapshots/{{ camera_file_path }}/last_motion.jpg** if you are having issues ***Note that this is unsecured and exposes the images to the web.***
-            \n\nYOU MUST ADD `/local` with the `/media` folder so -> `/media/local` or replace `/config/www` with `/local`."
-          default: Media Folder - Secured
+          description: "The file path to store the most current snapshot for the FIRST camera if using multiple camera entities. You can specifiy a custom location as well.\n\nDefaults
+            to `Media Folder - Secured` that references **/media/snapshots/<CAMERA_NAME>/last_motion.jpg** \n\n Try the `Public Folder - Unsecured` option that references **/config/www/snapshots/{{ camera_file_path }}/last_motion.jpg** if you are having issues ***Note that this is unsecured and exposes the images to the web.***"
+          default: '/media/snapshots/{{ camera_file_path }}/last_motion.jpg'
           selector:
             select:
               options:
                 - label: Media Folder - Secured
-                  value: /media/local/snapshots/{{ camera_file_path }}/last_motion.jpg
+                  value: '/media/snapshots/{{ camera_file_path }}/last_motion.jpg'
+
                 - label: Public Folder - Unsecured
-                  value: /config/www/snapshots/{{ camera_file_path }}/last_motion.jpg
+                  value: '/config/www/snapshots/{{ camera_file_path }}/last_motion.jpg'
               custom_value: true
         tap_navigate:
           name: Tap Navigate
@@ -290,19 +300,20 @@ blueprint:
         notification_channel:
           name: Custom Notification Channel or Alarm Mode - Android Only
           description: Create a new channel for notifications to allow custom notification
-            sounds, vibration patterns, and override Do Not Disturb mode. Configured
+            sounds, vibration patterns, and override Do Not Disturb mode. Camera Name uses first Camera Entity if using multiple cameras. Configured
             directly on the Android device -> Home Assistant App Setting -> Notifications.
-            Use `Alarm` to use the device's loud alarm notification sound.
+            Use `Alarm` to use the device's loud alarm notification sound. You can also type in your own channel name.
             [Learn More](https://companion.home-assistant.io/docs/notifications/notification-commands/#volume-level)
-            (default = Camera Name == {{ camera }} Snapshot). 
+            (default = Camera Name == {{ camera_entity_snapshot }} Snapshot). 
           default: '{{ camera }} Snapshot'
           selector:
             select:
               options:
               - label: Camera Name
-                value: '{{ camera }} snapshot'
+                value: '{{ camera }} Snapshot'
               - label: Alarm
                 value: alarm_stream
+              custom_value: true
         # TTS Notification
         tts_notification:
           name: Use Text-to-Speech (TTS) on your device to speak the notification. Android Only
@@ -312,8 +323,8 @@ blueprint:
             boolean:
         tts_volume:
           name: TTS Volume
-          description: Set TTS volume to device's current alarm volume or Max volume. Android Only
-          default: 'alarm_stream'
+          description: Set TTS volume to device's current alarm volume or Max volume. ALARM VOLUME WILL IGNORE DO NOT DISTURB! Android Only
+          default: 'notification_stream'
           selector:
             select:
               options:
@@ -416,6 +427,8 @@ variables:
   notify: !input notify
   condition_notify: !input condition_notify
   delay_notification: !input delay_notification
+  # camera_snapshot: !input camera_snapshot
+  # camera_name: '{{ states[camera_snapshot].name.replace(" ", "_") }}'
   device_name_map: >
     {% set ns = namespace(device_names=[]) %}
     {% for device_id in notify_devices %}
@@ -433,20 +446,21 @@ variables:
     {% else %}
       {{ trigger.entity_id }}
     {% endif %}
-  camera_entity_snapshot: >
-    {{ camera_entities_list[0] }}
   tag: >
     {{ camera_entity + int(as_timestamp(now()))|string }}
-  group: >
-    {{ camera_entity }}
   label: Motion detected
   camera: >
-    {{ camera_entity.replace("camera.", "").replace("_", " ")|capitalize }}
+    {{ camera_entities_list[0].replace("camera.", "").replace("_", " ") | title }}
   importance_prompt: >
     Classify the security event based on this image. Choose from the following options: "passive" for unimportant events, "time-sensitive" for notable but non-critical events such as a person at the front door, and "critical" only for potential burglaries or highly suspicious activity. Respond with one of these options exactly, without additional explanation.
+  camera_entity_snapshot: >
+    {{ camera_entities_list[0] }}
   camera_file_path: >
     {{ camera_entity_snapshot.replace("camera.", "")}}
   file_path: !input file_path
+  snapshot_access_file_path: '{{ file_path | replace(''/config/www'',
+    ''/local'') | replace(''/media'', ''/media/local'') }}'
+  notification_time: !input notification_time
 
 max_exceeded: silent
 mode: single
@@ -481,7 +495,6 @@ action:
               include_filename: true
               target_width: 1280
               max_tokens: 3
-              temperature: 0.1
             response_variable: importance
 
   # Cancel automation if event not deemed important
@@ -516,26 +529,25 @@ action:
                         value_template: "{{ preview_mode=='Snapshot' }}"
                     sequence:
 
-                      # Save Camera Snapshot to file to send to Android devices for Dynamic Mode, perhaps make optional?
+                      # Save Camera Snapshot to file to send to Android devices for Dynamic Mode
                       - service: camera.snapshot
-                        target:
-                          entity_id: !input camera_entities
+                        entity_id: !input camera_entities
                         data:
                           filename: !input file_path
 
-                      - alias: "Send instant notification to notify devices"
+                      - alias: "Send instant notification snapshot to notify devices"
                         repeat:
                           for_each: "{{device_name_map}}"
                           sequence:
                             - action: "notify.{{ repeat.item }}"
                               data:
-                                title: "{{ label }}"
+                                title: "{{ label }} {{ notification_time }}"
                                 message: "{{camera}} has detected activity."
                                 data:
                                   url: !input tap_navigate #iOS
                                   clickAction: !input tap_navigate #Android
                                   tag: "{{tag}}"
-                                  group: "{{group}}"
+                                  group: !input notification_channel
                                   alert_once: true
                                   # Priority options
                                   ttl: 0
@@ -545,9 +557,11 @@ action:
                                   color: !input notification_color
                                   notification_icon: !input notification_icon
                                   sticky: !input notification_sticky
-                                  # Send a snapshot of the event to Android devices
-                                  image: "{{ file_path }}"
+                                  image: "{{ snapshot_access_file_path }}"
                                   # iOS only
+                                  attachment:
+                                    url: '{{ snapshot_access_file_path }}'
+                                    content_type: JPEG
                                   push:
                                     interruption-level: "{{importance.response_text|lower if importance is defined else 'active'}}"
                                     sound:
@@ -566,13 +580,13 @@ action:
                           sequence:
                             - action: "notify.{{ repeat.item }}"
                               data:
-                                title: "{{ label }}"
+                                title: "{{ label }} {{ notification_time }}"
                                 message: "{{camera}} has detected activity."
                                 data:
                                   entity_id: "{{camera_entity}}"
                                   url: !input tap_navigate
                                   tag: "{{tag}}"
-                                  group: "{{group}}"
+                                  group: !input notification_channel
                                   alert_once: true
                                   push:
                                     interruption-level: "{{importance.response_text|lower if importance is defined else 'active'}}"
@@ -600,7 +614,6 @@ action:
       max_frames: !input max_frames
       target_width: !input target_width
       max_tokens: !input max_tokens
-      temperature: !input temperature  
     response_variable: response
 
   - alias: "Update label with title"
@@ -626,14 +639,14 @@ action:
                   sequence:
                     - action: "notify.{{ repeat.item }}"
                       data:
-                        title: "{{ label }}"
+                        title: "{{ label }} {{ notification_time }}"
                         message: "{{response.response_text}}"
                         data:
                           image: "{{response.key_frame.replace('/config/www/','/local/') }}"
                           url: !input tap_navigate #iOS
                           clickAction: !input tap_navigate #Android
                           tag: "{{tag}}"
-                          group: "{{group}}"
+                          group: !input notification_channel
                           alert_once: true
                           # Priority options
                           ttl: 0
@@ -675,4 +688,5 @@ action:
   - choose: []
     default: !input additional_actions
 
-  - delay: !input cooldown
+  # - delay: '00:{{cooldown|int}}:00'
+  - delay: !input cooldown