Skip to content

weather

Preview of the weather page

What it shows

The current weather for one place: an icon, the temperature in large digits and a short description. Below it the day's high (red) and low (blue), and the next four hours with temperature and chance of rain.

The description and the title follow the page language (de or en).

What you need

  • Internet access for the server. The data comes from Open-Meteo, a free weather service. No account and no key.
  • A place name, or its coordinates.

Example

- type: weather
  location: Frankfurt am Main
  lang: en

Options

Key Default Meaning
location Place name, looked up once through the Open-Meteo geocoding service. Use this or latitude and longitude.
latitude, longitude Coordinates in degrees (for example 50.11 and 8.68). Always set both, and never together with location.
title the found place name, else Weather Header text.
lang top-level lang de or en. Sets the description and the default title.
refresh duration, at least 60 Seconds between two new pictures, at least 60. The picture and its clock stay current, but Open-Meteo is asked at most every 15 minutes, because weather changes slowly and the service is free. If the value is below 60 the server refuses to start.
duration interval How many seconds the page stays on the display.

The time zone comes from the top-level timezone. The four hours are the next four full hours in that zone, also across midnight.

Setup

  1. Add the example to the pages: list in config.yaml with your location.
  2. Restart the server: docker compose restart.
  3. Open http://<server>:8080/ and check the preview.

If the place is not the one you meant, add the country or region to the name, or use latitude and longitude instead.

Privacy & security

  • The page needs no key, so there is no secret to protect.
  • With location the place name goes to Open-Meteo once per server start. Every forecast request (at most every 15 minutes) sends the coordinates of the place. Open-Meteo also sees the IP address of your server.
  • Nothing is stored on the server beyond the current picture.
  • Open-Meteo data is licensed under CC BY 4.0, see open-meteo.com/en/license.

When something is wrong

  • The page keeps showing an old picture: Open-Meteo could not be reached. The last picture stays for up to 10 minutes, after which the display skips the page. The reason is in docker compose logs.
  • location not found in the log: the geocoding service does not know the name. Try another spelling or use latitude and longitude.
  • The server refuses to start and names location: use either location or both coordinates, never both forms.
  • The server refuses to start and complains about refresh: the value is below 60. Remove it or raise it.
  • The hours or the clock are off: set the top-level timezone (for example Europe/Berlin).