Skip to content

Commit

Permalink
docs: shorten new name and update logo
Browse files Browse the repository at this point in the history
closes #164
  • Loading branch information
Th3S4mur41 committed Oct 25, 2024
1 parent 1afd5fc commit 9141ee6
Show file tree
Hide file tree
Showing 9 changed files with 895 additions and 22 deletions.
4 changes: 2 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,11 @@

### ⚠ BREAKING CHANGES

* npm package and docker image renamed to "homewizard-webhooks"
* npm package and docker image renamed to "hw-hooks"

### chore

* prepare renaming to homewizard-webhooks ([0e574df](https://github.com/Th3S4mur41/hw2energyid/commit/0e574df1ceb5c4911a244920da6b50de3353eb86))
* prepare renaming to hw-hooks ([0e574df](https://github.com/Th3S4mur41/hw2energyid/commit/0e574df1ceb5c4911a244920da6b50de3353eb86))

### Dependencies and Other Build Updates

Expand Down
2 changes: 1 addition & 1 deletion Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -16,4 +16,4 @@ ENV energyid ''
ENV p1 ''
ENV meter ${p1}

CMD npx homewizard-webhooks --energyid=${energyid} --meter=${meter} -r
CMD npx hw-hooks --energyid=${energyid} --meter=${meter} -r
33 changes: 21 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# HomeWizard to EnergyId
# HW Hooks

[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?machine=basicLinux32gb&repo=612398925&ref=main)

Expand All @@ -7,10 +7,19 @@
![Release](https://github.com/Th3S4mur41/hw2energyid/actions/workflows/release.yml/badge.svg?branch=main)
[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/Th3S4mur41/hw2energyid/badge)](https://scorecard.dev/viewer/?uri=github.com/Th3S4mur41/hw2energyid)

**homewizard-webhooks** is small tool to synchronize data from [HomeWizard](https://www.homewizard.com/) devices to your [EnergyID](https://app.energyid.eu/) dashboard.
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./docs/logo-dark.png">
<source media="(prefers-color-scheme: light)" srcset="./docs/logo-light.png">
<img alt="Logo">
</picture>
</p>

**hw-hooks** is small tool trigger webhooks based on data gathered from [HomeWizard](https://www.homewizard.com/) devices.

The app includes a bunch of preconfigured webhooks to synchonize your data with you [EnergyID](https://app.energyid.eu/) dashboard.
Since HomeWizard devices API are only available within your local network, using an [EnergyID App](https://app.energyid.eu/integrations) to synchronize the data is not possible.
**homewizard-webhooks** helps bridge the gap by reading the data from your local network and sending them to EnergyId using the WebHook App
**hw-hooks** helps bridge the gap by reading the data from your local network and sending them to EnergyId using the WebHook App

## Prerequisites

Expand All @@ -35,7 +44,7 @@ You can either run the tool in the console using the NPM script or use the Docke
Open a terminal/console and run the following script:

```sh
npx homewizard-webhooks --energyid=<url of the webhook> <options>
npx hw-hooks --energyid=<url of the webhook> <options>
```

### Options
Expand Down Expand Up @@ -78,8 +87,8 @@ Create a docker compose file with the following content:
version: '3'

services:
homewizard-webhooks:
image: ghcr.io/th3s4mur41/homewizard-webhooks
hw-hooks:
image: ghcr.io/th3s4mur41/hw-hooks
environment:
- energyid=<the URL of the EnergyId webhook>
- meter=<the IP address of the Meter device>
Expand All @@ -100,7 +109,7 @@ services:
## Examples

> **Note**
> homewizard-webhooks currently only supports synchronizing electricity and water readings
> hw-hooks currently only supports synchronizing electricity and water readings

### P1 Meter

Expand All @@ -117,13 +126,13 @@ The name of the device is 'hw-p1meter-' followed by the last six charachters of
Now that you have all the data you need. Open a terminal/console and run the following script:

```sh
npx homewizard-webhooks --meter=hw-p1meter-<last 6 charachter of serial> --energyid=<url of the webhook>
npx hw-hooks --meter=hw-p1meter-<last 6 charachter of serial> --energyid=<url of the webhook>
```

E.g.: The command with your data should look similar to this:

```sh
npx homewizard-webhooks --meter=hw-p1meter-65d8c7 --energyid=https://hooks.energyid.eu/services/WebhookIn/46535693-fe25-48ba-96fa-ea827e987318/OS753GD97A11
npx hw-hooks --meter=hw-p1meter-65d8c7 --energyid=https://hooks.energyid.eu/services/WebhookIn/46535693-fe25-48ba-96fa-ea827e987318/OS753GD97A11
```

### Water Meter
Expand All @@ -136,16 +145,16 @@ The name of the device is 'watermeter-' followed by the last six charachters of
Now that you have all the data you need. Open a terminal/console and run the following script:

```sh
npx homewizard-webhooks --meter=watermeter-<last 6 charachter of serial> --energyid=<url of the webhook>
npx hw-hooks --meter=watermeter-<last 6 charachter of serial> --energyid=<url of the webhook>
```

E.g.: The command with your data should look similar to this:

```sh
npx homewizard-webhooks --meter=watermeter-65d8c7 --offset=22.334 --energyid=https://hooks.energyid.eu/services/WebhookIn/46535693-fe25-48ba-96fa-ea827e987318/OS753GD97A11
npx hw-hooks --meter=watermeter-65d8c7 --offset=22.334 --energyid=https://hooks.energyid.eu/services/WebhookIn/46535693-fe25-48ba-96fa-ea827e987318/OS753GD97A11
```

## Links

[homewizard dicovery docs](https://homewizard-energy-api.readthedocs.io/discovery.html)
[homewizard dicovery docs](https://api-documentation.homewizard.com/docs/discovery)
[EnergyId Webhook Docs](https://api.energyid.eu/docs.html#webhook)
Binary file added docs/logo-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/logo-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit 9141ee6

Please sign in to comment.