X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=docs%2Fcustomservices.md;h=f79428fc7afa6898f1aee579ecf2982a39583622;hb=b2f6da03829fb7cff4df3e2a9af5f6675fd0ae42;hp=d2deff4aa34670dec5c611cf04e320234f671294;hpb=4399f5fadec678c37fa417e24faf4343615338b3;p=github%2Fbastienwirtz%2Fhomer.git

diff --git a/docs/customservices.md b/docs/customservices.md
index d2deff4..f79428f 100644
--- a/docs/customservices.md
+++ b/docs/customservices.md
@@ -1,6 +1,10 @@
 # Custom Services
 
-Here is an overview of all custom services that are available within Homer.
+Some service can use a specific a component that provides some extra features by adding a `type` key to the service yaml
+configuration. Available services are in `src/components/`. Here is an overview of all custom services that are available
+within Homer.
+
+If you experiencing any issue, please have a look to the [troubleshooting](troubleshooting.md) page.
 
 ## PiHole
 
@@ -8,7 +12,7 @@ Using the PiHole service you can display info about your local PiHole instance r
 
 The following configuration is available for the PiHole service.
 
-```
+```yaml
  items:
       - name: "Pi-hole"
         logo: "assets/tools/sample.png"
@@ -17,25 +21,64 @@ The following configuration is available for the PiHole service.
         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:
+
+```yaml
+items:
+     - name: "Weather"
+       location: "Amsterdam" # your location.
+       locationId: "2759794" # Optional: Specify OpenWeatherMap city ID for better accuracy
+       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).
+
 ## Medusa
 
 This service displays News (grey), Warning (orange) or Error (red) notifications bubbles from the Medusa application.
 Two lines are needed in the config.yml :
-```
+
+```yaml
 type: "Medusa"
 apikey: "01234deb70424befb1f4ef6a23456789"
 ```
+
 The url must be the root url of Medusa application.
 The Medusa API key can be found in General configuration > Interface. It is needed to access Medusa API.
 
-
 ## Sonarr/Radarr
 
 This service displays Activity (blue), Warning (orange) or Error (red) notifications bubbles from the Radarr/Sonarr application.
 Two lines are needed in the config.yml :
-```
+
+```yaml
 type: "Radarr" or "Sonarr"
 apikey: "01234deb70424befb1f4ef6a23456789"
 ```
+
 The url must be the root url of Radarr/Sonarr application.
 The Radarr/Sonarr API key can be found in Settings > General. It is needed to access the API.
+
+## PaperlessNG
+
+For Paperless you need an API-Key which you have to store at the item in the field `apikey`.
+
+## Ping
+
+For Ping you need to set the type to Ping and provide a url.
+
+```yaml
+items:
+   - name: "Awesome app"
+     type: Ping
+     logo: "assets/tools/sample.png"
+     subtitle: "Bookmark example" tag: "app" 
+     url: "https://www.reddit.com/r/selfhosted/" 
+```