Skip to content

Plugin weather dashboard

Martin Pihrt edited this page Oct 13, 2026 · 1 revision

Weather Dashboard

Displays selected OSPy sensor and plug-in values as configurable gauges or text.

At a glance

Item Value
Version 1.0.2
Category Weather, climate and environmental sensors
Author Martin Pihrt
License GPL-3.0
OSPy 3.0.211 or newer
Python 3.8 or newer
Permissions files, system
Hardware No dedicated hardware requirement declared
Dependencies None
Python/OS packages None
Interfaces Mobile API v1
Source Open the plug-in directory

What it is for

Displays selected OSPy sensor and plug-in values as configurable gauges or text.

How it works and how to configure it

Tested in Python 3+

This plugin displays selected values from other OSPy plugins and OSPy sensors on one dashboard. Each value is configured as one gauge. The dashboard can show gauges as round canvas meters or as simple text values.

The plug-in includes a manifest declaring access to OSPy sensors and other plug-in readings, uses the shared OSPy lifecycle, and reports configured gauges, refreshes and unavailable values through the Diagnostics health interface. Its mobile API exposes the same canvas/text mode, current values, scale, ticks and colored limits used by the web dashboard so native clients can reproduce the configured presentation.

Mobile application

Open Plug-ins and expand Weather Dashboard operating data in the OSPy mobile application. Canvas mode displays every enabled gauge as a native radial meter below the previous one and applies its configured minimum, maximum, tick labels and red, blue and green ranges. Text mode displays the same live values and units using the configured text size. The expanded panel refreshes automatically while it remains open, and pulling down on the Plug-ins page reloads the complete plug-in list.

Plugin setup

  • Dashboard mode: Select Canvas mode for round meters or Text mode for simple text values.

  • Canvas size: The number determines the size of the round meter in canvas mode.

  • Text font: The number determines the font size in text mode.

  • Add Gauge: Adds a new gauge with default settings.

  • Delete: Removes the selected gauge from the dashboard.

  • Enabled: If checked, this gauge is shown on the dashboard. If unchecked, the gauge is saved but hidden.

  • Name: Name displayed on the canvas meter or before the text value.

  • Unit: Unit displayed after the value, for example C, %, cm, l, V, or km/h.

  • Source: Select where the value is read from. Available sources are loaded from the plugin source registry.

  • Channel: Select the input channel for the selected source. The list changes automatically after changing Source.

  • Value type: Select which value from the selected source is displayed. The list changes automatically after changing Source.

  • Ticks: Comma separated scale labels for the canvas meter, for example 0,25,50,75,100.

  • Min: Minimum value of the canvas meter scale.

  • Max: Maximum value of the canvas meter scale.

  • Red color from to: Red color on the canvas meter scale according to the value from to.

  • Blue color from to: Blue color on the canvas meter scale according to the value from to.

  • Green color from to: Green color on the canvas meter scale according to the value from to.

Available sources

  • Air Temperature: Reads DS18B20 probes from the Air Temperature and Humidity Monitor plugin.

  • Tank Monitor: Reads percent and volume values from the Water Tank Monitor plugin.

  • Current Loop: Reads percent, cm, liter, and voltage values from the Current Loop Tanks Monitor plugin.

  • Wind Monitor: Reads wind speed from the Wind Speed Monitor plugin.

  • OSPy Sensor: Reads values from configured OSPy sensors.

  • Shelly Cloud: Reads cached Shelly values without starting another network request. Shelly Pro 3EM and Shelly 3EM-63T Gen3 provide per-phase power, reverse power, voltage, current, power factor and energy together with total power and total energy.

Using the dashboard

After changing settings press Submit to save all gauges. Open the dashboard page to view the configured values. Values are refreshed automatically.

In-app help and settings notes

The following notes are generated from the help page shipped with this plug-in. Field names are also explained directly in the OSPy settings page.

Weather Dashboard shows selected values from other OSPy plugins and OSPy sensors on one dashboard.

Each displayed item is configured as one gauge. A gauge can be shown as a round canvas meter or as a simple text value.

Dashboard modes

  • Canvas

Shows enabled gauges as round meters. Use Canvas size to set the width and height of each meter.

  • Text

Shows enabled gauges as text values. Use Text font to set the size of the displayed text.

General settings

  • Dashboard mode

Select whether the dashboard page will use canvas meters or text values.

  • Canvas size

The number determines the size of the round meter in canvas mode.

  • Text font

The number determines the font size in text mode.

Gauge settings

  • Add Gauge

Adds a new gauge with default settings.

  • Delete

Removes the selected gauge from the dashboard.

  • Enabled

When checked, this gauge is shown on the dashboard. When unchecked, the gauge is saved but hidden.

  • Name

The name displayed on the canvas meter or before the text value.

  • Unit

The unit displayed after the value, for example C, %, cm, l, V, or km/h.

  • Source

Selects where the value is read from. Available sources are loaded from the plugin source registry.

  • Channel

Selects the input channel for the selected source. The list changes automatically after changing Source.

  • Value type

Selects which value from the selected source is used. The list changes automatically after changing Source.

Scale and colors

  • Ticks

Comma separated scale labels used by the canvas meter, for example 0,25,50,75,100.

  • Min

Minimum value of the canvas meter scale.

  • Max

Maximum value of the canvas meter scale.

  • Red

Range highlighted in red on the canvas meter.

  • Blue

Range highlighted in blue on the canvas meter.

  • Green

Range highlighted in green on the canvas meter.

Available sources

  • Air Temperature

Reads DS18B20 probes from the Air Temperature and Humidity Monitor plugin.

  • Tank Monitor

Reads percent and volume values from the Water Tank Monitor plugin.

  • Current Loop

Reads percent, cm, liter, and voltage values from the Current Loop Tanks Monitor plugin.

  • Wind Monitor

Reads wind speed from the Wind Speed Monitor plugin.

  • OSPy Sensor

Reads values from configured OSPy sensors.

  • Shelly Cloud

Reads cached Shelly values. Three-phase meters provide per-phase and total electrical values.

Saving settings

  • Submit

Saves all dashboard and gauge settings.

Leaves the settings page without saving changes.

After saving, open the dashboard page to view the configured gauges. Values are refreshed automatically.

Mobile application

The mobile application uses the configured canvas or text mode. Native round meters keep each gauge minimum, maximum, tick labels and red, blue and green limits, and enabled gauges are displayed below each other. Expanded operating data refreshes automatically.

Support

Check OSPy → Diagnostics first and remove passwords, tokens, private addresses and other secrets before sharing logs. Report reproducible plug-in problems in the OSPy-plugins issue tracker.

Back to the plug-in catalog

Clone this wiki locally