Description
WS40 – Live Weather connects your personal weather station to WordPress. It reads the realtime.txt file produced by your weather software, archives the readings in your WordPress database, and displays them anywhere on your site through shortcodes. No coding required.
Supported sources
The format is auto-detected, with no manual configuration:
- Meteobridge and Meteobridge PRO (standard realtime.txt and the Master key/value template)
- WS40 Meteotemplate v2: Meteobridge (Weather Nets → WS40 Meteotemplate v2) and any software that supports it send the readings straight to your site over HTTPS, with no file to upload
- Weather Display (WS40 master template, included)
- Cumulus MX and Cumulus v1 (with automatic unit conversion)
- Davis WeatherLink API (v2): your Davis station read directly from your WeatherLink account, with your own API Key and API Secret — no Meteobridge needed
- Ecowitt.net API (v3): your Ecowitt gateway (GW1100, GW2000, GW3000…) read from your ecowitt.net account over HTTPS, with your own Application Key and API Key
Ecowitt, Fine Offset, LaCrosse, Ambient Weather and other hardware also work through Meteobridge as a gateway.
Features
- Live dashboard — a clean two-column admin overview with a live data snapshot and system status
- Table View
[ws40_tableview]— responsive weather table with 1–3 column layouts, group separators and icon packs - Weather widget
[ws40lw_widget]— your station’s values as a list, tiles or a one-line strip; also as a block and a classic widget - Local webcam
[ws40_webcam]— a gallery folder or a single fixed image, with auto-refresh - History — log with date filters, pagination and manual cleanup
- Column mapping — verify the source reading and run a realtime test
- Diagnostics — system status, cron health and database check
- WS40 Network — optional: show your station on the public WS40 Network map (off until you join from the Dashboard)
- Built-in step-by-step guide
- Available in 7 languages: English, Italian, French, Spanish, German, Portuguese (BR) and Dutch
Trademarks
Meteobridge, Cumulus, Davis, Ecowitt, Fine Offset, LaCrosse and Ambient Weather are trademarks of their respective owners. WordPress is a registered trademark of the WordPress Foundation. This plugin is not affiliated with, endorsed by or sponsored by any of these companies.
External Services
WS40 reads weather data from the realtime.txt source you configure (your own weather station or server), using the URL or local file you provide.
With “WS40 Meteotemplate v2” as the data source, your station’s software sends its readings to your own site; WS40 does not contact any external service for it.
Davis WeatherLink API (optional)
When you choose “Davis WeatherLink API” as the data source of your station (WS40 → Dashboard → Edit), WS40 reads the current conditions of your Davis station from the WeatherLink v2 API run by Davis Instruments. Nothing is sent to Davis until you enter your own API Key and API Secret and choose this source.
- What is sent: your API Key (as a request parameter) and your API Secret (as a request header), which identify your WeatherLink account, and the ID of the station you chose. No data about your website or its visitors are sent.
- When: when you load the list of your stations or test the connection in the station form, and then to read the current conditions, at most once every 4 minutes (one reading is shared by the history logging, every 15 minutes, and your pages).
- Where: https://api.weatherlink.com/v2/ (GET /stations and GET /current/{station}).
- WeatherLink v2 API documentation: https://weatherlink.github.io/v2-api/ · Davis Instruments Terms of Use: https://d3kr0guba1dvwf.cloudfront.net/static/docs/Davis_Instruments_Terms_Of_Use_en.pdf · Privacy policy: https://support.davisinstruments.com/article/dmze5ihmbq-privacy-policy
Ecowitt.net API (optional)
When you choose “Ecowitt.net API” as the data source of your station (WS40 → Dashboard → Edit), WS40 reads the current data of your Ecowitt gateway from the Ecowitt API v3 run by Ecowitt. Nothing is sent to Ecowitt until you enter your own Application Key and API Key and choose this source.
- What is sent: your Application Key and API Key (as request parameters), which identify your ecowitt.net account, and the MAC address of the gateway you chose. No data about your website or its visitors are sent.
- When: when you load the list of your devices or test the connection in the station form, and then to read the current data, at most once a minute (one reading is shared by the history logging and your pages).
- Where: https://api.ecowitt.net/api/v3/ (GET /device/list and GET /device/real_time).
- Ecowitt API documentation: https://doc.ecowitt.net/web/#/apiv3en?page_id=1 · Terms of service: https://shop.ecowitt.com/policies/terms-of-service · Privacy policy: https://shop.ecowitt.com/policies/privacy-policy
WS40 Network (optional, off by default)
The plugin can show your station on the WS40 Network, a public map of weather stations at https://www.weatherstation40.live/network/ run by the author of this plugin. Nothing is sent until you join from WS40 → Dashboard → WS40 Network and tick the consent box; you can leave at any time with “Leave the network”, which deletes your station from the map.
- What is sent when you join: the address of your website, a temporary random code (the WS40 Network reads it back from your site at /wp-json/ws40lw/v1/network/verify to check that you control the site) and the plugin name.
- What is sent afterwards, at most every 5 minutes after each reading saved in the history: station name and town as you typed them, position rounded to about 1 km (the exact position is never stored), time zone, website address, plugin version, data source, and the current temperature (with today’s minimum and maximum), humidity, pressure, wind speed, direction and gust, rain today and particulate matter when available. Requests are signed with a key given by the WS40 Network.
- Where: https://www.weatherstation40.live/wp-json/ws40net/v1/ (register, push, delete).
- No data about your website visitors are sent. New stations appear on the map after approval by the WS40 Network admin.
- Terms of service: https://www.weatherstation40.live/terms-of-service/ · Privacy policy: https://www.weatherstation40.live/privacy-policy/
Privacy
WS40 does not collect, store or transmit any personal data about your website visitors. It reads weather data from your configured source (your file, or your Davis WeatherLink account when you choose that source) and stores it in your local WordPress database. Only if you join the optional WS40 Network are the current readings of your station, its name, town and rounded position sent to weatherstation40.live (see External Services). For privacy questions: info@weatherstation40.live
Installation
- Upload the
ws40-live-weatherfolder to/wp-content/plugins/, or install it from Plugins → Add New. - Activate the plugin from Plugins → Installed Plugins.
- Go to WS40 → Dashboard and add your station.
- Enter the URL of your realtime.txt file (for example
https://example.com/meteo/realtime.txt). - Open WS40 → Settings and run the Realtime Test to confirm the source is read correctly.
- Paste
[ws40_tableview]into any page, post or widget.
FAQ
Which weather stations are supported?
WS40 reads realtime.txt files; it does not connect directly to station consoles. Meteobridge, Meteobridge PRO, Cumulus MX and Cumulus v1 are supported with automatic format detection. Davis, Ecowitt, LaCrosse, Ambient Weather and similar hardware work through Meteobridge as a gateway.
Can I use a local file instead of a URL?
Yes. The file must be inside wp-content/uploads/. Arbitrary filesystem paths are not allowed; an http(s) URL is the recommended option.
Does it work on shared hosting?
Yes. For reliable logging on shared hosting, an external trigger (such as your hosting scheduler) is recommended over WP-Cron.
Which languages are included?
English, Italian, French, Spanish, German, Portuguese (BR) and Dutch — 7 languages, all fully translated.
Is there a premium version?
The free version is complete and fully functional on its own. A separate premium version with additional features is available at weatherstation40.live.
Screenshots
Changelog
1.6.3 – 2026-11-06
- Fixed: Templates → Table View — dragging the fields to change their order works (the script it needs was not loaded).
- Fixed: Instructions — the side menu highlights the section you are reading.
- Code clean-up: removed old pages, functions, icons, a stylesheet and translations no longer used. Nothing changes in your pages.
1.6.2 – 2026-11-04
- New: Table View layout — vertical cards (as before) or horizontal bands, where each group spans the width and its readings wrap automatically. Choose it in WS40 → Templates → Table View.
- New: an optional “Essential” style button that fills the existing color, typography and border controls with a clean preset; nothing changes until you save.
- Improved: Table View labels wrap instead of being cut, numbers line up, units are easier to read, and the layout adapts better to narrow containers and phones.
- Fixed: some live values were not shown although the station sent them — daily humidity highs and lows, wet-bulb temperature and the Davis AirLink AQI — because acquisition and display used different field names; the daily pressure tracker read a different pressure value too. Supplied readings (and valid zero values) are now used before any estimate.
- Fixed: the header now labels the calculated value as “Apparent temperature” and keeps “Feels like” for a value sent by the station; Italian labels no longer confuse wind chill with apparent temperature.
- Your saved colors, fields, order and the vertical layout stay as they are. No change to data acquisition, calculations or history storage.
1.6.1 – 2026-11-03
- Fix: deleting WS40 – Live Weather while WS40 Premium is installed no longer removes the stations, the history and the settings the two plugins share. With WS40 Premium on the site (active or not), only the WS40 Meteotemplate v2 password of the free plugin is removed.
1.6.0 – 2026-11-02
- New: WS40 Meteotemplate v2 as a data source. In WS40 → Dashboard → Edit, choose “WS40 Meteotemplate v2” and save: WS40 shows the API URL and creates the password of the station. Paste both in Meteobridge → Weather Nets → WS40 Meteotemplate v2 (latest Meteobridge release): the readings arrive over HTTPS every minute, with no file to upload and no column mapping. The address also accepts the “/api.php” that Meteobridge adds.
- WS40 keeps the values that Table View and the weather widget show: temperature, humidity, pressure, wind, gust and direction, rain (rate, last hour, today, yesterday, month, last month, year, last year), solar radiation, UV, sunshine hours, evapotranspiration, indoor values, lightning, PM1/PM2.5/PM10 and the daily extremes. Every value is checked against the limits of the specification: a value out of range is refused and the rest of the upload is kept. The station edit page shows the last upload, the fields kept and any value refused.
- New: Weather Display master template (ws40_weatherdisplay_master_v5_4.txt), linked in the station form and in the Instructions; WS40 reads it like the Meteobridge master.
- Settings → Column Mapping shows the same “Values read” table for every data source — realtime.txt and master files (Meteobridge, Weather Display, Cumulus), Davis WeatherLink API, Ecowitt.net API and WS40 Meteotemplate v2 — with the name, value and unit of each reading. For a WS40 Meteotemplate v2 station it also shows the last upload and any value refused.
- Table View refreshes at the logging interval, just after the next reading is saved, instead of at a fixed time.
- Logging interval: choose every 1, 3, 5, 7, 10, 15 or 30 minutes. A station logged every 60 minutes moves to 30 minutes.
- Instructions: new WS40 Meteotemplate v2 section and Weather Display steps. Translated into all plugin languages.
1.5.0 – 2026-10-29
- New: Ecowitt.net API as a data source. In WS40 → Dashboard → Edit, choose “Ecowitt.net API”, enter the Application Key and API Key of your ecowitt.net account (user profile → API Keys), load your devices, choose your gateway and test the connection. WS40 reads the gateway from the cloud over HTTPS, so it works also on hostings that redirect every HTTP request to HTTPS. Values read: outdoor temperature, humidity, dew point and feels like, wind, pressure, rain (also the WS90 piezo gauge), UV, solar radiation, indoor temperature and humidity, PM1/PM2.5/PM10.
- Instructions: new Ecowitt.net API section. Translated into all plugin languages.
1.4.1 – 2026-10-29
- Instructions: new Davis WeatherLink API section with the steps to connect the station (API Key v2 and Secret, station choice, connection test), the values read, the 15-minute logging and the one-hour freshness check. Translated into all plugin languages.
1.4.0 – 2026-10-29
- New: Davis WeatherLink API as a data source. In WS40 → Dashboard → Edit, choose “Davis WeatherLink API”, enter the API Key v2 and API Secret of your WeatherLink account (weatherlink.com → Account → Generate v2 Key), load your stations, choose yours and test the connection. WS40 then reads your Davis station directly: no Meteobridge or realtime.txt file needed.
- The Davis readings are converted to metric and used everywhere — Table View, weather widget, dashboard, history and the WS40 Network — exactly like a realtime.txt source.
- A Davis station is logged every 15 minutes, the interval at which Davis refreshes the current conditions on the free Basic plan; one reading is shared by the logging and your pages, so WeatherLink is called at most once every 4 minutes. A station that has stopped reporting to Davis (latest reading older than one hour) is shown as not reporting and its old values are not stored.
- Settings → Column Mapping lists the values read from Davis (there are no columns to map).
- External services: the readme describes what is sent to the WeatherLink API, when, and the Davis terms and privacy policy.
1.3.0 – 2026-10-21
- New: weather widget with the station’s raw values in three layouts: a list, tiles with a large temperature, or a one-line strip for a header, a footer or a post. It follows the theme’s colours and fonts and uses the station’s units (metric or imperial, m/s when set).
- New: it is available as a block (“WS40 Weather widget”), as a classic widget (Appearance → Widgets) and as the shortcode
[ws40lw_widget], with optionallayout="list|tiles|strip"andfields="temp,hum,wind,...". - New: WS40 → Templates has a Widget tab: layout with live previews, the values to show (temperature, feels like, dew point, humidity, pressure, wind with direction, gust, rain today, rain rate, UV index, solar radiation), station name and time of the last reading. Values the station does not send are left out.
- No new external requests: the widget is built on the page with the data already saved on your site.
- 26 new strings translated in all 7 languages.
1.2.2 – 2026-10-21
- Instructions: the Meteobridge realtime.txt section now says clearly that column 10 must be the sea-level pressure ([thb0seapress-act.1]), not the station pressure ([thb0press-act]). The station pressure is about 12 hPa lower for every 100 m of altitude and was shown as sea-level pressure. Columns 34 and 36 (max and min today) use [thb0seapress-dmax.1] and [thb0seapress-dmin.1].
- 2 new strings translated in all 7 languages.
1.2.1 – 2026-10-20
- New: the Table View hero now shows the current conditions: an icon, a short label and a light background tint. They come from your station’s own data: light rain, rain, heavy rain, snow, thunderstorm, fog and strong wind. With a solar radiation sensor the sky is also estimated (clear, partly cloudy, mostly cloudy, overcast) and marked as an estimate. Without one, the plain sun or moon stays. The icons follow the chosen icon set.
- New: optional “Sky estimate” setting in the Table View: the station position, used only on your site to compare the solar sensor with the clear-sky value. If empty, the WS40 Network position is used when set.
- New: per-station wind unit in the station card: follow the measurement system (km/h or mph) or metres per second (m/s). It applies to wind speed and gusts in the Table View, the Dashboard and History.
- Fixed (imperial units): 7-day, previous month, previous year and total rain were shown in millimetres labelled “in” in the Table View and in History; the 3-hour temperature trend in the Dashboard was converted with the +32 offset; the apparent temperature fallback was not converted.
- Imperial units: wind run and lightning distance are now shown in miles; pressure shows 2 decimals in inHg and rain 2 decimals in inches.
- 19 new strings translated in all 7 languages.
1.2.0 – 2026-10-19
- New: WS40 Network — show your station on the public WS40 Network map at weatherstation40.live/network. A new “WS40 Network” card in the Dashboard: station name, town and position (rounded to about 1 km), a consent box, then “Join the network”. New stations appear on the map after approval; the card shows the state (waiting for approval, on the map, not sent with the reason) and has “Leave the network”. Off by default: nothing is sent until you join. See External Services.
1.1.2 – 2026-09-17
- Dashboard: the station card action buttons now anchor to the bottom, so the card fills its column cleanly next to the live snapshot.
1.1.1 – 2026-09-15
- Table View settings page updated to match the card layout: corrected the features list (card layout, border styles, columns) and the columns help text.
- Templates menu now opens the Table View settings directly (removed the intermediate Template Manager page).
- Internal cleanup: removed dead code left over from the card-layout migration (legacy table styling, unused style presets and column-split logic).
- Added Dutch (nl_NL) translation — the plugin now ships 7 languages.
- Dashboard header shows the available-language flags instead of the description text.
- Fixed: Dutch (nl_NL) site language now correctly loads the Dutch translation.
- Dashboard: single consolidated station card; removed the redundant station header row.
- Dashboard: two-row symmetric layout — station card and live snapshot side by side (equal height), full data table and system status below.
1.1.0 – 2026-09-14
- Table View redesigned as a responsive card layout: a hero with the current temperature and feels-like, plus grouped panels. All existing Table View settings (columns, width, border, colors, typography, icons, striped rows, hover) drive the card layout.
- New raw fields: average temperature, average humidity and average wind. “Feels like” uses the station’s raw value when available, otherwise a computed value.
- Cloud base and wind run are now computed automatically when the weather station does not send them.
- Local webcam: the gallery folder and single-image path can be located anywhere on the site, not only under wp-content/uploads.
- Timezone now follows the WordPress site setting; the per-station timezone control has been removed.
- The “Complete station weather data” diagnostic now lists the full set of fields consistently with the Meteobridge master template.
- Updated the bundled Meteobridge master template to v4.3.
- New plugin logo.
1.0.5
- Single-station: removed the internal stations table, all station management (add/list/select/toggle/delete), the active-station selection, and every external station_id input (REST/query/POST parameters, hidden form fields and admin selectors). The plugin now operates on one station whose settings live in a single option; a one-time migration drops the legacy table and preserves any existing configuration.
- External logging endpoint: the database upgrader now runs only after the request token is validated, so unauthenticated requests can no longer trigger schema-check work.
- Admin output escaping: every admin renderer now escapes at output through wp_kses with an explicit allowlist; removed all EscapeOutput suppressions across the admin pages.
1.0.4
- Removed residual non-file engine handling and the activation reset, so the build no longer ships disabled code paths.
- Hardened admin output escaping (wp_kses) in card and webcam renderers.
- Removed a redundant non-distributable file from the package.
1.0.3
- Table View now resolves the active station automatically and shows a clear notice when no data is available yet.
- Local webcam supports either a gallery folder or a single fixed image file, with a built-in source test.
- Added an offline threshold setting: the Table View shows an OFFLINE badge when the latest reading is older than the configured time.
- Hardened local file reading, plus i18n and compatibility fixes.
1.0.0
- First public release.








