aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/customservices.md
diff options
context:
space:
mode:
authorRobin Schneider <45321827+robinschneider@users.noreply.github.com>2021-10-10 21:40:42 +0200
committerGitHub <noreply@github.com>2021-10-10 21:40:42 +0200
commit87aadbb6df26009e93ee20752184300819d833e8 (patch)
tree6c7beb408c6ef7419e42bed9a7df0247533971b3 /docs/customservices.md
parentb64b17a4f91669713328cecada81482ba97cea38 (diff)
parent66a434e7dba49011dd5401e32bb45ab180a73a11 (diff)
downloadhomer-87aadbb6df26009e93ee20752184300819d833e8.tar.gz
homer-87aadbb6df26009e93ee20752184300819d833e8.tar.zst
homer-87aadbb6df26009e93ee20752184300819d833e8.zip
Merge branch 'bastienwirtz:main' into hotkey
Diffstat (limited to 'docs/customservices.md')
-rw-r--r--docs/customservices.md59
1 files changed, 35 insertions, 24 deletions
diff --git a/docs/customservices.md b/docs/customservices.md
index f79428f..ef84948 100644
--- a/docs/customservices.md
+++ b/docs/customservices.md
@@ -6,6 +6,20 @@ within Homer.
6 6
7If you experiencing any issue, please have a look to the [troubleshooting](troubleshooting.md) page. 7If you experiencing any issue, please have a look to the [troubleshooting](troubleshooting.md) page.
8 8
9
10## Common options
11
12```yaml
13- name: "My Service"
14 logo: "assets/tools/sample.png"
15 url: "http://my-service-link"
16 endpoint: "http://my-service-endpoint" # Optional: alternative base URL used to fetch service data is necessary.
17 useCredentials: false # Optional: Override global proxy.useCredentials configuration.
18 type: "<type>"
19```
20
21⚠️🚧 `endpoint` & `useCredentials` new options are not yet supported by all custom services (but will be very soon).
22
9## PiHole 23## PiHole
10 24
11Using the PiHole service you can display info about your local PiHole instance right on your Homer dashboard. 25Using the PiHole service you can display info about your local PiHole instance right on your Homer dashboard.
@@ -13,12 +27,11 @@ Using the PiHole service you can display info about your local PiHole instance r
13The following configuration is available for the PiHole service. 27The following configuration is available for the PiHole service.
14 28
15```yaml 29```yaml
16 items: 30- name: "Pi-hole"
17 - name: "Pi-hole" 31 logo: "assets/tools/sample.png"
18 logo: "assets/tools/sample.png" 32 # subtitle: "Network-wide Ad Blocking" # optional, if no subtitle is defined, PiHole statistics will be shown
19 # subtitle: "Network-wide Ad Blocking" # optional, if no subtitle is defined, PiHole statistics will be shown 33 url: "http://192.168.0.151/admin"
20 url: "http://192.168.0.151/admin" 34 type: "PiHole"
21 type: "PiHole"
22``` 35```
23 36
24## OpenWeatherMap 37## OpenWeatherMap
@@ -27,14 +40,13 @@ Using the OpenWeatherMap service you can display weather information about a giv
27The following configuration is available for the OpenWeatherMap service: 40The following configuration is available for the OpenWeatherMap service:
28 41
29```yaml 42```yaml
30items: 43- name: "Weather"
31 - name: "Weather" 44 location: "Amsterdam" # your location.
32 location: "Amsterdam" # your location. 45 locationId: "2759794" # Optional: Specify OpenWeatherMap city ID for better accuracy
33 locationId: "2759794" # Optional: Specify OpenWeatherMap city ID for better accuracy 46 apiKey: "<---insert-api-key-here--->" # insert your own API key here. Request one from https://openweathermap.org/api.
34 apiKey: "<---insert-api-key-here--->" # insert your own API key here. Request one from https://openweathermap.org/api. 47 units: "metric" # units to display temperature. Can be one of: metric, imperial, kelvin. Defaults to kelvin.
35 units: "metric" # units to display temperature. Can be one of: metric, imperial, kelvin. Defaults to kelvin. 48 background: "square" # choose which type of background you want behind the image. Can be one of: square, cicle, none. Defaults to none.
36 background: "square" # choose which type of background you want behind the image. Can be one of: square, cicle, none. Defaults to none. 49 type: "OpenWeather"
37 type: "OpenWeather"
38``` 50```
39 51
40**Remarks:** 52**Remarks:**
@@ -46,8 +58,8 @@ This service displays News (grey), Warning (orange) or Error (red) notifications
46Two lines are needed in the config.yml : 58Two lines are needed in the config.yml :
47 59
48```yaml 60```yaml
49type: "Medusa" 61 type: "Medusa"
50apikey: "01234deb70424befb1f4ef6a23456789" 62 apikey: "01234deb70424befb1f4ef6a23456789"
51``` 63```
52 64
53The url must be the root url of Medusa application. 65The url must be the root url of Medusa application.
@@ -59,8 +71,8 @@ This service displays Activity (blue), Warning (orange) or Error (red) notificat
59Two lines are needed in the config.yml : 71Two lines are needed in the config.yml :
60 72
61```yaml 73```yaml
62type: "Radarr" or "Sonarr" 74 type: "Radarr" or "Sonarr"
63apikey: "01234deb70424befb1f4ef6a23456789" 75 apikey: "01234deb70424befb1f4ef6a23456789"
64``` 76```
65 77
66The url must be the root url of Radarr/Sonarr application. 78The url must be the root url of Radarr/Sonarr application.
@@ -75,10 +87,9 @@ For Paperless you need an API-Key which you have to store at the item in the fie
75For Ping you need to set the type to Ping and provide a url. 87For Ping you need to set the type to Ping and provide a url.
76 88
77```yaml 89```yaml
78items: 90- name: "Awesome app"
79 - name: "Awesome app" 91 type: Ping
80 type: Ping 92 logo: "assets/tools/sample.png"
81 logo: "assets/tools/sample.png" 93 subtitle: "Bookmark example" tag: "app"
82 subtitle: "Bookmark example" tag: "app" 94 url: "https://www.reddit.com/r/selfhosted/"
83 url: "https://www.reddit.com/r/selfhosted/"
84``` 95```