Weather

Type met_no · needs the internet.

The weather for the next 12 hours, from met.no (the Norwegian Meteorological Institute). Free, with forecasts for places all over the world. It shows numbers, not advice:

• a summary for the next 12 hours: highest and lowest temperature, total rain, and the hours it rains ("Max 14°C · Min 8°C · Rain 6.6 mm, 13–17, 19–20"; 13–17 means from 13:00 to 17:00, and rain until midnight ends at "24");
• per hour: a bar for the rain (the mm under it), the temperature and a wind barb;
• a met.no weather icon every 2 hours.

That is the default layout, hours_12. The other layouts show the same numbers in other ways: in 3-hour steps, the current hour large, or for tiny and upright screens (see "Layouts").

The 12 hours start at the current hour. Times are shown in the Pi's own time zone.

Wind barbs

A barb is a line with an arrowhead that points where the wind is going. The feathers at the other end give the speed in knots (1 knot is about 0.5 m/s or 1.9 km/h), rounded to steps of 5:

Shape	Speed
circle	calm, under 1 knot
line and arrowhead only	1 to 2.4 knots
short feather	5 knots
long feather	10 knots
triangle	50 knots
warning triangle with "!"	over 105 knots

Feathers add up: a long and a short feather is 15 knots; a triangle and two long feathers is 70.

When met.no can't be reached

"Updated 08:32" at the top is when met.no last confirmed the forecast. After every download the plugin saves the trimmed forecast in its storage folder. If met.no can't be reached, it draws from the saved forecast (still starting at the current hour), and the "Updated" time shows how old it is. A saved forecast older than 6 hours is not used; the update then fails as usual. After a change of lat, lon or altitude the saved forecast is not used: it is for the old place.

The plugin follows met.no's terms of service: it sends your email address (only to met.no) as contact, rounds the coordinates to 4 decimals (and sends the altitude, if set), asks "has anything changed since my last download?", and doesn't download again before the time met.no's answer gives (at most 1 hour). In practice that is one download about every hour.

Layouts

Layout	Shows
hours_12 (default)	place, "Updated" time and "Data: MET Norway", the summary line, an icon every 2 hours, then per hour the rain bar and mm, the hour, the temperature and the wind barb
steps_3h	the summary, then 4 steps of 3 hours: the hours, an icon (of the wettest hour, or the middle hour when dry), lowest and highest temperature, the rain, and the wind at the middle hour
now	the current hour, large: icon, temperature and wind barb, with the summary below
small	for tiny screens (2" to 3"): a big icon for the current hour, the place, the temperature now, then max and min, and the rain and its hours for the next 12 hours. No wind barb
portrait_hours	for screens standing upright: the summary on top, then one row per hour: hour, icon, temperature, rain as a sideways bar with the mm, wind barb
portrait_now	for screens standing upright: a large icon for the current hour, its temperature and wind barb, then the summary

Every layout shows the place: the place setting, or the coordinates when it is empty. All but small also show the "Updated" time and "Data: MET Norway" at the top. When a saved forecast is used for a long time, fewer than 12 hours may be left; the columns or rows without an hour then stay empty, and the summary covers the hours that are left.

Settings

Setting	Default	Meaning
lat	none, required	latitude of the place, e.g. 52.52
lon	none, required	longitude of the place, e.g. 13.40
altitude	none	height of the ground at the place, in whole metres (-500 to 9000). met.no then corrects the temperatures for it, which matters in hills and mountains; without it, met.no guesses the height from its own map, which is not detailed enough in hills and mountains
email	none, required	your own, real email address, sent only to met.no. met.no's terms of service require contact details from every program, so it can ask before blocking one that misbehaves
place	""	name shown at the top, e.g. "Berlin". Without it, the coordinates are shown ("52.52, 13.40")
temperature	"C"	"C" (Celsius) or "F" (Fahrenheit)
rain	"mm"	"mm" or "inch"

Wind is always in knots, because the barbs are drawn in knots.

You don't have to look up lat, lon and altitude yourself: on the plugin's settings page in the web interface, type the name of a town or city just above lat (e.g. Addis Ababa, or Morrison, Colorado when several places share a name), press Search, and Use next to the right place fills in lat, lon, altitude and place (Save keeps them; you can change the name before saving). The search sends only the typed name to Open-Meteo (place data from GeoNames).

It suggests a refresh every 30 minutes. met.no updates its forecasts about once an hour.

In the config file (every other setting is in the settings reference):

[[plugin]]
id = "met_no-fdb87963"
name = "Weather Berlin"
type = "met_no"
lat = 52.52
lon = 13.40
place = "Berlin"
email = "you@example.com"   # put your own, real address here
layout = "steps_3h"   # optional; without it: hours_12

Try it without a screen: uv run paperpi render met_no --set place=Berlin (sample data), or with real data: uv run paperpi render met_no --live --set lat=52.52 --set lon=13.40 --set email=you@example.com (put your own address in place of you@example.com). If lat, lon or email is missing, the plugin is not shown; the config check and paperpi list say which one.

The screen shows "Data: MET Norway" next to the "Updated" time, as met.no's data licence asks. The weather data is from MET Norway (the Norwegian Meteorological Institute), under the Creative Commons 4.0 BY International licence. The weather icons are met.no's own, from github.com/metno/weathericons, under the MIT licence (icons/LICENSE).

All settings

Made from the plugin's code, so always up to date.

Setting	Default	What it does
lat	required	Latitude of the place, e.g. 52.52 (required)
lon	required	Longitude of the place, e.g. 13.40 (required)
altitude	not set	Height of the ground at the place, in whole metres, e.g. 34. Makes the temperatures more exact in hills and mountains (else met.no guesses it from its own map)
place	not set	Name shown on the screen, e.g. Berlin (else lat, lon)
email	required	Your own, real email address, sent only to met.no (their terms of service ask for one) (required)
temperature	"C"	Degrees Celsius or Fahrenheit. One of: "C", "F"
rain	"mm"	Rain in millimetres or inches. One of: "mm", "inch"

Its suggestions for settings every plugin has (a block that sets one of them uses that value instead):

Setting	Default	What it does
refresh	1800	Seconds between updates (at least 5). Leave it out to use the plugin's suggestion
level	"rotation"	When it is shown: alert, interrupt or rotation. Leave it out to use the plugin's suggestion
layout	"hours_12"	Which layout (see the plugin's page). Leave it out to use the first
storage_mb	500	Most megabytes this plugin may keep in its storage folder; over it, the files changed longest ago are removed first. Leave it out to use the plugin's suggestion
storage_days	30	Files the plugin has not changed for this many days are removed (0 = keep them). Leave it out to use the plugin's suggestion

Sample images

The sample data is made up: a day in Berlin from 09:00, with a shower in the afternoon. All sample images are in tests/images/, named met_no-<layout>[-berlin|-berlin-f]-<screen>.png, where <screen> is 9in7 (9.7", 1200x825, 16 grays), 7in5 (7.5", 800x480, black and white) or 5in65 (5.65", 600x448, 7 colours). berlin shows the place name; berlin-f also °F and inches. The pictures without them show no name, because the sample settings have neither a place nor coordinates.

hours_12	steps_3h	now

small, 2.13" (250x122)	portrait_hours, upright (480x800)	portrait_now, upright (480x800)	hours_12, °F and inches, 7.5"

The portrait_* and small layouts are also drawn on the usual three test screens, where they look squeezed or large; the pictures above are at their own sizes (-2in13, -upright).