/izulu

weather-aware desktop background images

Primary LanguageShellGNU General Public License v3.0GPL-3.0

izulu

Weather aware desktop background images

izulu example

Izulu is a script that fetches the current weather from brightsky and changes the desktop background accordingly.

It can also show the weather forecast (from met.no) and the current temperature (brightsky). As much as possible is detected automatically, like the command to change the background or the current position (via location.services.mozilla.com). So this is based on data from MET Norway and the Deutscher Wetterdienst.

The forecast feature uses the MET Weather API icons (MIT).

Install

PPA

On launchpad, there is a PPA with daily builds. Add it with

sudo add-apt-repository ppa:onli/izulu

and install izulu

sudo apt-get update
sudo apt-get install izulu

Arch Linux

Install izulu-git from the AUR

yaourt -S izulu-git

Manual

Install the dependencies (on Ubuntu):

sudo apt-get install imagemagick jq bc gettext gawk x11-utils

Download this repository and install with:

make
sudo make install # (or use checkinstall)

On older Ubuntu systems, install also notify-send (new ones will have it already installed). It is not strictly necessary, only if --osd is specified to show notifications on weather change.

The package x11-utils is used for the xdpyinfo command, other distributions (like Void Linux) might package it separately.

Start

To use all common features, start izulu like this:

izulu --daemon --night --forecast --temperature --osd &

Optionally, use -l LAT:LON to set your current location manually.

Configuration

For a list of all parameters see the manpage.

Location

izulu can configured partly in ~/.izulu/config, especially the LATITUDE and LONGITUDE parameter are important if the automatic location detection fails.

Custom images

To set custom images, check their name in /usr/share/izulu and add a image with the same name to ~/.izulu/. The categories are sun, cloud, rain, snow , wind and misc (=fog), and there is a thunder category (according to its documentation not yet supported by the weather api, but planned). The image files are called gen_CATEGORY, for example gen_sun. Substates are partly_cloudy and cloudy for gen_cloud, rain and hail for gen_rain, sleet and snow for gen_snow. The category gen_wind also knows the substates windy and tornado, I hope you never see the latter. You can set custom images for the substates by saving an image with its name in ~/.izulu/.