From d7f1a464a692e6b6085e8ef35933612d966a0cd9 Mon Sep 17 00:00:00 2001 From: Pat Freeman Date: Tue, 27 Jan 2026 00:08:18 +0000 Subject: [PATCH 1/5] Wolfram setup fixes * update python script name to align with calls from blueprints * update blueprints to successfully find the display id * update blueprints to allow usage of a UI-manageable sensor group * update documentation to smooth adoption --- .../Ask_Wolfram/blueprint-askwolfram.yaml | 8 +++++--- ...short_answer.py => viewassist_wolfram_short_answer.py} | 0 .../Calculations/blueprint-calculations.yaml | 8 +++++--- .../Conversions/blueprint-conversions.yaml | 8 +++++--- .../community-contributions/cc-sentences/ask-wolfram.md | 4 +++- .../community-contributions/cc-sentences/calculations.md | 4 +++- .../community-contributions/cc-sentences/conversions.md | 4 +++- wiki/docs/developer-resources/general-information.md | 2 +- 8 files changed, 25 insertions(+), 13 deletions(-) rename View_Assist_custom_sentences/community_contributions/Ask_Wolfram/{viewassist-get_wolfram_short_answer.py => viewassist_wolfram_short_answer.py} (100%) diff --git a/View_Assist_custom_sentences/community_contributions/Ask_Wolfram/blueprint-askwolfram.yaml b/View_Assist_custom_sentences/community_contributions/Ask_Wolfram/blueprint-askwolfram.yaml index 6cabb5a3d..d846cd9a0 100644 --- a/View_Assist_custom_sentences/community_contributions/Ask_Wolfram/blueprint-askwolfram.yaml +++ b/View_Assist_custom_sentences/community_contributions/Ask_Wolfram/blueprint-askwolfram.yaml @@ -17,8 +17,10 @@ blueprint: selector: entity: filter: - - domain: group - default: "group.viewassist_satellites" + - domain: + - group + - sensor + default: "sensor.viewassist_satellites" trigger: - platform: conversation command: @@ -34,7 +36,7 @@ action: {{ sat.entity_id }} {% endif %} {% endfor %} - target_display_device: "{{ device_id(state_attr(target_satellite_device, 'display_device')) }}" + target_display_device: "{{ state_attr(target_satellite_device, 'display_device') }}" target_mediaplayer_device: "{{ state_attr(target_satellite_device, 'mediaplayer_device') }}" target_satellite_device_type: "{{ state_attr(target_satellite_device, 'type') }}" - service: pyscript.viewassist_wolfram_short_answer diff --git a/View_Assist_custom_sentences/community_contributions/Ask_Wolfram/viewassist-get_wolfram_short_answer.py b/View_Assist_custom_sentences/community_contributions/Ask_Wolfram/viewassist_wolfram_short_answer.py similarity index 100% rename from View_Assist_custom_sentences/community_contributions/Ask_Wolfram/viewassist-get_wolfram_short_answer.py rename to View_Assist_custom_sentences/community_contributions/Ask_Wolfram/viewassist_wolfram_short_answer.py diff --git a/View_Assist_custom_sentences/community_contributions/Calculations/blueprint-calculations.yaml b/View_Assist_custom_sentences/community_contributions/Calculations/blueprint-calculations.yaml index 22236eaa4..ad1963db1 100644 --- a/View_Assist_custom_sentences/community_contributions/Calculations/blueprint-calculations.yaml +++ b/View_Assist_custom_sentences/community_contributions/Calculations/blueprint-calculations.yaml @@ -13,8 +13,10 @@ blueprint: selector: entity: filter: - - domain: group - default: "group.viewassist_satellites" + - domain: + - group + - sensor + default: "sensor.viewassist_satellites" trigger: - platform: conversation command: @@ -30,7 +32,7 @@ action: {{ sat.entity_id }} {% endif %} {% endfor %} - target_display_device: "{{ device_id(state_attr(target_satellite_device, 'display_device')) }}" + target_display_device: "{{ state_attr(target_satellite_device, 'display_device') }}" target_mediaplayer_device: "{{ state_attr(target_satellite_device, 'mediaplayer_device') }}" target_satellite_device_type: "{{ state_attr(target_satellite_device, 'type') }}" - service: pyscript.viewassist_wolfram_short_answer diff --git a/View_Assist_custom_sentences/community_contributions/Conversions/blueprint-conversions.yaml b/View_Assist_custom_sentences/community_contributions/Conversions/blueprint-conversions.yaml index 749ede6e9..53cb855e6 100644 --- a/View_Assist_custom_sentences/community_contributions/Conversions/blueprint-conversions.yaml +++ b/View_Assist_custom_sentences/community_contributions/Conversions/blueprint-conversions.yaml @@ -13,8 +13,10 @@ blueprint: selector: entity: filter: - - domain: group - default: "group.viewassist_satellites" + - domain: + - group + - sensor + default: "sensor.viewassist_satellites" trigger: - platform: conversation command: @@ -31,7 +33,7 @@ action: {{ sat.entity_id }} {% endif %} {% endfor %} - target_display_device: "{{ device_id(state_attr(target_satellite_device, 'display_device')) }}" + target_display_device: "{{ state_attr(target_satellite_device, 'display_device') }}" target_mediaplayer_device: "{{ state_attr(target_satellite_device, 'mediaplayer_device') }}" target_satellite_device_type: "{{ state_attr(target_satellite_device, 'type') }}" - service: pyscript.viewassist_wolfram_short_answer diff --git a/wiki/docs/community-contributions/cc-sentences/ask-wolfram.md b/wiki/docs/community-contributions/cc-sentences/ask-wolfram.md index 8d221b243..32e7a19bc 100644 --- a/wiki/docs/community-contributions/cc-sentences/ask-wolfram.md +++ b/wiki/docs/community-contributions/cc-sentences/ask-wolfram.md @@ -9,8 +9,10 @@ This blueprint allows you to directly query Wolfram Alpha's Short Answers API. T ## Prerequisites - You must have Pyscript installed [See installation video](https://www.youtube.com/watch?v=jpJxZaisbGQ) +- You must have python_script enabled [See documentation](https://www.home-assistant.io/integrations/python_script) +- You must have browser_mod installed [See documentation](https://github.com/thomasloven/hass-browser_mod) - You must set up an account and create an API key for Wolfram Alpha's [Short Answers](https://products.wolframalpha.com/short-answers-api/documentation) API. Free API keys are alloted 2,000 calls per month. -- You must download the [required pyscript](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fraw.githubusercontent.com%2Fdinki%2FView-Assist%2Frefs%2Fheads%2Fmain%2FView_Assist_custom_sentences%2Fcommunity_contributions%2FAsk_Wolfram%2Fviewassist-get_wolfram_short_answer.py), add your appid to the `appid` parameter, and place this file in your 'pyscripts' directory on your Home Assistant Server. Note that if you have multiple custom sentences using this script, this only needs to be performed once. +- You must download the [required pyscript](https://raw.githubusercontent.com/dinki/View-Assist/refs/heads/main/View_Assist_custom_sentences/community_contributions/Ask_Wolfram/viewassist_wolfram_short_answer.py), add your appid to the `appid` parameter, and place this file in your 'pyscripts' directory on your Home Assistant Server. Note that if you have multiple custom sentences using this script, this only needs to be performed once. ## Changelog diff --git a/wiki/docs/community-contributions/cc-sentences/calculations.md b/wiki/docs/community-contributions/cc-sentences/calculations.md index fd423d0cb..b6b417681 100644 --- a/wiki/docs/community-contributions/cc-sentences/calculations.md +++ b/wiki/docs/community-contributions/cc-sentences/calculations.md @@ -9,8 +9,10 @@ This blueprint allows you to calculate the result of a mathematical expression u ## Prerequisites - You must have Pyscript installed [See installation video](https://www.youtube.com/watch?v=jpJxZaisbGQ) +- You must have python_script enabled [See documentation](https://www.home-assistant.io/integrations/python_script) +- You must have browser_mod installed [See documentation](https://github.com/thomasloven/hass-browser_mod) - You must set up an account and create an API key for Wolfram Alpha's [Short Answers](https://products.wolframalpha.com/short-answers-api/documentation) API. Free API keys are alloted 2,000 calls per month. -- You must download the [required pyscript](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fraw.githubusercontent.com%2Fdinki%2FView-Assist%2Frefs%2Fheads%2Fmain%2FView_Assist_custom_sentences%2Fcommunity_contributions%2FAsk_Wolfram%2Fviewassist-get_wolfram_short_answer.py), add your appid to the `appid` parameter, and place this file in your 'pyscripts' directory on your Home Assistant Server. Note that if you have multiple custom sentences using this script, this only needs to be performed once. +- You must download the [required pyscript](https://raw.githubusercontent.com/dinki/View-Assist/refs/heads/main/View_Assist_custom_sentences/community_contributions/Ask_Wolfram/viewassist_wolfram_short_answer.py), add your appid to the `appid` parameter, and place this file in your 'pyscripts' directory on your Home Assistant Server. Note that if you have multiple custom sentences using this script, this only needs to be performed once. ## Changelog diff --git a/wiki/docs/community-contributions/cc-sentences/conversions.md b/wiki/docs/community-contributions/cc-sentences/conversions.md index ae4c93fa8..65472fc5b 100644 --- a/wiki/docs/community-contributions/cc-sentences/conversions.md +++ b/wiki/docs/community-contributions/cc-sentences/conversions.md @@ -9,8 +9,10 @@ This blueprint allows you to measurements from one unit to another using Wolfram ## Prerequisites - You must have Pyscript installed [See installation video](https://www.youtube.com/watch?v=jpJxZaisbGQ) +- You must have python_script enabled [See documentation](https://www.home-assistant.io/integrations/python_script) +- You must have browser_mod installed [See documentation](https://github.com/thomasloven/hass-browser_mod) - You must set up an account and create an API key for Wolfram Alpha's [Short Answers](https://products.wolframalpha.com/short-answers-api/documentation) API. Free API keys are alloted 2,000 calls per month. -- You must download the [required pyscript](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fraw.githubusercontent.com%2Fdinki%2FView-Assist%2Frefs%2Fheads%2Fmain%2FView_Assist_custom_sentences%2Fcommunity_contributions%2FAsk_Wolfram%2Fviewassist-get_wolfram_short_answer.py), add your appid to the `appid` parameter, and place this file in your 'pyscripts' directory on your Home Assistant Server. Note that if you have multiple custom sentences using this script, this only needs to be performed once. +- You must download the [required pyscript](https://raw.githubusercontent.com/dinki/View-Assist/refs/heads/main/View_Assist_custom_sentences/community_contributions/Ask_Wolfram/viewassist_wolfram_short_answer.py), add your appid to the `appid` parameter, and place this file in your 'pyscripts' directory on your Home Assistant Server. Note that if you have multiple custom sentences using this script, this only needs to be performed once. ## Changelog diff --git a/wiki/docs/developer-resources/general-information.md b/wiki/docs/developer-resources/general-information.md index 3a0447b9a..88e0a095a 100644 --- a/wiki/docs/developer-resources/general-information.md +++ b/wiki/docs/developer-resources/general-information.md @@ -58,7 +58,7 @@ target_satellite_device is set by looking through all of the View Assist instanc ## How are VA status and launch icons defined? -VA provides a method for providing both status and launch icons in the top right side of the view area. These icons are custom button elements that can be defined in the [icon template](https://github.com/dinki/View-Assist/blob/main/View%20Assist%20dashboard%20and%20views/dashboard/dashboard.yaml#L512) portion of the dashboard. These custom button icons follow the same flexibility for adding actions based on single and double tape as well as long press. Aside from the built in VA functionality, the user is free to create these to fire services based on the type of press. Here is an example for creating a weather icon that when single pressed will change views to the `weather` view using the `navigate` service: +VA provides a method for providing both status and launch icons in the top right side of the view area. These icons are custom button elements that can be defined in the [icon template](https://github.com/dinki/View-Assist/blob/main/View%20Assist%20dashboard%20and%20views/dashboard/dashboard.yaml#L512) portion of the dashboard. These custom button icons follow the same flexibility for adding actions based on single and double tap as well as long press. Aside from the built in VA functionality, the user is free to create these to fire services based on the type of press. Here is an example for creating a weather icon that when single pressed will change views to the `weather` view using the `navigate` service: ``` weather: From b15c9c16bb339cbdfbf49ea383087366cab59182 Mon Sep 17 00:00:00 2001 From: Donny F Date: Wed, 28 Jan 2026 16:22:01 -0600 Subject: [PATCH 2/5] document changes --- wiki/docs/extend-functionality/views/clock/index.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/wiki/docs/extend-functionality/views/clock/index.md b/wiki/docs/extend-functionality/views/clock/index.md index 40a8eceb7..18f6c40a7 100644 --- a/wiki/docs/extend-functionality/views/clock/index.md +++ b/wiki/docs/extend-functionality/views/clock/index.md @@ -20,7 +20,9 @@ Views are automatically installed courtesy of the View Assist integration ## Changelog -| Version | Description | -| ------- | ---------------------------- | -| v 1.4.0 | Update for better night mode | -| v 1.0.0 | Initial release | +| Version | Description | +| ------- | ------------------------------ | +| v 1.5.1 | Fix for night mode white pixel | +| v 1.5.0 | Various improvements | +| v 1.4.0 | Update for better night mode | +| v 1.0.0 | Initial release | From 313934156ae5851214c6cb54cf162e358277b273 Mon Sep 17 00:00:00 2001 From: Donny F Date: Thu, 29 Jan 2026 09:21:45 -0600 Subject: [PATCH 3/5] wiki updates --- wiki/docs/extend-functionality/index.md | 4 ++-- wiki/docs/faq.md | 9 +++++++++ wiki/docs/view-assist-configuration/index.md | 2 ++ 3 files changed, 13 insertions(+), 2 deletions(-) diff --git a/wiki/docs/extend-functionality/index.md b/wiki/docs/extend-functionality/index.md index 76d6f7e8a..2c6d72a2f 100644 --- a/wiki/docs/extend-functionality/index.md +++ b/wiki/docs/extend-functionality/index.md @@ -1,8 +1,8 @@ --- -title: "Extend Voice Functionality" +title: "Automations & Views" sidebar_position: 4 --- View Assist is easily extendable by adding custom sentences which provide data to different custom views. In this section you will find a gallery of premade custom sentence blueprints for easy installation. You will find links to the requird integrations, required views and installation instructions. -We encourage everyone to share their creations so that others might enjoy what you have brought to life. Note that these submissions will be provided under the 'Community Submissions' section for the blueprints, views and integration requirements. These items are supported by the author of these submissions and any questions or comments should be directed to the author or discussed in the 'Community Submissions' channel on our Discord server. \ No newline at end of file +We encourage everyone to share their creations so that others might enjoy what you have brought to life. Note that these submissions will be provided under the 'Community Submissions' section for the blueprints, views and integration requirements. These items are supported by the author of these submissions and any questions or comments should be directed to the author or discussed in the 'Community Submissions' channel on our Discord server. diff --git a/wiki/docs/faq.md b/wiki/docs/faq.md index 99e6e8a23..8d8ef86e9 100644 --- a/wiki/docs/faq.md +++ b/wiki/docs/faq.md @@ -25,3 +25,12 @@ You are trying to use View Assist on a PC or other nonView Assist satellite devi View Assist relies on Assist voice automations to provide information dynamically to the views. When you browse to views manually you will not have the underlying data the view needs to display something worth seeing. + +
+ Why doesn't my view change when I issue the commands from the videos and wiki? + +View Assist relies on automations from the View Assist blueprints to incorporate those controls. Some have made assumptions that everything is provide on View Assist integration install. This is incorrect. The View Assist controls are ala carte in that you can choose which you want to incoroporate and which you do not. Additionally, the blueprints allow for more control of what sentence triggers to use, what language to communicate in and other options that cannot be set globally for all users. + +See the sidebar menu option ['Automations and Views'](./extend-functionality/index.md) for more information. + +
diff --git a/wiki/docs/view-assist-configuration/index.md b/wiki/docs/view-assist-configuration/index.md index ccd31b9ea..dd54dfed3 100644 --- a/wiki/docs/view-assist-configuration/index.md +++ b/wiki/docs/view-assist-configuration/index.md @@ -7,3 +7,5 @@ The View Assist integration allows for easy creation and management of View Assi - [View Assist Master Configuration](./masterconfig-configuration/index.md) - The View Assist master configuration contains the default values for all satellites. These settings make it easy to deploy many satellites without the need to modify each with the same values. - [View Assist Satellite Creation](./satellite-creation/index.md) - Adding a new device to the View Assist collection of satellites + +Once complete, be sure to create the automations you want to use by creating them with the included View Assist blueprints. See the [Automations & Views](./extend-functionality/index.md) section for more information. From 45fbad5772543870c630d1f975a7e4d9cbe8a8db Mon Sep 17 00:00:00 2001 From: Donny F Date: Thu, 29 Jan 2026 09:28:15 -0600 Subject: [PATCH 4/5] link fix --- wiki/docs/view-assist-configuration/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki/docs/view-assist-configuration/index.md b/wiki/docs/view-assist-configuration/index.md index dd54dfed3..dea750b04 100644 --- a/wiki/docs/view-assist-configuration/index.md +++ b/wiki/docs/view-assist-configuration/index.md @@ -8,4 +8,4 @@ The View Assist integration allows for easy creation and management of View Assi - [View Assist Master Configuration](./masterconfig-configuration/index.md) - The View Assist master configuration contains the default values for all satellites. These settings make it easy to deploy many satellites without the need to modify each with the same values. - [View Assist Satellite Creation](./satellite-creation/index.md) - Adding a new device to the View Assist collection of satellites -Once complete, be sure to create the automations you want to use by creating them with the included View Assist blueprints. See the [Automations & Views](./extend-functionality/index.md) section for more information. +Once complete, be sure to create the automations you want to use by creating them with the included View Assist blueprints. See the [Automations & Views](../extend-functionality/index.md) section for more information. From fac10e01325186f490f25b58ae03c6f5b6497657 Mon Sep 17 00:00:00 2001 From: Donny F Date: Thu, 29 Jan 2026 09:36:48 -0600 Subject: [PATCH 5/5] Change wording to hopefully help understanding --- wiki/docs/extend-functionality/index.md | 2 +- wiki/docs/extend-functionality/sentences/index.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/wiki/docs/extend-functionality/index.md b/wiki/docs/extend-functionality/index.md index 2c6d72a2f..30cbfd82e 100644 --- a/wiki/docs/extend-functionality/index.md +++ b/wiki/docs/extend-functionality/index.md @@ -3,6 +3,6 @@ title: "Automations & Views" sidebar_position: 4 --- -View Assist is easily extendable by adding custom sentences which provide data to different custom views. In this section you will find a gallery of premade custom sentence blueprints for easy installation. You will find links to the requird integrations, required views and installation instructions. +View Assist is easily extendable by adding custom sentences automations which provide data to different custom views. In this section you will find a gallery of premade custom sentence blueprints for easy installation. You will find links to the requird integrations, required views and installation instructions. We encourage everyone to share their creations so that others might enjoy what you have brought to life. Note that these submissions will be provided under the 'Community Submissions' section for the blueprints, views and integration requirements. These items are supported by the author of these submissions and any questions or comments should be directed to the author or discussed in the 'Community Submissions' channel on our Discord server. diff --git a/wiki/docs/extend-functionality/sentences/index.md b/wiki/docs/extend-functionality/sentences/index.md index 5a19f1824..941b8f7c9 100644 --- a/wiki/docs/extend-functionality/sentences/index.md +++ b/wiki/docs/extend-functionality/sentences/index.md @@ -1,13 +1,13 @@ --- -title: Sentence Gallery +title: Automations Gallery sidebar_position: 1 --- -View Assist is easily extendable by adding custom sentences which provide data to different custom views. On this page you will find a gallery of premade custom sentences. You will find links to the requirements and installation instructions. Blueprints have been made available for easy installation. +View Assist is easily extendable by adding custom sentences automations which provide data to different custom views. On this page you will find a gallery of premade custom sentences blueprints. You will find links to the requirements and installation instructions. These blueprints have been made available for easy installation. You MUST use these to extend the base Home Assistant voice experience to fully utilize View Assist. Use these blueprints to create automations to fit your needs. We encourage everyone to share their creations so that others might enjoy what you have brought to life. These user submitted blueprints can be found in the [Community Contribution](../../community-contributions/index.md) section of the wiki. -| Sentence | Description | Languages | +| Automations | Description | Languages | | --------------------------------------------------------------- | ------------------------------------------------------------------------------------- | -------------------------- | | [Alarms Reminders & Timers](sentences/alarms-reminders-timers) | Allows for an on demand call to create and list alarms, reminders and timers | en | | [Broadcast](sentences/broadcast) | Broadcast messages to other View Assist Satellites | en |