wxcal generates an iCal feed from weather.gov forecast data for a given location. The resulting feed has an all-day event for today and for each of the following 6 days; each event contains a summary of the forecast for that day along with the day's sunrise & sunset times.
For an example feed generated with this tool, see dzombak.com/local/wxcal/Ann-Arbor-MI.ics.
Optionally, wxcal can also generate a sunrise/sunset specific calendar alongside the forecast calendar.
wxcal [-flag value] [...]
-calDomain string
The calendar's domain (eg. "ical.dzombak.com") (required)
-calLocation string
The name of the calendar's location (eg. "Ann Arbor, MI") (required)
-evtTitlePrefix string
An optional prefix to be inserted before each event's title
-icalFile string
Path/filename for iCal output file (required)
-lat float
The forecast location's latitude (eg. "42.27") (default 42.27)
-lon float
The forecast location's longitude (eg. "-83.74") (default -83.74)
-sunIcalFile string
Optional path/filename for sunrise/sunset iCal output file
Additionally, wxcal -version will print the version number and exit.
This invocation, run periodically via cron, generates the example feed mentioned above (dzombak.com/local/wxcal/Ann-Arbor-MI.ics):
wxcal -calDomain ics.dzombak.com -calLocation "Ann Arbor, MI" -lat 42.27 -lon "-83.74" -icalFile "/home/cdzombak/wxcal/public/Ann-Arbor-MI.ics" -evtTitlePrefix "[A2]"This invocation generates two feeds, one for Chelsea weather and another for Chelsea sunrise/sunset:
wxcal -calDomain ics.dzombak.com -calLocation "Chelsea, MI" -lat 42.35 -lon "-84.03" -icalFile "/home/cdzombak/wxcal/public/Chelsea-MI.ics" -sunIcalFile "/home/cdzombak/wxcal/public/Chelsea-MI-Sun.ics"brew install cdzombak/oss/wxcalInstall my Debian repository if you haven't already:
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://dist.cdzombak.net/deb.key | sudo gpg --dearmor -o /etc/apt/keyrings/dist-cdzombak-net.gpg
sudo chmod 0644 /etc/apt/keyrings/dist-cdzombak-net.gpg
echo -e "deb [signed-by=/etc/apt/keyrings/dist-cdzombak-net.gpg] https://dist.cdzombak.net/deb/oss any oss\n" | sudo tee -a /etc/apt/sources.list.d/dist-cdzombak-net.list > /dev/null
sudo apt-get updateThen install wxcal via apt-get:
sudo apt-get install wxcalPre-built binaries for Linux and macOS on various architectures are downloadable from each GitHub Release. Debian packages for each release are available as well.
Clone the repo (https://github.com/cdzombak/wxcal.git) and change into the wxcal source directory.
Run make install to install wxcal to /usr/local/bin. Or, to install somewhere else, run make build and move ./out/wxcal to wherever you'd like.
Just remove the wxcal binary from wherever it's installed. If you installed to /usr/local/bin with make install, run make uninstall to remove it.
Docker images are available for a variety of Linux architectures from Docker Hub and GHCR. Images are based on the scratch image and are as small as possible.
A top-level directory /ical exists in wxcal containers and is the working directory for the wxcal tool. You can mount a volume there for easy access to generated iCal files with zero verbosity.
Run wxcal under Docker via, for example:
docker run --rm \
-v /srv/ical-feeds:/ical \
cdzombak/wxcal:1 \
-calLocation "Ann Arbor, MI" -lat "42.27" -lon "-83.74" \
-calDomain ics.dzombak.com \
-v /srv/www/ical-feeds:/ical \
-icalFile "Ann-Arbor-MI.ics"
docker run --rm \
-v /srv/www/ical-feeds:/ical \
ghcr.io/cdzombak/wxcal:1 \
-calLocation "New York, NY" -lat "40.73" -lon "-73.94" \
-calDomain ics.dzombak.com \
-icalFile "New-York-NY.ics"- GitHub: @cdzombak/wxcal
- Issue tracker
- Author: Chris Dzombak (GitHub @cdzombak)
GNU LGPL v2.1; (c) Chris Dzombak 2019-2023. See LICENSE at the root of this repository.