Improvements

1 files changed, 35 insertions, 0 deletions

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"
+```