descriptionRetrieve conditions and forecasts.
ownerJeremy Stanley <>
last changeSun, 30 Aug 2020 18:08:25 +0000 (18:08 +0000)

This command-line utility is intended to provide quick access to current weather conditions and forecasts. Presently, it is capable of returning data for localities throughout the USA and some select locations globally by retrieving and formatting decoded METARs (Meteorological Aerodrome Reports) from NOAA (the USA National Oceanic and Atmospheric Administration) and forecasts/alerts from NWS (the USA National Weather Service). The tool is written to function in the same spirit as other command-line informational utilities like cal(1), calendar(1) and dict(1). It retrieves arbitrary weather data via precompiled correlations or custom-tailored aliases (system-wide or on a per-user basis). It can be freely used and redistributed under the terms of a BSD-like License.

My girlfriend had a long commute to/from work and school, and often wanted to check the weather both for home and her office. Unfortunately, starting a Web browser, pulling up a weather site, entering multiple ZIP codes and waiting for them to load is time-consuming for the marginally-impatient. Since she tended to stay logged into a shell server most of the time, I figured I'd install a quick command-line tool to retrieve weather info for her commute. To my surprise, a quick search turned up little that met my basic requirements:

A tarball for the most recent version of the weather utility can be had here:

Alternatively, Debian and Ubuntu users can install the weather-util package from any mirror.

2020-08-30 Jeremy StanleyPrepare for 2.4.1 release master 2.4.1
2020-08-30 Jeremy StanleyRefresh correlation data
2020-08-01 Jeremy StanleyUpdate correlation data
2020-07-26 Jeremy StanleyRefresh active station list and correlation data
2020-07-26 Jeremy StanleyMake missing alert URLs non-fatal
2020-07-26 Jeremy StanleyCorrect default_atypes to match what's generated
2020-07-25 Chris LambMake the build reproducible
2020-06-21 Jeremy StanleyUpdate release notes and docs for 2.4 release 2.4
2020-06-21 Jeremy StanleyGet correlate() working in modern Python 3
2020-06-21 Jeremy StanleyBe more thorough about file copyrights
2020-06-02 Jeremy StanleyDon't use "is" with a literal to test for equality
2020-05-31 Jeremy StanleyCaching support for URLs with port numbers
2020-05-31 Jeremy StanleyUse a dedicated field for cached search timestamps
2020-05-31 Jeremy StanleyDecode retrieved files as UTF-8 even on Python 2
2020-05-31 Jeremy StanleyAdd weather zone hkz000 for Hong Kong Observatory
2020-05-24 Jeremy StanleyAdd some fresh overrides
8 months ago 2.4.1 2.4.1 release
10 months ago 2.4 2.4 release
4 years ago 2.3 2.3 release
4 years ago 2.2 2.2 release
4 years ago 2.1 2.1 release
8 years ago 2.0 2.0 release
8 years ago 1.5 1.5 release
8 years ago 1.4 1.4 release
8 years ago 1.3 1.3 release
8 years ago 1.2 1.2 release
8 years ago 1.1 1.1 release
8 years ago 1.0 1.0 release
8 months ago master