hass-agent · amadeo-alex · Oct 29, 2023 · Jun 30, 2023 · Jun 30, 2023 · Jun 30, 2023
diff --git a/README.md b/README.md
@@ -1,37 +1,84 @@
 <a href="https://github.com/LAB02-Research/HASS.Agent/">
     <img src="https://raw.githubusercontent.com/LAB02-Research/HASS.Agent/main/images/logo_128.png" alt="HASS.Agent logo" title="HASS.Agent" align="right" height="128" /></a>
 
-# HASS.Agent Staging Project
+# HASS.Agent Project
 
-**Do not use this repo if you just want to manually build and use HASS.Agent. Please see [these instructions](https://hassagent.readthedocs.io/en/latest/installation/#3-build-from-scratch) on how to do that.**
+This project is a fork of the [original HASS.Agent](https://github.com/LAB02-Research/HASS.Agent) created by [Sam](https://github.com/LAB02-Research).
+
+The Purpose of this project is to provide updates/features/fixes until development on the original project resumes. For now, all released from this repository will be marked as beta.
+
+At first all PRs made by me will be merged, but in time, I'll approach authors of other PRs for permission to also include them in here.
+
+**NOTE**: I did my best to always maintain backward compatibility but this ***cannot be guaranteed***, please report any issues you may encounter.
+
+## Installation
+
+**I do hope to improve this process in the future**
+
+The original HASS.Agent repository is not available as far as I'm informed.<br>
+There are two options to approach this:
+- creating a new installer
+- going with "patch it over" approach
+
+Currently the recommended option is the "patch it over". HASS.Agent is capable of functioning without the installer but the installer takes care of some dependencies that might need to be installed manually otherwise.
+<br>
+1. Download and install HASS.Agent from [the official release](https://github.com/LAB02-Research/HASS.Agent/releases) (usually in **"C:\Users\<username>\AppData\Roaming\LAB02 Research\HASS.Agent\"**)
+2. Download and install WindowsAppSDK available at https://learn.microsoft.com/en-us/windows/apps/windows-app-sdk/downloads ([explanation why](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/18))
+3. Make sure the HASS.Agent service is stopped
+<br><img src="https://github.com/amadeo-alex/HASS.Agent/assets/68441479/38590ab0-7d42-4790-9629-73596725d75e" height="350px" />
+4. Close/Exit out of the HASS.Agent
+<br><img src="https://github.com/amadeo-alex/HASS.Agent/assets/68441479/38939e3d-6dff-447c-a497-78def5fa41ff" height="350px" />
+6. Download the release package from this repository
+7. Copy/Replace the downloaded files over the installed ones (again, usually in **"C:\Users\<username>\AppData\Roaming\LAB02 Research\HASS.Agent\"**)
+8. Launch HASS.Agent and verify that you're using the unofficial beta version by navigating to help window - "u" in the version postfix
+<img src="https://github.com/amadeo-alex/HASS.Agent/assets/68441479/19edc4f6-e674-4238-8d11-d50c16feb8a9" height="350px" />
+<img src="https://github.com/amadeo-alex/HASS.Agent/assets/68441479/05df8795-b8f6-4a9e-b666-a55b89196a3e" height="350px" />
+
+----
+
+"Project" differences from the base project:
+1. No separation between "HASS.Agent" and "HASS.Agent.Staging" - since I have no access to the original repositories, it'll be easier for me to maintain it this way
+2. No documentation available yet - best case scenario the descriptions in the application should be sufficient but even so, I'd like to have unofficial documentation created at some point
+3. The update functionality present in UI does not work with the unofficial version, yet
+
+----
+
+Major feature changes compared to the original project:
+1. [Virtual desktop sensor and command](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/12)
+2. [Quick Action carousel/circular navigation](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/15)
+3. [Notification library change an improvements including possible Win11 fix](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/18)
+4. [Application volume controls (per application control, audio output command, audio sensor overhaul)](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/19)
+5. [Internal device sensors - sensors present on the device running HASS.Agent](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/21)
+6. [Ignore availability option for sensors](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/22)
+6. [Radio (BT/WiFi/Broadband) control command](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/23)
+7. [LastActive sensor refresh upon wake from sleep/hibernation](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/9)
+
+Major bug fix changes compared to the original project:
+1. [GPU temperature and load sensor returns proper values when encountering an error](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/10)
+2. [Key commands emulation not actually "releases" the key after "pressing it"](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/13)
+3. [PowerShell command action parameters now include check culture config missing on some systems](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/14)
+4. [PerformanceCounter sensors do not call NextValue twice causing values to be borked](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/16)
+5. [Adjustments per Home Assistant 2023.8 MQTT changes regarding sensor/device naming convention](https://github.com/LAB02-Research/HASS.Agent.Staging/pull/20)
+
+----
+
+This project contains the latest code of all three parts of the HASS.Agent platform:
 
-<br/><br/>
-This project contains the latest (beta) code of all three parts of the HASS.Agent platform:
-<br/><br/>
 
 | Project | Description |
 |---|---|
 | HASS.Agent | Main client, containing the UI, runs in userspace, by default without elevation |
 | HASS.Agent.Satellite.Service | Windows client, runs under SYSTEM account |
-| HASS.Agent.Shared | Library, published as a nuget, contains all commands, sensors, shared functions and enums |
+| HASS.Agent.Shared | Library, contains all commands, sensors, shared functions and enums |
 
 <br/>
 
-Its purpose is to more easily develop beta releases, as the shared library will be instantly compiled and referenced.
-
-Note: make sure any regular instance of HASS.Agent is shut down. If you're just planning to tinker with HASS.Agent, you can leave the regular service active, otherwise turn it off as well as the named pipe will be in use. Start the service with elevated privileges.
 
 Note: it's best to have `enable extended logging` enabled, which will also reflect on the satellite service (as long as it's started in console mode instead of service mode). But that'll also generate false positives, so primarily focus on the issue at hand.
 
 ----
 
-The base of all tickets is HASS.Agent's YouTrack page:
-
-[HASS.Agent YouTrack Dashboard](https://lab02research.youtrack.cloud)
-
-Let me know that you're working on a ticket (you can use the discussions page of this repo), to avoid double work.
-
-Documentation available here: [https://hassagent.readthedocs.io/en/latest/development/introduction/](https://hassagent.readthedocs.io/en/latest/development/introduction/)
+Documentation for the original project is available here: [https://hassagent.readthedocs.io/en/latest/development/introduction/](https://hassagent.readthedocs.io/en/latest/development/introduction/)
 
 ----
 

diff --git a/src/HASS.Agent.Staging/HASS.Agent.Satellite.Service/Commands/CommandsManager.cs b/src/HASS.Agent.Staging/HASS.Agent.Satellite.Service/Commands/CommandsManager.cs
@@ -59,7 +59,7 @@ internal static async Task UnpublishAllCommands()
                 foreach (var command in Variables.Commands)
                 {
                     await command.UnPublishAutoDiscoveryConfigAsync();
-                    await Variables.MqttManager.UnubscribeAsync(command);
+                    await Variables.MqttManager.UnsubscribeAsync(command);
                     command.ClearAutoDiscoveryConfig();
                     count++;
                 }
@@ -188,7 +188,7 @@ internal static async Task<bool> StoreAsync(List<ConfiguredCommand> commands, Li
 
                         // remove and unregister
                         await abstractCommand.UnPublishAutoDiscoveryConfigAsync();
-                        await Variables.MqttManager.UnubscribeAsync(abstractCommand);
+                        await Variables.MqttManager.UnsubscribeAsync(abstractCommand);
                         Variables.Commands.RemoveAt(Variables.Commands.FindIndex(x => x.Id == abstractCommand.Id));
 
                         Log.Information("[COMMANDS] Removed command: {command}", abstractCommand.Name);
@@ -220,7 +220,7 @@ internal static async Task<bool> StoreAsync(List<ConfiguredCommand> commands, Li
                         Log.Information("[COMMANDS] Command changed, re-registering as new entity: {old} to {new}", Variables.Commands[currentCommandIndex].Name, abstractCommand.Name);
 
                         await Variables.Commands[currentCommandIndex].UnPublishAutoDiscoveryConfigAsync();
-                        await Variables.MqttManager.UnubscribeAsync(Variables.Commands[currentCommandIndex]);
+                        await Variables.MqttManager.UnsubscribeAsync(Variables.Commands[currentCommandIndex]);
                         await Variables.MqttManager.SubscribeAsync(abstractCommand);
                     }
 

diff --git a/src/HASS.Agent.Staging/HASS.Agent.Satellite.Service/HASS.Agent.Satellite.Service.csproj b/src/HASS.Agent.Staging/HASS.Agent.Satellite.Service/HASS.Agent.Satellite.Service.csproj
@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Worker">
 
   <PropertyGroup>
-    <TargetFramework>net6.0-windows</TargetFramework>
+    <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
 	<UseWindowsForms>true</UseWindowsForms>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
@@ -20,6 +20,7 @@
     <AssemblyVersion></AssemblyVersion>
     <ApplicationIcon>hass.ico</ApplicationIcon>
     <FileVersion></FileVersion>
+    <SupportedOSPlatformVersion>10.0.17763.0</SupportedOSPlatformVersion>
   </PropertyGroup>
 
   <ItemGroup>