HASS.Agent

Windows-based client for Home Assistant. Provides notifications, quick actions, commands, sensors and more.

MIT License

Stars
1.6K
Committers
7

Bot releases are hidden (Show)

HASS.Agent - 2022.14.0 Latest Release

Published by LAB02-Admin almost 2 years ago

This is a small 'in between' release with just bugfixes & improvements, no new functionality. As it goes with fixing bugs in complex environments - it always creates new ones, so please keep notifying me if you find any :)


Improvements

  • Translations:

    • New translation: Turkish (thanks Alp)
    • New translation: Polish (thanks MichoP and team)
  • Powershell sensor output support for characters like umlaut (thanks steff)

  • Notifier: HASS.Agent will try to check if it has permission from Windows to show notifications

    • This will only show in logs for troubleshooting purposes, no popup

Bugfixes

  • QuickActions: entity dropdown bugs on 0 entities (thanks Moldis)

  • QuickActions: certain domains have their entities perpetually added (thanks Moldis)

  • QuickActions: cover stop triggers media_stop [#159] (thanks @menuet88)

  • WebView in tray: doesn't relocate after a resolution change

  • Fast-switching between commands/local sensors gives unhandled exceptions

  • Display sensor: alternative dpi results in wrong resolution, incomplete display naming [#199] (thanks @ITensEI)

    • From now on, the Virtual attributes show usable resolutions
    • The others contain the actual resolution, ignoring DPI
    • Added RotatedDegrees as a hidden bonus feature
  • Installer wrongly fails internet connectivity test [#196] (thanks @waps11)

  • Post-sleep resume not correctly detected, handle disconnects/sensor update smarter [#204] (thanks everyone reporting)

    • I'm unable to replicate this, so let me know if it still occurs
  • MediaPlayer: media_player entity not showing up in Music Assistant integration (thanks @Protoncek)

    • This required volume control to be added to the HASS.Agent integration - another hidden bonus feature
  • MediaPlayer: volume always set to 0 in integration

  • MediaPlayer: crash when MQTT is disabled [#156] (thanks @cbarth3)

  • ProcessActive: process names with full stops get truncated (thanks benjani85)

  • LoggedUser(s) sensor: show actual logged-in user instead of connected [#158], [#168] (thanks @energywave and @shuntfield)

  • Powershell sensor: wrong output parsing [#201] (thanks @icegothic)

  • WebView in tray: topmost not working [#160] (thanks @brainiac19 and ewonais)

  • Forms freeze with non-topmost messagebox open

  • MediaPlayer: only log identical monitoring errors once

  • AudioSensors: Default Device volume rounding fault (thanks Chreece)

  • Hide icon-only listview columnnames in all languages

HASS.Agent - 2022.14.0-beta1

Published by LAB02-Admin almost 2 years ago

Note: this is a beta release!


The coming release (2022.14) will be a small 'inbetween' release with just bugfixes & improvements, no new functionality. As it goes with fixing bugs in complex environments - it always creates new ones, so please notify me if you find any :)


Bugfixes

  • QuickActions: entity dropdown bugs on 0 entities (thanks Moldis)

  • QuickActions: certain domains have their entities perpetually added (thanks Moldis)

  • QuickActions: cover stop triggers media_stop [#159] (thanks @menuet88)

  • WebView in tray: doesn't relocate after a resolution change

  • Fast-switching between commands/local sensors gives unhandled exceptions

  • Display sensor: alternative dpi results in wrong resolution, incomplete display naming [#199] (thanks @ITensEI)

    • From now on, the Virtual attributes show usable resolutions
    • The others contain the actual resolution, ignoring DPI
    • Added RotatedDegrees as a hidden bonus feature
  • Installer wrongly fails internet connectivity test [#196] (thanks @waps11)

  • Post-sleep resume not correctly detected, handle disconnects/sensor update smarter [#204] (thanks everyone reporting)

    • I'm unable to replicate this, so let me know if it still occurs
  • MediaPlayer: media_player entity not showing up in Music Assistant integration (thanks @Protoncek)

    • This required volume control to be added to the HASS.Agent integration, so another hidden bonus feature
  • MediaPlayer: volume always set to 0 in integration

  • MediaPlayer: crash when MQTT is disabled [#156] (thanks @cbarth3)

  • ProcessActive: process names with full stops get truncated (thanks benjani85)

  • LoggedUser(s) sensor: show actual logged-in user instead of connected [#158], [#168] (thanks @energywave and @shuntfield)

  • Powershell sensor: wrong output parsing [#201] (thanks @icegothic)

  • Support for other characters like umlaut (thanks steff)

  • WebView in tray: topmost not working [#160] (thanks @brainiac19 and ewonais)

  • Forms freeze with non-topmost messagebox open

  • Notifier: check if HASS.Agent has permission from Windows to show notifications

HASS.Agent - 2022.13.0

Published by LAB02-Admin almost 2 years ago

Heads up: this is quite the release, so you might want to click the 'Release Page' link to open the notes in a browser (easier to read). You'll still be able to use the 'Install Update' button afterwards.


TL;DR breaking changes: if you use the notifier integration and aren't planning on using the new integration, update it to the latest version in HACS (no other change necessary). Because of sensor attributes being added to the multivalue sensors (and some of their individual sensors removed), your automations/scripts may need adjustments.


First of all: sorry, it's been a while. The past few months were busier than expected, but I think it's worth the wait: this release has quite a few nice additions! The last release got over 18k downloads, which is really awesome :) Thanks to everyone using HASS.Agent, submitting suggestions, bugreports and tips, creating youtube howto videos. Thanks to everyone who donated, it's really appreciated a lot, and thanks to the monthly sponsors! <3

Probably the most notable addition is @fillefilip8's work. First, he implemented actionable notifications! He did a great job: it's a very neat implementation and uses the same structure as the companion apps, so if you have those setup, it's a breeze to add them to HASS.Agent as well.

But he didn't stop there, and decided to create an entire new integration from scratch, providing:

  • MQTT support

    • As long as you can reach your broker, you can now receive notifications and use the mediaplayer functionality wherever you are
    • No more messing with port reservations or firewall rules
  • Autodiscovery

    • Your devices show up by magic in HA's integration page
    • No more looking up your device's IP
    • Don't use MQTT? You can still add your device using the local API, through a config flow! No more yaml :)
  • Improved mediaplayer

    • Support for seek, position and cover art
      • Only when supported by the media app, like Spotify
    • So so snappy! No more lagging behind
  • Improved notifications

    • Use device triggers to easily create new actions
    • Change the default notification title through UI
    • Use media_source in the image field
    • Supports camera proxy: /api/camera_proxy/camera.camera_name
  • One integration to rule (integrate?) them all

    • Contains both notifications and mediaplayer
    • Both MQTT and HASS.Agent's legacy local API are supported

This integration is now available through HACS (simply called HASS.Agent). You don't have to switch: if you're happy with your current setup, everything will keep working (as long as you update the notifier integration through HACS). If you do switch, consider removing your old notification and media_player entities.

From now on, this integration will be considered the default, and the other two as (still supported) legacy. So, HASS.Agent will no longer automatically process the port reservation + firewall rule. You can still do so through the Configuration window. If you're switching to the new integration, consider removing the firewall rule from your system, for a little extra security.

Please test as much as you can, and report any bugs/strange behavior :)

The second notable change is that sensors can now use attributes! This is especially useful for multivalue sensors, and really cleans up the entity list HASS.Agent creates. Attributes have been implemented in all of them, and there's also a new one: printers. Contains a ton of info per printer, and info about pending documents. This means usb printers can now be fully integrated into HA as well.

However, this does mean that if you created automations/scripts using the old sensors, they may not work anymore. For instance; the storage sensor created a lot of sensors, but now only one per volume with its values (and more added!) as attributes.

All changes and features require a lot of documentation rewriting, which will get done over the following days. If you have examples or other useful stuff to share, let me know and I'll put them online.


Features & improvements

  • New monthly sponsor: @jdiegmueller, thank you! <3

  • New monthly sponsor: @ewonais, thank you! <3

  • Translations:

    • German translation is now completed (thanks @Syntoxr)
    • New translation: Russian (thanks Ravkovski1306)
    • Added translation: French (thanks team, note: 92% done)
    • Slovenian language got improved (thanks Pavel)
    • English translation got its capitalization refactored (thanks Skully)
    • These languages are partially done, if you can please help complete them:
      • Ukrainian, Swedish, Polish, Russian and French
  • Actionable notifications! (thanks @fillefilip8)

  • Support and UI changes for @fillefilip8's new integration

  • Sensors now have the ability to include attributes

    • This has been implemented for all new ánd existing multivalue sensors
    • Most of the existing multivalue sensors have extra info added in their attributes
      • For instance, Storage now shows diskspace used and available as percentages
  • The Key command now detects the key you want to press

    • Instead of having to look up the keycode, just press the key you want simulated
    • The corresponding code will be set for you
    • This doesn't affect the MultipleKeys command
  • DeviceName sanitation can now be disabled (thanks ABEIDO)

    • Use this if you're sure the name you want won't cause troubles in HA
    • The checkbox is in Configuration -> General
  • You can now completely disable the state toasts

    • This applies to the MQTT and HA (dis)connected messages
    • The checkbox's in Configuration -> General
  • New sensor: BluetoothDevices (thanks ChrisRosenkreuz23)

    • Creates a sensor showing the amount of bluetooth devices (both connected and disconnected)
    • The devices are added as attributes, containing: ID, name, paired state and connected state
  • New sensor: BluetoothLeDevices (thanks ChrisRosenkreuz23)

    • Creates a sensor showing the amount of LE bluetooth devices (both connected and discovered)
    • The devices are added as attributes, containing: ID, name, connected state and last seen (UTC)
    • Contains only devices that have been seen since the last scan interval
  • Added manage satellite service button to its configuration page

  • The Satellite Service now uses HASS.Agent's MQTT configuration by default

    • Except client_id
    • When you change the settings in the configuration page, they get synced to the service as well
  • Sensor- and command names are now sanitized on creation to prevent rejection by HA (thanks @RamonaSteve)

  • WindowsUpdates multivalue sensor now uses attributes

    • Available driver & software updates sensors (containing update names, type and other info)
    • Driver & software pending update count sensors
  • Display multivalue sensor now uses attributes

    • Every display has its own sensor, with its info as attributes
    • Added a default display sensor, and amount of displays
  • Storage multivalue sensor now uses attributes

    • Every partition has its own sensor, with its info as attributes
    • Added a total disk count sensor
  • Network multivalue sensor now uses attributes

    • Every network card has its own sensor (or the one you specified), with its info as attributes
  • Audio multivalue sensor now uses attributes

    • This only applies to the 'audio sessions' sensor, the rest is the same
  • New multivalue sensor: Printers

    • Provides information about all installed (usb and network) printers and their queues
    • Creates a sensor per printer, with its state as attributes
    • Also creates a sensor for the default printer ('queue') and the amount of pending prints
  • New command: MonitorSleep

  • New command: MonitorWake

  • New command: SetVolume

    • Sets the volume of the current default audiodevice to the provided value
    • Can be used with an Action
  • New sensor: MonitorPowerState (thanks Buffalo_Bro)

    • Provides the last monitor power state change:
      • Dimmed, PowerOff, PowerOn and Unknown
  • New sensor: PowershellOutput

    • Contains whatever output your powershell command or script gives, converted to text
    • You can test using the test button when creating the sensor
  • New sensor: WindowState (thanks TheHolyRoger)

    • Provides the current state of the process' window:
      • Hidden, Maximized, Minimized, Normal and Unknown
  • New sensors: MicrophoneProcess and WebcamProcess [#108] (thanks @DennisGaida)

    • Contains the name of the process using the device, or nothing if it's not being used
    • The existing MicrophoneActive and WebcamActive sensors still exist
  • You can now configure the tray icon to show the default menu on left-click (thanks madelena)

    • Only applicable when a WebView's set as the right-click action
    • This is a work-in-progress, ymmv
  • Home Assistant API now has an allow untrusted certificates option (thanks Moldis)

  • MQTT can now be completely disabled (thanks AfcaEricNL)

    • This will also disable commands, sensors and the use of the new integration
  • HASS.Agent now checks the HA API token for unexpected chars and minimum length (thanks doge & @Syntoxr)

  • HASS.Agent now checks the URI formatting of the HA API & MQTT broker

  • AudioSensor: added global muted state (thanks Nejc)

  • AudioSensor: added input device info (thanks ChrisRosenkreuz23)

    • Default Input Device
    • Default Input Device State
    • Default Input Device Muted
    • Default Input Device Volume
  • LibreHardwareMonitorLib updated to latest version

  • AudioSensors now tries to show the complete friendly name [#44] (thanks @dimmuboy and @tachibanayui)

Bugfixes

  • LoggedUser sensor shows wrong value if logged in as another user [#38] (thanks @bverkron)

  • MQTT: client doesn't respect the allow untrusted certificates flag [#82] (thanks @DeerMaximum)

  • Button texts become misaligned on the main window

  • Webview cache location textbox remains empty

  • MQTT: gracefully handle NotAuthorized [#77] (thanks @klkohl)

  • Local API: port reservation needs to be done for all users [#90] (thanks @JvdMaat)

  • Satellite Service: changed name doesn't propagate to new entities

  • Satellite Service: various sensors aren't being stored properly [#68] (thanks @JvdMaat)

  • Powershell sensor: remove newline chars ending [#152] (thanks @99030063)

  • MQTT: device doesn't register if its name contains a whitespace

  • Improve handling of non-standard scaling [#99] (thanks @gorbunovav)

  • WebView: tray icon variant doesn't remember position for 'preview' button [#103] (thanks @Majumafoo)

  • WebView: 'Keep page loaded in the background' impacts all Webviews, processes never close [#131] (thanks @NCopeman)

  • WebView and LaunchUrl fail when using Action (thanks neonDog)

  • MQTT: messages are not sent with retain flag [#128] (thanks @TarcisioMenezes)

  • HASS.Agent no longer crashes when the OS doesn't support its media functionality [#113] (thanks @RafaelEstevamReis and @Stuke00)

HASS.Agent - 2022.13.0-beta4

Published by LAB02-Admin about 2 years ago

Note: this is a beta release!


Last beta, @fillefilip8 implemented actionable notifications, which was already awesome. Well, he didn't stop there, and decided to create an entire new integration from scratch, providing:

  • MQTT support

    • As long as you can reach your broker, you can now use notifications and mediaplayer functionality wherever you are
    • No more messing with port reservations or firewall rules
  • Autodiscovery

    • Your devices show up by magic in HA's integration page
    • No more looking up your device's IP
    • Don't use MQTT? You can still add your device using the local API, through a config flow! No more yaml :)
  • Improved mediaplayer

    • Support for seek, position and cover art
      • Requires a media application that supports Windows' media API, eg. Spotify
    • So so snappy! No more lagging behind
  • Improved notifications

    • Use device triggers to easily create new actions
    • Change the default notification title through UI
    • Use media_source in the image field
  • One integration to rule (integrate?) them all

    • Contains both notifications and mediaplayer
    • Both MQTT and the legacy local API are supported
    • Not ready to switch? The old integrations still work

Documentation will follow later, but the new notification action docs posted in the last release notes still apply:
https://hassagent.readthedocs.io/en/latest/notifications/notification-actionable/

The integration's pending to be merged on HACS, but you can manually add the repo:

https://github.com/LAB02-Research/HASS.Agent-Integration

This beta is a release candidate, so the more testers the better :)


Features & improvements

  • Support and UI changes for @fillefilip8's new integration

  • New sensor: BluetoothDevices (thanks ChrisRosenkreuz23)

    • Creates a sensor showing the amount of bluetooth devices (both connected and disconnected)
    • The devices are added as attributes, containing: ID, name, paired state and connected state
  • New sensor: BluetoothLeDevices (thanks ChrisRosenkreuz23)

    • Creates a sensor showing the amount of LE bluetooth devices (both connected and discovered)
    • The devices are added as attributes, containing: ID, name, connected state and last seen (UTC)
    • Contains only devices that have been seen since the last scan interval
  • Added manage satellite service button to its configuration page

  • The Satellite Service now uses HASS.Agent's MQTT configuration by default

    • Except client_id
    • When you change the settings in the configuration page, they get synced to the service as well
  • Sensor- and command names are now sanitized on creation to prevent rejection by HA (thanks RamonaSteve)

Bugfixes

  • Powershell sensor: remove newline chars ending [#152] (thanks @99030063)
HASS.Agent - 2022.13.0-beta3

Published by LAB02-Admin about 2 years ago

Note: this is a beta release!


A few small additions, and the AudioSensor now supports input devices (eg. a mic), but nevermind that - @fillefilip8 went and implemented actionable notifications!

He did a great job: it's a very neat implementation and uses the same structure as the companion apps, so if you have those setup, it's a breeze to add them to HASS.Agent as well. For usage examples, check the new docs (link in the notes below).

The notifier integration needs to be updated for this to work. To prevent confusion (it's not fully backwards compatible), it won't get published until the stable update of HASS.Agent is released.

However, this means that if you want to install this beta and use notifications (even without actions), you'll have to update manually. Luckily, it's really easy:

Another option is to just skip this beta and wait for the stable release.


Features & improvements

  • Actionable notifications! (thanks @fillefilip8)

  • HASS.Agent now checks the HA API token for unexpected chars and minimum length (thanks doge & @Syntoxr)

  • HASS.Agent now checks the URI formatting of the HA API & MQTT broker

  • AudioSensor: added global muted state (thanks Nejc)

  • AudioSensor: added input device info (thanks ChrisRosenkreuz23)

    • Default Input Device
    • Default Input Device State
    • Default Input Device Muted
    • Default Input Device Volume
  • LibreHardwareMonitorLib updated to latest version

Bugfixes

  • MicrophoneProcess and WebcamProcess sensors have improved detection of the application's name [#108] (thanks @DennisGaida)
HASS.Agent - 2022.13.0-beta2

Published by LAB02-Admin about 2 years ago

Note: this is a beta release!


TL;DR breaking changes: because of sensor attributes being added to the multivalue sensors (and some of their individual sensors removed), your automations/scripts may need adjustments.


Finally, sensors can now use attributes! This is especially useful for multivalue sensors, and really cleans up the entity list HASS.Agent creates. Attributes have been implemented in all of them, and there's also a new one: printers. Contains a ton of info per printer, and info about pending documents.

However, this does mean that if you created automations/scripts using the old sensors, they may not work anymore. For instance; the storage sensor created a lot of sensors, but now only one per volume with its values (and more added!) as attributes.

There are also a bunch of new sensors and commands to tinker with :)


Features & improvements

  • Sensors now have the ability to include attributes

    • This has been implemented for all new ánd old multivalue sensors
    • Most of the old multivalue sensors have extra info added in their attributes
      • For instance, Storage now shows diskspace used and available as percentages
  • WindowsUpdates multivalue sensor now uses attributes

    • Available driver & software updates sensors (containing update names, type and other info)
    • Driver & software pending update count sensors
  • Display multivalue sensor now uses attributes

    • Every display has its own sensor, with its info as attributes
    • And a default display sensor, and amount of displays
  • Storage multivalue sensor now uses attributes

    • Every partition has its own sensor, with its info as attributes
    • And a total disk count sensor
  • Network multivalue sensor now uses attributes

    • Every network card has its own sensor (or the one you specified), with its info as attributes
  • Audio multivalue sensor now uses attributes

    • This only applies to the 'audio sessions' sensor, the rest is the same
  • New multivalue sensor: Printers

    • Provides information about all installed (usb and network) printers and their queues
    • Creates a sensor per printer, with its state as attributes
    • Also creates a sensor for the default printer ('queue') and the amount of pending prints
  • New command: MonitorSleep

  • New command: MonitorWake

  • New command: SetVolume

    • Sets the volume of the current default audiodevice to the provided value
    • Can be used with an Action
  • New sensor: MonitorPowerState (thanks Buffalo_Bro)

    • Provides the last monitor power state change:
      • Dimmed, PowerOff, PowerOn and Unknown
  • New sensor: PowershellOutput

    • Contains whatever output your powershell command or script gives, converted to text
    • You can test using the test button when creating the sensor
  • New sensor: WindowState (thanks TheHolyRoger)

    • Provides the current state of the process' window:
      • Hidden, Maximized, Minimized, Normal and Unknown
  • New sensors: MicrophoneProcess and WebcamProcess [#108] (thanks @DennisGaida)

    • Contains the name of the process using the device, or nothing if it's not being used
    • The existing MicrophoneActive and WebcamActive sensors still exist
  • You can now configure the tray icon to show the default menu on left-click (thanks madelena)

    • Only applicable when a WebView's set as the right-click action
    • This is a work-in-progress
  • Home Assistant API now has an allow untrusted certificates option (thanks Moldis)

  • MQTT can now be completely disabled (thanks AfcaEricNL)

    • This will also disable commands and sensors

Bugfixes

  • MQTT: device doesn't register if its name contains a whitespace

  • Improve handling of non-standard scaling [#99] (thanks @gorbunovav)

  • WebView: tray icon variant doesn't remember position for 'preview' button [#103] (thanks @Majumafoo)

  • 'Keep page loaded in the background' impacts all Webviews, processes never close [#131] (thanks @NCopeman)

  • WebView and LaunchUrl fail when using Action (thanks neonDog)

  • MQTT: messages are not sent with retain flag [#128] (thanks @TarcisioMenezes)

  • HASS.Agent no longer crashes when the OS doesn't support its media functionality [#113] (thanks @RafaelEstevamReis and @Stuke00)

HASS.Agent - 2022.13.0-beta1

Published by LAB02-Admin over 2 years ago

Note: this is a beta release!


A small beta release, containing a few bugfixes and improvements to (hopefully) scratch off my todo list.

Note for the translators (and users of non-English languages): any new or changed to-be-translated texts aren't usually uploaded for translation until the release candidate. This is because that process takes time, and the texts change constantly during development. So this way, there's only one to-be-translated batch per release - but there'll be non-translated texts in the betas.


Features & improvements

  • Translations:

    • German translation is now completed (thanks @Syntoxr)
    • New translation: Russian (thanks Ravkovski1306)
  • The Key command now detects the key you want to press

    • Instead of having to look up the keycode, just press the key you want simulated
    • The corresponding code will be set for you
    • This doesn't affect the MultipleKeys command
  • DeviceName sanitation can now be disabled (thanks ABEIDO)

    • Use this if you're sure the name you want won't cause troubles in HA
    • The checkbox's in Configuration -> General
  • You can now completely disable the state toasts

    • This applies to the MQTT and HA (dis)connected messages
    • The checkbox's in Configuration -> General

Bugfixes

  • LoggedUser sensor shows wrong value if logged in as another user [#38] (thanks @bverkron)

  • MQTT: client doesn't respect the allow untrusted certificates flag [#82] (thanks @DeerMaximum)

  • Button texts become misaligned on the main window

  • Webview cache location textbox remains empty

  • MQTT: gracefully handle NotAuthorized [#77] (thanks @klkohl)

  • Local API: port reservation needs to be done for all users [#90] (thanks @JvdMaat)

  • Satellite Service: changed name doesn't propagated to new entities

  • Satellite Service: various sensors aren't being stored properly [#68] (thanks @JvdMaat)

HASS.Agent - 2022.12.0

Published by LAB02-Admin over 2 years ago

This release contains two major new features: the mediaplayer integration, and the webview component. I'll give them both a short introduction:


You can now control your device as if it were a regular mediaplayer, regardless of what application's actually playing. It has support for 'currently playing' info, but only if the application uses it (e.g. Spotify does, VLC doesn't). And: you can also now use your PC as a text-to-speech device! The implementation's still basic and will be improved in the coming releases. Make sure to check the new docs for info on how to configure and use (listed in the release notes).

The new webview component uses Edge's core to display webpages, without having to launch a full fledged browser. You need Microsoft's webview runtime, but the installer will take care of that for you - or, if you install manually, you'll get the option to download on first use.

It's of course implemented in a new command: WebView. You can easily configure what url to show, its location, size and some other settings. Use the new configure command parameters button when adding a webview command.

The second webview implementation is that you can now configure the tray icon's right mouseclick-button to show a webview instead of the menu. Use this to for instance easily show a dashboard! Check out the new Configuration -> Tray Icon page for all options.


Apart from the new features, the quickactions received some love: the creation page has its layout refreshed, and you can now directly bind your own commands to a quickaction. This means that either through the quickactions popup, or a hotkey, you can trigger any command you've configured. Because it doesn't go by Home Assistant, it's really fast :)

This release also adds initial support for screenreaders (thanks for pointing it out to me @blindndangerous). It was a lot of work (which is why this release took longer than usual), but I'm glad the basics are done. It's not completely covered, so let me know what can be improved. For those interested, I wrote a short blogpost about it: https://lab02-research.org/2022-05-29-accessibility.

Not all items on the 'planned for next release' list are done, but it's been nearly two months since the last release so I thought I'd roll this one out for everyone to use. The next release will be bugfixes, enhancements and new commands/sensors (so no large new features).

A 'heads up': because of the summer months, I'll be either busy at work filling in for coworkers on vacation, or on vacation myself, so the next release might take some time. But I'll still try to answer questions/tickets as soon as I can, as always :)


Features & improvements

  • Add media_player capabilities to HASS.Agent [#31] (thanks @DeftNerd)

  • New command: WebView

    • Can be used to show any webpage, without having to launch a full-fledged browser
    • Use the new configure command parameters button to easily configure what where and how to show
    • Also usable through an Action (so you can set what url to show dynamically in HA)
  • HASS.Agent now supports screenreaders, based on Microsoft's recommendations [#65] (thanks @blindndangerous)

    • Forms and controls have been assigned roles, names and descriptions
    • Controls have been assigned a tab-order value
    • Buttons and textboxes have been assigned a keycode
  • The tray icon's right mouseclick can be configured [#59] (thanks @paccerdk)

    • By default, it shows an options menu
    • You can now configure it to show a webview page
      • For instance, a HA dashboard (your HA url is set by default)
      • Enable keep page loaded in the background to make sure it shows up instantly
      • If you resize the webview, it'll store the new size as its default
    • Configurable through the new Configuration -> Tray Icon page
  • New documentation: https://hassagent.readthedocs.io

    • GitHub's wiki pages won't be updated anymore and will be removed soon
    • Missing docs, or have additions yourself? Let me know :)
  • The QuickAction add/modify window has been updated

  • You can now bind your own commands to a QuickAction

    • Choose the new HASS.Agent Commands domain to show your entities
  • The tray icon's default theme has been aligned with the rest of HASS.Agent

  • The 'Notification API' has been renamed to 'Local API'

    • This is to reflect the fact that the API now has multiple uses
    • Onboarding and configuration have been changed accordingly
  • New command: SendWindowToFront (thanks ChrisRosenkreuz23)

    • Can be used to force a specified process to the foreground
    • Usable as a regular command, or through an action
  • Translations:

    • New translation: Dutch
    • New translation: German (thanks Gerd, JbbDE, r100gspd, Sebastian Tobias Koch and Syntox)
      • Note: this translation is only 68% done
    • New translation: Spanish (thanks Carlos Cordero)
      • Note: this translation has mostly automated translations, results may vary
    • If you're proficient in German or Spanish, please improve!
    • There are a bunch of languages waiting to get some more love, like French and Polish
    • You can dive right in (it's online, easy, and no coding required): https://poeditor.com/join/project/R7HIVG0wie
  • The devicename is now validated and sanitized [#53] (thanks @mdrichardson)

    • Home Assistant rejects your device if it contains certain special characters
    • The check is done during onboarding and when saving configuration changes
      • So you might get a notification saying you've changed your device name, that's actually the sanitation being applied
      • Your sensors and commands will keep working

Bugfixes

  • Satellite Service: unable to create non-switch command types (thanks jello)

  • The MultipleKeysCommand now correctly escapes a bracket (thanks ChrisRosenkreuz23)

    • Escaping can be done by using a backslash, so [ is [\[] and ] is [\]]
  • QuickAction: add/mod window crashes when no entity is found (thanks jello)

  • Username is now put between quotes when registering the local API's port to support spaces (thanks beecho01)

HASS.Agent - 2022.12.0-beta4

Published by LAB02-Admin over 2 years ago

Note: this is a beta release!


This beta adds initial support for screenreaders (thanks for pointing it out to me @blindndangerous). It was a lot of work (which is why this beta took longer than usual), but I'm glad the basics are done. It's not completely covered, so let me know what can be improved. For those interested, I wrote a short blogpost about it: https://lab02-research.org/2022-05-29-accessibility.

This is a release candidate, even though not all 'planned for next release' tickets are done. But by releasing, everyone can start using the new webview and mediaplayer functionality while I finish up the list.


Features & improvements

  • New translation: Dutch

  • New translation: Spanish (thanks Carlos Cordero)

    • Note: this translation has mostly automated translations, results may vary
      • If you're proficient in Spanish, please improve!
    • There are a bunch of languages waiting to get some more love, like French, German and Polish
  • HASS.Agent now supports screenreaders, based on Microsoft's recommendations [#65] (thanks @blindndangerous)

    • Forms and controls have been assigned roles, names and descriptions
    • Controls have been assigned a tab-order value
    • Buttons and textboxes have been assigned a keycode
  • The devicename is now validated and sanitized [#53] (thanks @mdrichardson)

    • Home Assistant would reject your device if it contained certain special characters
    • The check is done during onboarding and when saving configuration changes
      • So you might get a notification saying you've changed your device name, that's actually the sanitation being applied
      • Your sensors and commands will keep working

Bugfixes

  • Satellite Service: unable to create non-switch command types (thanks jello)

  • The MultipleKeysCommand now correctly escapes a bracket (thanks ChrisRosenkreuz23)

    • Escaping can be done by using a backslash, so [ is [\[] and ] is [\]]
  • QuickAction: add/mod window crashes when no entity is found (thanks jello)

  • Username is now put between quotes when registering the local API's port to support spaces (thanks beecho01)

HASS.Agent - 2022.12.0-beta3

Published by LAB02-Admin over 2 years ago

Note: this is a beta release!


Two hotfixes for yesterday's beta. If they don't apply to you, feel free to skip.


Bugfixes

  • Windows shutdown is blocked when keep page loaded in the background is enabled for the new trayicon webview

  • When using a non-default DPI scaling, the new trayicon webview doesn't scale [#62] (thanks @holdestmade)

    • I've enabled a new scaling mechanism, which generally looks fine and fixes this bug
    • Because of the new mechanism, some other parts (mostly text) don't render correctly
      • Like the tabpage-titles in Configuration
    • Scaling is a work in progress, sorry
    • Let me know if something can't be used at all
HASS.Agent - 2022.12.0-beta2

Published by LAB02-Admin over 2 years ago

Note: this is a beta release!


The main addition of this release is the new 'webview' component. It uses Edge's engine to display webpages, without having to launch a full fledged browser. You need Microsoft's webview runtime, but the installer will take care of that for you - or, if you install manually, you'll get the option to download when first using it.

It's of course implemented in a new command: WebView. You can easily configure what url to show, its location, size and some other settings. Use the new configure command parameters button when adding a webview command.

The second implementation is that you can now configure the tray icon's right mouseclick-button to show a webview instead of the menu. Use this to for instance easily show a dashboard! Check out the new Configuration -> Tray Icon page for all options.

The quickactions also received some love: the creation page has its layout refreshed, and you can now directly bind your own commands to a quickaction. This means that either through the quickactions popup, or a hotkey, you can trigger any command you've configured. Because it doesn't go by Home Assistant, it's really fast :)

The next beta will be focussed on bugfixes and small additions, so let me know if there's something not working / missing! Consult the 'Planned For Next Release' section of the issue tracker to see what's currently planned (that list is always subject to change though): https://lab02research.youtrack.cloud/

Oh and a fyi: the new HASS.Agent MediaPlayer integration has been approved by HACS, so it should now show up in the 'new repositories' list. Please note that since HA's latest release (2022.5) breaks a lot of media_player stuff, you need to install yesterday's release of the integration for it to work. But if you're not on 2022.5 yet, please stay on the previous version of the integration (since the new one won't work there).


Features & improvements

  • New command: WebView

    • Can be used to show any webpage, without having to launch a full-fledged browser
    • Use the new configure command parameters button to easily configure what where and how to show
    • Also usable through an Action (so you can set what url to show dynamically in HA)
  • The tray icon's right mouseclick can be configured [#59] (thanks @paccerdk)

    • By default, it shows an options menu
    • You can now configure it to show a webview page
      • For instance, a HA dashboard (your HA url is set by default)
      • Enable keep page loaded in the background to make sure it shows up instantly
      • If you resize the webview, it'll store the new size as its default
    • Configurable through the new Configuration -> Tray Icon page
  • The QuickAction add/modify window has been updated

  • You can now bind your own commands to a QuickAction

    • Choose the new HASS.Agent Commands domain to show your entities
  • The tray icon's default theme has been aligned with the rest of HASS.Agent

HASS.Agent - 2022.12.0-beta1

Published by LAB02-Admin over 2 years ago

Note: this is a beta release!


This beta release adds support for the new mediaplayer integration! You can now control your device as if it were a regular mediaplayer, regardless of what application's actually playing. It has support for 'currently playing' info, but only if the application uses it (e.g. Spotify does, VLC doesn't).

And: you can also now use your PC as a text-to-speech device!

Since the new integration's awaiting HACS approval (which can take quite some time), if you want to toy with it, just manually add this repo to HACS:
https://github.com/LAB02-Research/HASS.Agent-MediaPlayer

Make sure to check the new wiki page for info on how to configure and use.


Features & improvements

  • Add media_player capabilities to HASS.Agent [#31] (thanks @DeftNerd)

  • The 'Notification API' has been renamed to 'Local API'

    • This is to reflect the fact that the API now has multiple uses
    • Onboarding and configuration has been changed accordingly
  • New command: SendWindowToFront (thanks ChrisRosenkreuz23)

    • Can be used to force a specified process to the foreground
    • Usable as a regular command, or as a new action command
HASS.Agent - v2022.11.4

Published by LAB02-Admin over 2 years ago

Hotfix for 2022.11.3:

  • Changing an existing command's entity type results in two entities in HA (and neither work 'til HASS.Agent restarts) [#56] (thanks Chreece)

Took a while, but here's the next release! It's an 'in between' release: no big new features, but a bunch of tweaks, bugfixes and improvements. Still nice though, you can for instance now attach variables to your commands when triggering them from HA (e.g. an URL you want to have opened) - there are examples in the wiki. And more: commands can have their entity type set from within HASS.Agent, you can see your sensors' latest values, new test buttons for your wmi/ps querys, ..

HASS.Agent now supports localization, with @LeandroIssa kicking things off with his beautiful Portuguese (BR) translation. A bunch of other languages are in progress, read below on how you can help out (if you want).

Not as interesting, but noteworthy (because it means older versions will stop receiving 'update available' messages): from now on HASS.Agent follows a different versioning schema, to allow me to better plan releases. Simply put: this is release 2022.11.3 - released in the year 2022, the 11th release of the year (already!), and the 3rd revision of that release. The next beta will be noted as 2022.12.0-beta1. If you're that bored, you can read more on the 'why' below.

Speaking of being bored, you can now follow what I'm working on, what's planned for the next release and what's on the backlog, on the new issue tracker: https://lab02research.youtrack.cloud. It's read-only, please keep using GitHub for new tickets.

Finally, I'd like to thank everyone who's been taking the time to post bug/issue/idea tickets, and all beta testers. I really appreciate it!


Features & improvements

  • You can now choose the command entity type

    • Currently supported: button, light, lock, siren and switch
    • The selected type doesn't change the way the command is handled
  • You can now send additional variables to commands

    • I'm using HA's 'action' MQTT topic, so I called them actions
    • Currently supported: Custom, Custom Executor, Launch Url and Powershell
    • You can use an action (the name works out) in your HA automations and scripts to publish the variables
    • This will trigger the command to run the specified value
    • You can either pre-specify a command in HASS.Agent, or leave the command field empty (so what you send will be executed as-is)
      • Either way, it's up to you to define the correct (escaped) quotes
  • Added localization support

    • Thanks @LeandroIssa for all your help, effort and patience during my first localization attempt ever!
    • Translators: @LeandroIssa (Portuguese BR), Neilge (French), @Syntoxr (German), AirChreece (Greek), Łukasz (Polish) and Nejc (Slovenian)
    • If you want to help them out, or start translating another language, you can easily do so here:
  • You can now select a specific network-card for the Network multivalue-sensor

    • This should drastically decrease the amount of entities added
    • If you've already added the sensor, 'All' is selected by default
  • New sensor: GeoLocation (thanks Neilge)

    • Returns a comma-seperated value: {lat},{lon},{alt}
    • Make sure you've enabled Location Services in Windows
  • The sensor window now shows the current value of your stored sensors

    • You have to store new sensors and reopen the window before its value is shown
    • The list refreshes itself every 5 seconds
    • Only applies to single-value sensors
  • Added test wmi query and test performance counter to the new-sensor window

    • Useful when you want to test whether your settings are ok, and what value they return
  • Setup an issue-tracker to centrally manage all open tickets and requests

    • URL: https://lab02research.youtrack.cloud
    • You can see which tickets are open, which are scheduled for the next release, what's being worked on and what's done
    • Also, for good measure, some graphs
    • It's readonly, please use GitHub or Discord to open new tickets
    • Thanks JetBrains for providing the free service :)
  • New versioning schema

    • Previous schema: {year}.{month}.{day}.{releasenr}
      • Makes it easy to see when a version was released
      • But I don't know whén a version will be released, so doesn't work well with issue-trackers
    • New schema: {year}.{releasenr}.{revision}
      • Since this is the 11th release, it's 2022.11.0
      • If I release a fix for this version, it'll be 2022.11.1, etc
        • Betas will now have -beta{nr} appended to the version
        • So the next beta will be 2022.12.0-beta1
    • Important:
      • After this release, older versions will no longer receive an 'update available' popup!
      • They won't understand the new schema and drop it
      • This is released as 2022.11.3, only to be backwards compatible - for the next release, betas won't count as revisions
  • Satellite Service now follows HASS.Agent's enable extended logging setting

    • This (currently) only applies when you manually launch instead of as a service
    • Right-click HASS.Agent.Satellite.Service.exe and select Run as Administrator
    • By default, the executable can be found in: C:\Program Files (x86)\LAB02 Research\HASS.Agent Satellite Service
    • Only relevant when debugging
  • Task-specific child applications now create their own logfile (for instance when restarting HASS.Agent)

  • Added option to change the interface language to Configuration -> General

  • Added option to change the interface language to the onboarding welcome page

  • Added option to ignore certificate errors for notification images [#42] (thanks @andystewart999)

Bugfixes

  • Modifying a stored QuickAction now correctly loads its domain and entity

  • Execute port reservation doesn't run under expected elevation [#48] (thanks @Aidan-Chey)

  • LastSystemStateChange sensor doesn't change under Satellite Service [#46] (thanks @Aidan-Chey)

  • Satellite Service doesn't clear its entities when receiving an empty list [#46] (thanks @Aidan-Chey)

  • HASS.Agent freezes when selecting a folder or file (thanks Nejc)

  • Home Assistant API connection isn't properly restored when it isn't accessible on HASS.Agent startup [#51] (thanks @VNRARA)

  • When port reservation fails in the configuration screen, the wrong command is copied to the clipboard [#55] (thanks @mdrichardson)

  • The show mqtt action topic button when creating an actionable command doesn't work

HASS.Agent - v2022.11.3

Published by LAB02-Admin over 2 years ago

Took a while, but here's the next release! It's an 'in between' release: no big new features, but a bunch of tweaks, bugfixes and improvements. Still nice though, you can for instance now attach variables to your commands when triggering them from HA (e.g. an URL you want to have opened) - there are examples in the wiki. And more: commands can have their entity type set from within HASS.Agent, you can see your sensors' latest values, new test buttons for your wmi/ps querys, ..

HASS.Agent now supports localization, with @LeandroIssa kicking things off with his beautiful Portuguese (BR) translation. A bunch of other languages are in progress, read below on how you can help out (if you want).

Not as interesting, but noteworthy (because it means older versions will stop receiving 'update available' messages): from now on HASS.Agent follows a different versioning schema, to allow me to better plan releases. Simply put: this is release 2022.11.3 - released in the year 2022, the 11th release of the year (already!), and the 3rd revision of that release. The next beta will be noted as 2022.12.0-beta1. If you're that bored, you can read more on the 'why' below.

Speaking of being bored, you can now follow what I'm working on, what's planned for the next release and what's on the backlog, on the new issue tracker: https://lab02research.youtrack.cloud. It's read-only, please keep using GitHub for new tickets.

Finally, I'd like to thank everyone who's been taking the time to post bug/issue/idea tickets, and all beta testers. I really appreciate it!


Features & improvements

  • You can now choose the command entity type

    • Currently supported: button, light, lock, siren and switch
    • The selected type doesn't change the way the command is handled
  • You can now send additional variables to commands

    • I'm using HA's 'action' MQTT topic, so I called them actions
    • Currently supported: Custom, Custom Executor, Launch Url and Powershell
    • You can use an action (the name works out) in your HA automations and scripts to publish the variables
    • This will trigger the command to run the specified value
    • You can either pre-specify a command in HASS.Agent, or leave the command field empty (so what you send will be executed as-is)
      • Either way, it's up to you to define the correct (escaped) quotes
  • Added localization support

    • Thanks @LeandroIssa for all your help, effort and patience during my first localization attempt ever!
    • Translators: @LeandroIssa (Portuguese BR), Neilge (French), @Syntoxr (German), AirChreece (Greek), Łukasz (Polish) and Nejc (Slovenian)
    • If you want to help them out, or start translating another language, you can easily do so here:
  • You can now select a specific network-card for the Network multivalue-sensor

    • This should drastically decrease the amount of entities added
    • If you've already added the sensor, 'All' is selected by default
  • New sensor: GeoLocation (thanks Neilge)

    • Returns a comma-seperated value: {lat},{lon},{alt}
    • Make sure you've enabled Location Services in Windows
  • The sensor window now shows the current value of your stored sensors

    • You have to store new sensors and reopen the window before its value is shown
    • The list refreshes itself every 5 seconds
    • Only applies to single-value sensors
  • Added test wmi query and test performance counter to the new-sensor window

    • Useful when you want to test whether your settings are ok, and what value they return
  • Setup an issue-tracker to centrally manage all open tickets and requests

    • URL: https://lab02research.youtrack.cloud
    • You can see which tickets are open, which are scheduled for the next release, what's being worked on and what's done
    • Also, for good measure, some graphs
    • It's readonly, please use GitHub or Discord to open new tickets
    • Thanks JetBrains for providing the free service :)
  • New versioning schema

    • Previous schema: {year}.{month}.{day}.{releasenr}
      • Makes it easy to see when a version was released
      • But I don't know whén a version will be released, so doesn't work well with issue-trackers
    • New schema: {year}.{releasenr}.{revision}
      • Since this is the 11th release, it's 2022.11.0
      • If I release a fix for this version, it'll be 2022.11.1, etc
        • Betas will now have -beta{nr} appended to the version
        • So the next beta will be 2022.12.0-beta1
    • Important:
      • After this release, older versions will no longer receive an 'update available' popup!
      • They won't understand the new schema and drop it
      • This is released as 2022.11.3, only to be backwards compatible - for the next release, betas won't count as revisions
  • Satellite Service now follows HASS.Agent's enable extended logging setting

    • This (currently) only applies when you manually launch instead of as a service
    • Right-click HASS.Agent.Satellite.Service.exe and select Run as Administrator
    • By default, the executable can be found in: C:\Program Files (x86)\LAB02 Research\HASS.Agent Satellite Service
    • Only relevant when debugging
  • Task-specific child applications now create their own logfile (for instance when restarting HASS.Agent)

  • Added option to change the interface language to Configuration -> General

  • Added option to change the interface language to the onboarding welcome page

  • Added option to ignore certificate errors for notification images [#42] (thanks @andystewart999)

Bugfixes

  • Modifying a stored QuickAction now correctly loads its domain and entity

  • Execute port reservation doesn't run under expected elevation [#48] (thanks @Aidan-Chey)

  • LastSystemStateChange sensor doesn't change under Satellite Service [#46] (thanks @Aidan-Chey)

  • Satellite Service doesn't clear its entities when receiving an empty list [#46] (thanks @Aidan-Chey)

  • HASS.Agent freezes when selecting a folder or file (thanks Nejc)

  • Home Assistant API connection isn't properly restored when it isn't accessible on HASS.Agent startup [#51] (thanks @VNRARA)

  • When port reservation fails in the configuration screen, the wrong command is copied to the clipboard [#55] (thanks @mdrichardson)

  • The show mqtt action topic button when creating an actionable command doesn't work

HASS.Agent - b2022.11.2

Published by LAB02-Admin over 2 years ago

Note: this is a beta release!


Features & improvements

  • Satellite Service now follows HASS.Agent's enable extended logging setting

    • After you've enabled extended logging, restart the service to activate
  • Task-specific child applications now create their own logfile (for instance restarting HASS.Agent)

Bugfixes

  • 'Execute port reservation' doesn't run under expected elevation [#48] (thanks @Aidan-Chey)
  • LastSystemStateChange sensor doesn't change under Satellite Service [#46] (thanks @Aidan-Chey)
  • Satellite Service doesn't clear its entities when receiving an empty list [#46] (thanks @Aidan-Chey)
  • HASS.Agent freezes when selecting a folder or file (thanks Nejc)
HASS.Agent - b2022.11.1

Published by LAB02-Admin over 2 years ago

Note: this is a beta release!


Bugfixes

  • QuickActions aren't able to fetch their HA entities anymore [#47] (thanks @nrsfhass and Chreece)
  • HASS.Agent keeps reporting the same available beta update, even though it's already installed
  • 'Execute port reservation' doesn't run under expected elevation [#48] (thanks @Aidan-Chey)
HASS.Agent - b2022.11.0

Published by LAB02-Admin over 2 years ago

Note: this is a beta release!


Features & improvements

  • Localization support has been completed for both HASS.Agent and the installer

    • Thanks @LeandroIssa for all your help, effort and patience!
    • Currently, Neilge is working on French and @Syntoxr on German
    • If you want to help them out, or start translating another language, you can do so here:
  • You can now select a specific network-card for the Network multivalue-sensor

    • This should drastically decrease the amount of entities added
    • If you've already added the sensor, 'All' is selected by default
  • Setup an issue-tracker to centrally manage all open tickets and requests

    • URL: https://lab02research.youtrack.cloud
    • You can see which tickets are open, which are scheduled for the next release, what's being worked on and what's done
    • Also, for good measure, some graphs
    • It's readonly, please use GitHub or Discord to open new tickets
  • New versioning schema

    • Previous schema: {year}.{month}.{day}.{releasenr}
      • Makes it easy to see when a version was released
      • But I don't know whén a version will be released, so doesn't work well with issue-trackers
    • New schema: {year}.{releasenr}.{revision}
      • Since this is the 11th release (already!), it's 2022.11.0
      • If I release a fix for this version, it'll be 2022.11.1, etc
        • Betas will now have -beta{nr} appended to the version
        • So this is release 2022.11.0-beta1
    • Important:
      • After this release, older versions will no longer receive an 'update available' popup!
      • They won't understand the new schema and drop it
  • New sensor: GeoLocation (thanks Neilge)

    • Returns a comma-seperated value: {lat},{lon},{alt}
    • Make sure you've enabled Location Services in Windows
  • The sensor window now shows the current value of your stored sensors

    • You have to store new sensors and reopen the window before its value is shown
    • Only applies to single-value sensors
  • Added test wmi query and test performance counter to the new-sensor window

    • Useful when you want to test whether your settings are ok, and what value they return
  • Notifications: you can now opt to ignore certificate errors [#42] (thanks @andystewart999)

Bugfixes

  • Opening a stored QuickAction now correctly loads its domain and entity
HASS.Agent - b2022.4.2

Published by LAB02-Admin over 2 years ago

Note: this is a beta release!


Localization has been added to HASS.Agent and it's started off with a really beautiful language; @LeandroIssa translated everything into Brazilian Portugese!

If you want to help out translating into your (native) language, there's now a wiki page on how to get started:

https://github.com/LAB02-Research/HASS.Agent/wiki/Translating

No coding knowledge required, everything can be done online.


Features & improvements

  • Added localization support

  • Added language: pt-BR [#43] (thanks @LeandroIssa)

  • Added option to change the interface language to Configuration -> General

  • Added option to change the interface language to the onboarding welcome page

  • Added option to ignore certificate errors for notification images [#42] (thanks @andystewart999)

HASS.Agent - b2022.3.31

Published by LAB02-Admin over 2 years ago

Note: this is a beta release!


This beta contains some much requested love for commands: you can now choose the entity type as which the command will be added to Home Assistant, and you can send custom data!

There's a wiki page dedicated to command actions, containing extra screenshots, info and examples - so it's worth having a look:

https://github.com/LAB02-Research/HASS.Agent/wiki/Command-Actions-Usage-&-Examples


Features & improvements

  • You can now choose the command entity type

    • Currently supported: button, light, lock, siren and switch
    • The selected type doesn't change the way the command is handled
  • You can now send additional variables to commands

    • I'm using HA's 'action' MQTT topic, so I called them actions
    • Currently supported: Custom, Custom Executor, Launch Url and Powershell
    • You can use an action (the name works out) in your automations and scripts to publish your variables
      • For examples and info on how you can easily get the right topic, check the wiki page
    • This will trigger the command to run the specified value
    • You can either specify a command in HASS.Agent, or leave the command field empty (so only your arguments will be passed)
      • Either way, it's up to you to define the correct (escaped) quotes
HASS.Agent - v2022.3.27

Published by LAB02-Admin over 2 years ago

The first .NET 6 version, ánd this release contains the new 'satellite service'!

You can use the satellite service to run commands and sensors without having to be logged in, and configure sensors that require elevated privileges (not added yet, but the first round will be hardware-info sensors like CPU temp, etc.).

I tried my best to make it really easy to use, all through HASS.Agent's own UI. If you use the installer (which by now is recommended), everything will be setup for you. There are two places where you can tinker with it:

  • Main window -> new 'Satellite Service' button

    • Configure the fun stuff, ie. the sensors and commands, and the not-so-fun (MQTT) configuration
    • Use the 'copy from hass.agent' button on the MQTT tab to easily copy the current configuration (will use its own client id)
      • Remember to always click 'send and activate' afterwards
  • Configuration window -> new 'Satellite Service' tab

    • Configure the service itself, ie. start/stop/disable/reinstall
    • Normally you shouldn't have to use this, only when debugging
    • Use the 'open service logs folder' to go to the service's logs

Some notes:

  • You can optionally set an 'auth ID'

    • When configured, only HASS.Agents that have to correct ID set can communicate with the service
    • Leave empty to allow all instances to connect (which is the default)
    • Only relevant when you use multiple HASS.Agent instances on the same PC
  • Not all sensors and commands can be executed through the service

    • The 'create new command/sensor' windows will tell you what's possible
    • Note that you have to think about this yourself when setting a custom command
  • All settings on the 'general' tab of the new service window are optional

  • The service installs into your ProgramFiles directory

  • You can choose to disable the service through Configuration -> Satellite Service

    • If you don't configure the service, it'll do nothing, but you may still want to disable to save cpu/battery
    • Don't uninstall; if you do, it will be reinstalled during the next update (if you use the installer)

If something goes wrong, please send me as much info as possible, and the logs of both HASS.Agent and the satellite service. Thanks!


Features & improvements

  • User interface improvements!

    • Manage commands/sensors/quick actions:
      • Cleaner way to show the stored items
      • Naming has been simplified and made more human-readable
    • Add commands/sensors:
      • Easier to see which commands/sensors are available
      • Naming has been simplified and made more human-readable
    • Multiple tweaks throughout
  • Added 'open logs folder' to Configuration -> Logging

  • Added 'execute port reservation' to Configuration -> Notifications

    • This will recreate the firewall rule en port reservation
    • Use this to make sure your PC can be contacted, normally done through onboarding
  • Added 'show test notification' button to Configuration -> Notifications

    • This will show a test notification, to make sure Windows is configured correctly
    • This does not prove your PC can be contacted
  • Added show/hide password buttons to password fields

  • Added 'close without saving' button to Configuration

  • The wiki received some much needed attention

    • Contains troubleshooting help, examples and general info
    • Anything to add? Anyone with a github account can edit, or just tell me - thanks!

Known bugs

  • I've spent many hours trying to get DPI scaling to work nicely, but it just won't look completely ok since switching to .NET 6
    • So for now, I've reverted to basically no scaling
    • If you have Windows set to 100% scaling, there's no difference
    • But otherwise, the interface will be a bit blury instead of crisp (like a badly resized picture)
    • This is really annoying, and I'll keep working on it, sorry

Bugfixes

  • When using automated updating, HASS.Agent now removes its icon from the tray (thanks Nejc)

    • Manually updating will still leave a ghost icon in the system tray
  • The custom executor command now correctly shows its description in the info pane

  • Not really a bug, but Coderr has been removed

    • The logs provide more info than a single exception report
    • Wasn't really comfortable with anything being sent from your PC, even if it was opt-in
Badges
Extracted from project README
GitHub release (latest by date) license OS - Windows dotnet Discord Documentation Status ko-fi "Buy Me A Coffee" paypal