Skip to end of metadata
Go to start of metadata

Application Functionality & Background

Weather MQTT functions as a GUI to any weather station that is running the WeeWX software ( and is also pushing messages to an MQTT server. It connects to the MQTT server (you can find the MQTT extension for WeeWX here: and it listens for topic updates and it publishes their values to the GUI.


Application configuration

In this screen you can setup the following:

  • Gauges/screen is the total number of gauges on the screen. (I find that on the iPhone, 3 works best and on an iPad I pick 8)
  • The landscape number of gauges X the portrait need to equal the total gauges per screen. (In the below iPhone configurations I have setup 3 gauges per screen, 1 wide by 3 vertical in portrait mode and 3 wide by 1 vertical in landscape mode)
  • Station units are the units your weather station MQTT configuration is reporting on so gauge unit conversions can take place
  • Host name is the host where your MQTT server is running on
  • Port is the port the server is listening on
  • Websockets if used can be checked off
  • TLS can also be used if your MQTT server is running over HTTPS. (You will need to have setup a valid certificate on the MQTT server)

Adding screens and gauges

In screen maintenance job you can do the following:

  • Add any number of screens containing gauges by clicking Add Screen.
  • Clicking on the i symbol, allows you to edit the screen name.
  • Clicking on edit, allows you to:
    • Select multiple screens to delete.
    • Rearrange screen order.

Adding gauges to a screen

After creating and saving a screen you can select it in order to manage the gauge contents for it

Things you can do:

  • Add a number of gauges to your screen.
  • Edit, to delete multiple gauges or rearrange their order

The number of gauges in your screen should equal the total number of gauges per screen as entered in the application setup. Otherwise you will get an error when you try to run the application and will have to make the correction

Customizing gauges

The gauges are easily customized as follows:

  • You can pick the main display units (shown by the gauge needles). The units are predefined.
  • You can check the rounding on the units.
  • You can set the look for each gauge based on what values are expected.

Below is a depiction of a customization for a Barometer measurement gauge. 

Notice the following:

  • The Label non-zero start decides the starting (lowest) value the gauge will show. (Your barometer depending on your location will usually not be under 800 mbar)
  • The Label end is added to Label non-zero start, so the highest value the gauge will show is 1080 mbar.
  • The Label step indicates how often there will be a numbered label (should coincide with your major ticks frequency). In the below example we have numeric numbered labels every 20 units. 
  • Major tick end is the number of major ticks for the gauge. Since the gauge will display from 800 to 1080, which is 280 units, there will be a major tick every 20 units. (280 / 14)
  • The Minor tick step is set to 2 which means that there will be (280 / 2) of them on the gauge, and the distance between minor ticks is representing 2 units.

Privacy Policy

Weather-MQTT does not collect any data or information from the user and their device.

  • No labels