Skip to content

Weather forecasts in the iCalendar data format

License

Notifications You must be signed in to change notification settings

voegelas/MyApp-Weather

Repository files navigation

MyApp::Weather

A Mojolicious web application that gets weather forecasts from MET Norway and produces web calendars in the iCalendar data format. Calendars can be subscribed from software such as Thunderbird and ICSx⁵.

env WEATHER_USER_AGENT='example.com [email protected]' \
    script/weather daemon -l http://localhost:3000
curl http://localhost:3000/Oslo.ics

Calendar events have got a summary consisting of emojis and temperatures as well as a longer description of the weather conditions.

BEGIN:VEVENT
UID:58d61e67800ce518ca9eef11d0347fa3e6ea3a68
DTSTAMP:20211106T020745Z
DTSTART;VALUE=DATE:20211107
SUMMARY:🌫☀️ 6/-1°
LOCATION:Oslo
DESCRIPTION:00-05:   2° Fair\n05-10:   1° Fog\n10-12:   4° Partly clo
 udy\n12-18:   6° Clear sky\n18-22:   2° Clear sky\n22-24:  -1° Fair
COMMENT:Based on data from MET Norway
CLASS:PUBLIC
TRANSP:TRANSPARENT
X-SOGO-SEND-APPOINTMENT-NOTIFICATIONS:NO
END:VEVENT

DEPENDENCIES

Requires Perl 5.20, Mojolicious 9, Role::Tiny and Geo::Location::TimeZoneFinder.

QUERY PARAMETERS

  • lang

    • de (German)
    • en (English)
    • nb (Norwegian)
  • temperature_unit

    • C (Celsius)
    • F (Fahrenheit)

Example:

curl 'http://localhost:3000/Oslo.ics?lang=en&temperature_unit=F'

CONFIGURATION

Environment Variables

CACHE_DIRECTORY

Weather forecasts and locations are cached in this directory. The directory must exist and be writable.

LANG

The default weather forecast language.

REQUEST_BASE

The base path in the frontend proxy, e.g. /weather. Empty by default.

TEMPERATURE_UNIT

The default temperature unit.

TIME_ZONE_DATABASE

The file base of a time zone database from https://github.com/evansiroky/timezone-boundary-builder, e.g. /usr/local/share/timezones/combined-shapefile.

WEATHER_USER_AGENT

An identifying user agent string. See https://api.met.no/doc/TermsOfService and https://operations.osmfoundation.org/policies/nominatim/ for more information.

LICENSE AND COPYRIGHT

Copyright (C) 2023 Andreas Vögele

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

MET Norway provides data under the Norwegian Licence for Open Government Data (NLOD) 2.0 and Creative Commons 4.0 BY International licenses.

About

Weather forecasts in the iCalendar data format

Topics

Resources

License

Stars

Watchers

Forks