(Zur deutschen Version)
A Übersicht widget to display the current weather for a location along with the option of a single and up to a 10-day forecast. To use it you need a apiKey from weather-underground, which can be obtained for free by registering on their website as developer. The free apiKey is restricted to 1000 calls per day. The widget refresh is set by default to 15 minutes (96 times per day). The widget is usable in the Englisch and the German language.

By default the widget has 4 display modes plus alert mode:

If you're not already using it anyway, install Homebrew. "The missing package manager for macOS."

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Then Install Übersicht:

$ brew cask install ubersicht

(Alternatively, you can download and install Übersicht from it's website.)

Clone this repository and move it into the Übersicht widgets folder:

$ git clone https://github.com/DeltaOS2/weather-underground.widget.git
$ mv weather-underground.widget/ ~/Library/Application\ Support/Übersicht/widgets/

Start or restart Übersicht. The widget should appear in the Übersicht menu.

Edit the index.coffee and review/modify the following items:

• The iconSet variable on line 9. This is the main weather icon that is displayed. Take a look at the folders in the „images“ folder and decide which you like best. There are several iconSets delivered to choose between. The default is a but the widget also includes all the other icon sets from weather-underground (11 sets). -- If you want to build your own icon set from other icons make sure to name them with the same names as the delivered icons.
• The numberOfDays variable on line 12 controls how many days of forecast are shown. At the current time weather-underground returns a max of 10 days (including today). The widget will reset any value larger than 10 back to 10.
• The numberOfAlerts variable on line 15 controls how many weather alerts will be displayed.
• The display mode variable on the lines 18 to 21 controls the display mode.
  • display = day displays just the banner with the todays conditions.
  • display = text displays the banner plus the numberOfDays you've set as text with a the weather condition icon in front.
  • display = icon displays the banner plus the forecast for 8 days as little icons.
  • display = iconplus displays all of the icon-mode plus 3 days as text.
• Edit the latitude and longitude of the location you wish to display the weather details for in lines 24 & 25.
• Edit the apiKey on line 28 to set your weather-underground API key. Visit weather underground developer login to register and generate a free API key.
• The lang variable on lines 31 and 32 controls the displayed language. The options are German and English.
• The units variable on lines 35 and 36 controls what units are displayed. You can chose metric to display celsious degrees and kilometer or imperial to display fahrenheit and miles.
• The widget location on your screen can be changed by changing top and left in the style-section (line 345 and 346).

Ein Übersicht widget zur Darstellung der Wetterkonditionen an einem bestimmten Ort. Es bietet verschiedene Optionen. Es kann ein einzelner Tag oder bis zu 10 Tagen dargestellt werden. Um das widget benutzen zu können, braucht man einen apiKey von weather-underground. Man kann den Key kostenlos erhalten wenn man sich dort als Developer registriert. Der Key erlaubt bis zu 1000 Aufrufe pro Tag. Die Aktualisierungsrate des widgets ist auf "alle 15 Minuten" gesetzt. Das entspricht 96 Aufrufen pro Tag.

Fall nicht bereits geschehen, installiere Homebrew. "Den fehlende Paketmanager für macOS."

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Danach installiere Übersicht:

$ brew cask install ubersicht

(Alternativ kannst du Übersicht von seiner WebSeite herunterladen und installieren.)

Klone dieses Repository und verschiebe es in das Übersicht widgets Verzeichnis:

$ git clone https://github.com/DeltaOS2/weather-underground.widget.git
$ mv weather-underground.widget/ ~/Library/Application\ Support/Übersicht/widgets/

Starte Übersicht oder starte es neu. Das widget sollte jetzt im Übersicht-Menü erscheinen.

Editiere die Datei index.coffee und modifiziere folgende Einstellungen:

• Die iconSet Variable in Zeile 9. Hier läßt sich das Wetter Icon auswählen, dass angezeigt wird. Schaue in das Verzeichnis „images“ und deren Unterverzeichnisse und wähle nach eigenem Geschmack.
• Die numberOfDays Variable in Zeile 12 bestimmt wieviele Tage angezeigt werden. Im Moment bietet weather-underground die Option zur Anzeige von bis zu 10 Tagen (inklusive Heute). Sollte eine größere Zahl als 10 eingegeben werden wird automatisch die maximale Anzahl angezeigt.
• Die numberOfAlerts Variable in Zeile 15 bestimmt wieviele Wetter-Alarme angezeigt werden.
• Die display Modus Variable in den Zeilen 18 bis 21 bestimmt die Darstellung des widgets.
  • display = day zeigt nur das Banner und die heutigen Konditionen an.
  • display = text zeigt das Banner plus der Anzahl der in numberOfDays gewählten Tage als Text mit dem vorangestellten Wetterzustands-Icon an.
  • display = icon zeigt das Banner plus der Vorhersage für 8 Tage als kleine Icons an.
  • display = iconplus zeigt den icon-Modus plus 3 Tage als Text an.
• Trage den Längen- und Breitengrad des Orts in den Zeilen 24 & 25 ein für den die Wetterdaten angezeigt werden sollen.
• Trage den apiKey in Zeile 28 ein. Falls du noch keinen hast, besuche weather underground developer login und registriere dich um eine freien Key zu erhalten.
• Die lang Variable in den Zeilen 31 und 32 bestimmt die angezeigte Sprache. Zur Auswahl stehen deutsch und englisch.
• Die units Variable in den Zeilen 35 und 36 bestimmt welche Einheiten angezeigt werden. Es kann zwischen metric zur Anzeige von Grad-Celsious und Kilometer oder imperial zur Anzeige von Fahrenheit and Meilen gewählt werden.
• Die Position des widgets auf dem Bildschirm kann durch ändern von top und left in der style-Sektion (Zeile 345 und 346) eingestellt werden.