From fd12de9ebd7a75ca2f31e8b28bd2c5ac10c46e21 Mon Sep 17 00:00:00 2001 From: Dick Wolff Date: Wed, 13 Jan 2021 21:22:35 +0100 Subject: Improvements --- docs/customservices.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 docs/customservices.md (limited to 'docs/customservices.md') diff --git a/docs/customservices.md b/docs/customservices.md new file mode 100644 index 0000000..42bd87d --- /dev/null +++ b/docs/customservices.md @@ -0,0 +1,35 @@ +# Tips & Tricks + +Here is an overview of all custom services that are avaiable within Homer. + +## PiHole + +Using the PiHole service you can display info about your local PiHole instance right on your Homer dashboard. + +The following configuration is available for the PiHole service. + +``` + items: + - name: "Pi-hole" + logo: "assets/tools/sample.png" + # subtitle: "Network-wide Ad Blocking" # optional, if no subtitle is defined, PiHole statistics will be shown + url: "http://192.168.0.151/admin" + type: "PiHole" +``` + +## OpenWeatherMap + +Using the OpenWeatherMap service you can display weather information about a given location. + +The following configuration is available for the OpenWeatherMap service + +``` +items: + - name: "Weather" + url: "https://api.openweathermap.org/data/2.5/weather" + location: "Amsterdam" # your location. + apiKey: "<---insert-api-key-here--->" # insert your own API key here. Request one from https://openweathermap.org/api. + units: "metric" # units to display temperature. Can be one of: metric, imperial, kelvin. Defaults to kelvin. + background: "square" choose which type of background you want behind the image. Can be one of: square, cicle, none. Defaults to none. + type: "OpenWeather" +``` -- cgit v1.2.3 From dfb0b14626ccf42784d5e4c270ea0e2253db724c Mon Sep 17 00:00:00 2001 From: Dick Wolff Date: Wed, 13 Jan 2021 21:25:07 +0100 Subject: Fixed some typo's. --- docs/customservices.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) (limited to 'docs/customservices.md') diff --git a/docs/customservices.md b/docs/customservices.md index 42bd87d..7c1818e 100644 --- a/docs/customservices.md +++ b/docs/customservices.md @@ -1,4 +1,4 @@ -# Tips & Tricks +# Custom Services Here is an overview of all custom services that are avaiable within Homer. @@ -25,11 +25,11 @@ The following configuration is available for the OpenWeatherMap service ``` items: - - name: "Weather" - url: "https://api.openweathermap.org/data/2.5/weather" - location: "Amsterdam" # your location. - apiKey: "<---insert-api-key-here--->" # insert your own API key here. Request one from https://openweathermap.org/api. - units: "metric" # units to display temperature. Can be one of: metric, imperial, kelvin. Defaults to kelvin. - background: "square" choose which type of background you want behind the image. Can be one of: square, cicle, none. Defaults to none. - type: "OpenWeather" + - name: "Weather" + url: "https://api.openweathermap.org/data/2.5/weather" + location: "Amsterdam" # your location. + apiKey: "<---insert-api-key-here--->" # insert your own API key here. Request one from https://openweathermap.org/api. + units: "metric" # units to display temperature. Can be one of: metric, imperial, kelvin. Defaults to kelvin. + background: "square" choose which type of background you want behind the image. Can be one of: square, cicle, none. Defaults to none. + type: "OpenWeather" ``` -- cgit v1.2.3 From 9e0ef05efe00ffd98ff6c7314a67e8a05505dcc4 Mon Sep 17 00:00:00 2001 From: Dick Wolff Date: Wed, 13 Jan 2021 21:27:19 +0100 Subject: Removed URL and made fixed. --- docs/customservices.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) (limited to 'docs/customservices.md') diff --git a/docs/customservices.md b/docs/customservices.md index 7c1818e..a0b143e 100644 --- a/docs/customservices.md +++ b/docs/customservices.md @@ -1,6 +1,6 @@ # Custom Services -Here is an overview of all custom services that are avaiable within Homer. +Here is an overview of all custom services that are available within Homer. ## PiHole @@ -26,7 +26,6 @@ The following configuration is available for the OpenWeatherMap service ``` items: - name: "Weather" - url: "https://api.openweathermap.org/data/2.5/weather" location: "Amsterdam" # your location. apiKey: "<---insert-api-key-here--->" # insert your own API key here. Request one from https://openweathermap.org/api. units: "metric" # units to display temperature. Can be one of: metric, imperial, kelvin. Defaults to kelvin. -- cgit v1.2.3 From fb158d4767b85160c0c2c5fea5c6429c265576a9 Mon Sep 17 00:00:00 2001 From: Dick Wolff Date: Wed, 13 Jan 2021 22:19:17 +0100 Subject: Error handling and fixed link to city. --- docs/customservices.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/customservices.md') diff --git a/docs/customservices.md b/docs/customservices.md index a0b143e..d7c5212 100644 --- a/docs/customservices.md +++ b/docs/customservices.md @@ -29,6 +29,6 @@ items: location: "Amsterdam" # your location. apiKey: "<---insert-api-key-here--->" # insert your own API key here. Request one from https://openweathermap.org/api. units: "metric" # units to display temperature. Can be one of: metric, imperial, kelvin. Defaults to kelvin. - background: "square" choose which type of background you want behind the image. Can be one of: square, cicle, none. Defaults to none. + background: "square" # choose which type of background you want behind the image. Can be one of: square, cicle, none. Defaults to none. type: "OpenWeather" ``` -- cgit v1.2.3 From 97f0c43ccc724ec4502e55f73874a89f822f0a81 Mon Sep 17 00:00:00 2001 From: Dick Wolff Date: Thu, 28 Jan 2021 13:02:18 +0100 Subject: Added doc for locationID --- docs/customservices.md | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'docs/customservices.md') diff --git a/docs/customservices.md b/docs/customservices.md index d7c5212..40f2e3d 100644 --- a/docs/customservices.md +++ b/docs/customservices.md @@ -27,8 +27,12 @@ The following configuration is available for the OpenWeatherMap service items: - name: "Weather" location: "Amsterdam" # your location. + locationId: "2759794" # OpenWeatherMap city ID. apiKey: "<---insert-api-key-here--->" # insert your own API key here. Request one from https://openweathermap.org/api. units: "metric" # units to display temperature. Can be one of: metric, imperial, kelvin. Defaults to kelvin. background: "square" # choose which type of background you want behind the image. Can be one of: square, cicle, none. Defaults to none. type: "OpenWeather" ``` + +**Remarks:** +If for some reason your city can't be found by entering the name in the `location` property, you could also try to configure the OWM city ID in the `locationId` property. To retrieve your specific City ID, go to the [OWM website](https://openweathermap.org), search for your city and retrieve the ID from the URL (for example, the City ID of Amsterdam is 2759794). \ No newline at end of file -- cgit v1.2.3