WeeWX is a free, open source, software program, written in Python, which interacts with your weather station to produce graphs, reports, and HTML pages. It can optionally publish to weather sites or web servers. It uses modern software concepts, making it simple, robust, and easy to extend. It includes extensive documentation.
WeeWX runs under most versions of Linux, as well as macOS, *BSD, and Solaris. Many users are running on the Raspberry Pi. The images on this page and throughout this web site are from sample stations running WeeWX.
Thousands of stations throughout the world run WeeWX, many of whom have opted-in to be shown on our station map.
- Support for many popular weather stations;
- Uploads to popular weather sites including WeatherUnderground, PWSweather.com, CWOP, WOW, and AWEKAS and others;
- Uploads to your website using FTP or rsync;
- Extensive celestial almanac;
- Ability to create or modify skins (the look and feel of your weather site);
- Support for localization;
- Simple, but extensible templating system;
- Native support for US or Metric unit systems;
- Support for sqlite or MySQL databases;
- Calibration corrections;
- Filtering of anomalous values;
- An easy to understand, simple, extensible micro-kernel architecture;
- Ability to extend WeeWX with new services and reports.
Last, but definitely not least,
- A fun, supportive Users' Group!
I wrote WeeWX over the winter of 2008-2009 for two reasons: it was a wet and miserable winter here in Oregon with not much else to do, so there was no good reason not to, and because I wanted a simple, easy-to-understand server to run my Davis VantagePro2 weather station on a Linux box. I had been using wview, which is a high-performance and feature rich system authored by Mark Teel with lots of users. Written in C, it is an efficient system that can run on underpowered boxes. In exchange, it is huge (45,000+ lines of code), tightly integrated in with its companion library, radlib (another 14,000+ lines), and very complex, making it difficult to understand and reliably customize. I wanted something more modern and much, much simpler.
Having made a career in C++ and Java, I was also interested in some more modern languages, so I thought I would try either Python or Ruby (although, truth be told, the roots of Python are nearly as old as C++!). I ended up picking Python because its libraries are more mature and there are many mores choices for third party libraries.
WeeWX has grown to about 27,000 lines of code (of which 14,000 are in the hardware-specific drivers), plus 14,000 lines of comments. Because it is pure Python, it requires no makefiles, no builds, no special installs. It offers very powerful configuration and templating options, as well as an internally extensible engine, making it easy to customize. Its internal modular design and use of modern exception handling make it very robust and difficult to crash. It is also architecturally very simple and easy to understand.
Some intrepid users have run WeeWX on Microsoft Windows, but this is not yet widely supported.