{"id":13580535,"url":"https://github.com/onli/izulu","last_synced_at":"2026-01-04T03:48:46.137Z","repository":{"id":15989863,"uuid":"18733027","full_name":"onli/izulu","owner":"onli","description":"weather-aware desktop background images","archived":false,"fork":false,"pushed_at":"2023-12-08T16:33:12.000Z","size":56522,"stargazers_count":20,"open_issues_count":0,"forks_count":2,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-02T05:55:15.521Z","etag":null,"topics":["desktop-background","shell","weather"],"latest_commit_sha":null,"homepage":"https://onli.github.io/izulu/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/onli.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-04-13T15:55:00.000Z","updated_at":"2023-08-07T14:08:52.000Z","dependencies_parsed_at":"2023-12-08T17:41:59.834Z","dependency_job_id":null,"html_url":"https://github.com/onli/izulu","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onli%2Fizulu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onli%2Fizulu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onli%2Fizulu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onli%2Fizulu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/onli","download_url":"https://codeload.github.com/onli/izulu/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247426112,"owners_count":20937067,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["desktop-background","shell","weather"],"created_at":"2024-08-01T15:01:52.786Z","updated_at":"2026-01-04T03:48:46.125Z","avatar_url":"https://github.com/onli.png","language":"Shell","funding_links":[],"categories":["Shell","Packages"],"sub_categories":["Background setting utilities and generators"],"readme":"# izulu\nWeather aware desktop background images\n\n![izulu example](https://lh5.googleusercontent.com/-E2Idz1l1NV0/U0rCEzev83I/AAAAAAAAC60/rK9ELFUp7Pg/s800/izulu.jpg)\n\nIzulu is a script that fetches the current weather from brightsky and changes the desktop background accordingly.\n\nIt 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.\n\nThe forecast feature uses the [MET Weather API icons](https://github.com/metno/weathericons) (MIT). \n\n## Install\n\n### PPA\n\nOn launchpad, there is a [PPA with daily builds](https://launchpad.net/~onli/+archive/izulu). Add it with\n    \n    sudo add-apt-repository ppa:onli/izulu\n    \nand install **izulu**\n    \n    sudo apt-get update\n    sudo apt-get install izulu\n    \n### Arch Linux\n\nInstall izulu-git from [the AUR](https://aur.archlinux.org/packages/izulu-git/)\n\n    yaourt -S izulu-git\n\n### Manual\n\nInstall the dependencies (on Ubuntu):\n\n    sudo apt-get install imagemagick jq bc gettext gawk x11-utils\n\nDownload this repository and install with:\n\n    make\n    sudo make install # (or use checkinstall)\n\nOn 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.\n\nThe package x11-utils is used for the `xdpyinfo` command, other distributions (like Void Linux) might package it separately.\n\n## Start\n\nTo use all common features, start izulu like this:\n\n    izulu --daemon --night --forecast --temperature --osd \u0026\n\nOptionally, use `-l LAT:LON` to set your current location manually. \n    \n## Configuration\n\nFor a list of all parameters see the manpage.\n\n### Location\n\nizulu can configured partly in **~/.izulu/config**, especially the `LATITUDE` and `LONGITUDE` parameter are important if the automatic location detection fails.\n\n### Custom images\n\nTo 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/**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonli%2Fizulu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fonli%2Fizulu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonli%2Fizulu/lists"}