Wttr Forecast is a multi-location weather widget build for Übersicht
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Wttr Forecast Widget

for Übersicht http://tracesof.net/uebersicht/
Version: 1.0.1
Last Updated: 12/27/2017

Wttr Forecast is a multi-location weather widget build for Übersicht (MacOS). Wttr Forecast stores all weather information locally on your device and allows you to access forecasts even when you are offline.


  • makes use of the DarkSky API with a global coverage of nearly any location
  • allows you to add multiple location without adding more and more bloat to your screen
  • displays not just the current weather situation but also the forecast for upcoming days
  • loaded weather forecast gets stored on the local machine so even if your internet connection fails the Wttr widget will still display the last available information
  • customizable so you can easily set your desired language, unit or color preferences

Important information:
In order to use the arrows or navigation dots to switch between your different locations you need to choose an interaction shortcut in the Übersicht preferences.


In order to set up the widget properly you need to add the DarkSky API (forecasting provider) by yourself. The following steps will guide you through these steps:

  1. Open: https://darksky.net/dev
  2. Log in or Sign up if you haven't created an account yet
  3. Get your secret key and add it below to the apiKey section (the key needs to be put in quotation marks)


Key Description
apiKey add your personal DarkSky secret API key in order to download weather forecast information
uni Return weather conditions in requested units:
  • auto: automatically select units based on geographic location
  • ca: same as si
  • uk2: same as si
  • us: Imperial units
  • si: SI units (more: https://darksky.net/dev/docs)
language desired language in which summaries will get display (more: https://darksky.net/dev/docs)
accent accent color
refreshFrequency sets refresh rate of widget, change value outside of brackets to modify number of minutes before freshly updated weather forecasting information appearance on your screen
(remember: Free tier of DarkSky.io allows up to 1000 refresh calls per day)


Adding locations follows an easy to understand principle:

  1. create an id for your location (e.g. lnd)
  2. add a name to your location which later will be displayed on your widget (e.g. London, G)
  3. add 'Latitude' as well as 'Longitude' information (e.g. 51.5287718 and -0.2416814)

you can grab those information from Google Maps:

  1. open maps.google.com
  2. search for your desired location
  3. get the URL: https://www.google.com/maps/place/London,+United+Kingdom/@51.5287718,-0.2416814,11z/ you can find the important information here --> ^^^^^^^^^^ ^^^^^^^^^^

all in all the location: section will look like the following:

location: #<-- do not remove this part
    name: 'London, GB'
    lat: 51.5287718
    lng: -0.2416814

every other location can be added just like that:

location: #<-- do not remove this part
    name: 'London, GB'
    lat: 51.5287718
    lng: -0.2416814
    name: 'Paris, FR'
    lat: 48.8589507
    lng: 2.2770202

Version History

  • 1.0 - Initial Release
  • 1.0.1 - Fixed a bug present on macOS High Sierra (thanks @_martinc)


Based on the Multiple Locations Weather widget by Rubén Abad. While major parts of this widget were rewritten it still makes use of the original data access as well as parse functions.

Design-wise this widget is highly influenced by a beautiful SimpL Weather Widget crafted by the wonderfully talented Zahir Ramos. Definitely go and check out his work on dribble.

The gorgeous weather icons crafted by Erik Flowers can not just be used as standalone icons but also as an easy to implement font. So in case you are wondering what else you could use to display the current weather situation I encourage you to check out the project site.

Of course credits, where credits belong - so thank you very much Felix for creating and maintaining Übersicht.

In case of questions, errors, suggestions for an improvement or just to talk about your daily life feel free to get in touch with me or create a pull request and implement your needed functionality.


Social Link
Twitter @derKroggel
Github bkroggel

© 2017 | Bastian Kroggel