homer/docs/customservices.md

36 lines
1.3 KiB
Markdown
Raw Normal View History

2021-01-13 21:25:07 +01:00
# Custom Services
2021-01-13 21:22:35 +01:00
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:
2021-01-13 21:25:07 +01:00
- 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"
2021-01-13 21:22:35 +01:00
```