AganetWX: a configurable weather station skin for WeeWX

I’ve been running a personal weather station since 2010, and since 2011 it’s been powered by a Davis Vantage Pro2+. I couldn’t be happier with the hardware. Apart from replacing two anemometers and doing a bit of annual maintenance, it has worked reliably for well over a decade. The software has been a different story.

Over the years I’ve used several weather station applications to collect, archive and publish my weather data online. Each had its strengths, but none quite matched the flexibility I wanted. Eventually I settled on WeeWX, which has been running my station for many years. I now have continuous historical weather data stretching back to 2011. Every observation since then is still available in my online archive.

Along the way, I experimented extensively with different layouts and customizations, tweaking existing skins to make them look and feel more like my own. Eventually, I realized I wanted to try something different: build a skin from the ground up, with my own visual style and my own ideas about how a weather dashboard should work. That’s how AganetWX started.

AganetWX is a WeeWX 5.x dashboard skin built around one simple principle:

Everything should be configurable from weewx.conf. No template editing required.

Colors, layouts, tabs, charts, table rows, themes, the About page, optional widgets, almost everything is controlled through configuration. Because your changes live in weewx.conf, upgrading the skin doesn’t overwrite your customizations. The project is open source (GPL v3) and available on GitHub: https://github.com/aganet/weewx-aganetwx

Features#

Interactive, self-hosted charts#

Every weather metric has its own interactive chart, rendered using Apache ECharts bundled directly with the skin. There are no CDNs and no external dependencies. Available charts include:

• Temperature and derived values
• Humidity
• Barometric pressure
• Wind speed, gusts and direction
• Wind rose
• Rain and rain rate
• UV index
• Solar radiation
• Evapotranspiration
• Cloud base

Real calendar periods#

The dashboard includes pages for:

• Current
• Yesterday
• Week
• Month
• Year
• Last Year
• Archive
• About

The Current page displays the last 24 hours, while the remaining pages use true calendar periods. “Yesterday” really means midnight-to-midnight rather than a rolling 24-hour window.

Automatically adapts to your hardware#

AganetWX discovers whatever observations your station actually reports instead of relying on a fixed list of supported sensors. Whether you’re using a Davis station with extra sensors, an Ecowitt, a Tempest, or something much simpler, the dashboard automatically includes available measurements such as:

• Extra temperature and humidity sensors
• Soil sensors
• Leaf sensors
• Air quality
• Lightning
• Battery status

No template modifications are required.

Uses your existing WeeWX configuration#

The skin respects your existing WeeWX settings, including:

• Unit system
• Time zone
• Formatting

Nothing is overridden, so the dashboard remains consistent with the rest of your installation.

Seven built-in languages#

AganetWX currently ships with complete translations for:

• English
• Greek
• Spanish
• French
• German
• Italian
• Portuguese

Visitors can switch languages instantly from the page header without reloading, and the browser’s preferred language is detected automatically. Adding another language is simply a matter of providing a single translation file.

Multiple themes#

Three built-in appearances are included:

• Modern
• Classic
• Dark

Visitors can switch themes from the page header, and their preference is remembered. Colors and typography are fully configurable.

Mobile-friendly#

The layout is fully responsive:

• Charts resize cleanly.
• Legends reflow automatically.
• Dashboard panels stack naturally.
• Optional webcam banners expand edge-to-edge on smaller screens.

Lots of small quality-of-life details#

There are plenty of smaller touches that make daily use more enjoyable:

• Barometer trend indicator (rising, steady or falling)
• Wind direction arrow showing the current bearing
• Sun and Moon card with a rendered moon phase
• NOAA monthly and yearly reports
• Automatically generated station information on the About page

Optional extras#

Weather data doesn’t have to look sterile. An optional webcam banner can display either a local image or a remote URL. It can auto-refresh on an interval or stay static, and its size and position are configurable. Another optional feature is the Weather Mood Hero, which subtly changes the appearance of the current conditions panel based on temperature. Freezing conditions become icy blue, comfortable weather stays calm blue, while hotter temperatures transition through amber, orange and deep red. A small weather mood from “Brrr!” to “Perfect” to “Melting!” is displayed in the currently selected language. Both features are disabled by default.

Installation#

AganetWX supports WeeWX 5.x.

sudo weectl extension install https://github.com/aganet/weewx-aganetwx/releases/latest/download/AganetWX-1.5.7.zip
sudo weectl report run

The skin installs alongside your existing one, making it easy to try without replacing your current website. Most users won’t need to change anything beyond a handful of configuration options, and every feature is optional. AganetWX is released under the GNU GPL v3. Contributions are always welcome, especially translations into additional languages. Source code and releases: https://github.com/aganet/weewx-aganetwx