Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
LAB02-Admin authored Nov 24, 2021
1 parent 9d64533 commit c30ff88
Showing 1 changed file with 20 additions and 20 deletions.
40 changes: 20 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,25 +15,25 @@ Contents
* [Wishlist](#wishlist)
* [Error Reporting](#error-reporting)

### Why?
Why?
---

The main reason I built this was that I wanted to receive notifications with images on my PC, and to quickly perform actions (ie. toggle a lamp). There currently weren't any software-based solutions to this, so I set out to built it myself.

That's also the premise of this project; it's built to solve 'problems' (nuicanses is perhaps a better word) I encountered, and may work for you.
In that case, feel free to open a ticket so we can discuss!

### Functionality
Functionality
---

Summary of the current implementation:

* **Notifications**: receive notifications, show them using Windows builtin toast popups, attach images - this requires the installation of the <a href="https://github.com/LAB02-Research/HASS.Agent.Notifier">HASS.Agent Notifier integration</a>
* **Notifications**: receive notifications, show them using Windows builtin toast popups, attach images - this requires the installation of the <a href="https://github.com/LAB02-Research/HASS.Agent-Notifier">HASS.Agent Notifier integration</a>
* **Quick Actions**: use a keyboard shortcut to quickly pull up a command interface, through which you can control Home Assistant entities
* **Commands**: control your device through Home Assistant using custom- or builtin commands
* **Sensors**: send your device's sensors to Home Assistant to monitor cpu, mem, webcame usage, wmi-polled data, etc ..

### Credits
Credits
---

I want to put the credits this far up on the readme page, because I'm standing on the shoulders of giants :)
Expand All @@ -50,64 +50,64 @@ And a big thank you to all other packages:

Please consult their individual licensing if you plan to use any of the code.

### Installation
Installation
---

The agent itself comes as a .zip, that you can place anywhere you want. After launching, you'll see the configuration screen. In there, you get the option to install HASS.Agent as a run-on-boot scheduled task. This way, it'll launch after you login, and you won't have to accept UAC popups. If you're not comfortable with this setup, you can always manually add a shortcut to your startup folder.

If you want to use notifications, you'll need to install the <a href="https://github.com/LAB02-Research/HASS.Agent.Notifier" target="_blank">HASS.Agent Notifier integration</a>. This can be done through <a href="https://hacs.xyz" target="_blank">HACS</a> or manually. You'll also need to open the
If you want to use notifications, you'll need to install the <a href="https://github.com/LAB02-Research/HASS.Agent-Notifier" target="_blank">HASS.Agent Notifier integration</a>. This can be done through <a href="https://hacs.xyz" target="_blank">HACS</a> or manually. You'll also need to open the
configured port in the firewall of the receiving devices (default **5115**).

### Configuration
Configuration
---

Configuring HASS.Agent is split into five parts:

#### 1. Notifications
### 1. Notifications

Make sure the integration has been installed and configured in Home Assistant, and actually works (I use a test automation). In the configuration screen, check the 'accept notifications' box and optionally change the default port:

<todo: image>

Afterwards, open the configured port in your firewall. Ideally only allow your Home Assistant IP through.

#### 2. Startup
### 2. Startup

You can use the 'create launch-on-login scheduled task' to allow HASS.Agent to start when you login to your device.

#### 3. Home Assistant API config
### 3. Home Assistant API config

To use quick actions, you have to configure your instance's API. Normally the default URI should work, unless you've changed the port or mdns name. You can get a long-live API token following <a href="https://www.home-assistant.io/docs/authentication/" target="_blank">this doc</a>.

#### 4. MQTT config
### 4. MQTT config

Enter your MQTT broker configuration. Only required if you want to use commands (sent from Home Assistant) or sensors (sent from your device).

#### 5. Hotkey config
### 5. Hotkey config

Optionally, can be used to pull up the quick-actions window.

### Usage
Usage
---

From the home screen, you can easily use & configure the various parts of HASS.Agent:

#### 1. Configuration
### 1. Configuration

Shows the various application configuration options (as discussed above).

#### 2. Quick Actions
### 2. Quick Actions

Manage your quick action buttons. Use the 'add new' button to create your first action. All entities are dynamically fetched from your Home Aassistant instance. If they won't show up, make sure you've configured 'HASS api' in the configuration screen. Use the 'preview' button to check if it's working for you.

#### 3. Local Sensors
### 3. Local Sensors

Manage which sensors you want to publish to your Home Assistant instance. There are some ready-to-use sensors available, or you can use your own WMI query.
Requires MQTT to be configured.

**Note: WMI can be a pain, and make sure you don't update your queries too often. Keep an eye on your CPU load.**

#### 4. Commands
### 4. Commands

Manage which commands should be accepted from your Home Assistant instance. Aside from the builtin commands, you can use your own custom command (you can test your command by typing it into a console), or a key command which will emulate key presses. Requires MQTT to be configured.

Expand All @@ -127,12 +127,12 @@ Example configuration of a shutdown command in Home Assistant, used in combinati
entity_id: switch.test_w10_x64_01_cmd_shutdown
```
### Updating
Updating
---
Currently, HASS.Agent doesn't have an updater. It'll be implemented in a coming version. For now, check this page periodically :)
### Wishlist
Wishlist
---
List of things I want to add somewhere down the road:
Expand All @@ -150,7 +150,7 @@ List of things I want to add somewhere down the road:
If you have any other wishes, feel free to submit a ticket.
### Error Reporting
Error Reporting
---
This type of application is quite error prone (fetching data from WMI, systemwide keybindings, etc). To manage exceptions, I use the excellent Coderr platform. However, this does mean that exception info will be sent to their servers. This is **disabled** by default.
Expand Down

0 comments on commit c30ff88

Please sign in to comment.