https://github.com/onli/izulu
weather-aware desktop background images
https://github.com/onli/izulu
desktop-background shell weather
Last synced: 5 months ago
JSON representation
weather-aware desktop background images
- Host: GitHub
- URL: https://github.com/onli/izulu
- Owner: onli
- License: gpl-3.0
- Created: 2014-04-13T15:55:00.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2023-12-08T16:33:12.000Z (over 2 years ago)
- Last Synced: 2025-04-02T05:55:15.521Z (about 1 year ago)
- Topics: desktop-background, shell, weather
- Language: Shell
- Homepage: https://onli.github.io/izulu/
- Size: 53.9 MB
- Stars: 20
- Watchers: 6
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: LICENSE
Awesome Lists containing this project
- awesome-ricing - izulu - weather-aware desktop background images. (shell) (Packages / Background setting utilities and generators)
README
# izulu
Weather aware desktop background images
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 [beaconDB](https://beacondb.net/)). So this is based on data from MET Norway and the Deutscher Wetterdienst.
The forecast feature uses the [MET Weather API icons](https://github.com/metno/weathericons) (MIT).
## Install
### PPA
On launchpad, there is a [PPA with daily builds](https://launchpad.net/~onli/+archive/izulu). 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](https://aur.archlinux.org/packages/izulu-git/)
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/**.