This is a fork from https://gitlab.com/skrewball/openweather
- DONE: gnome 45 compatability
- PARITAL: address lint issues
- learn how to write a gnome extension
- make the codebase more maintainable
- BUG: change location from menu not working
- BUG: initial button not placed correctly
- consider .ui files for prefs
- consider a object for weather provider
- review schema (e.g. clock-format)
- should I be passing settings/metadata around?
- merge in changes from upstream MR/distro patches if any
- linting? global not seen
- CI automation
- publish automation?
- code review
- test plan (wayland X11, dark mode, light mode, i18n)
- review memory leaks/network calls
- publish fork: https://gitlab.gnome.org/Infrastructure/extensions-web/-/issues/269
- https://gjs.guide/extensions/development/creating.html#extension-js
- env MUTTER_DEBUG_DUMMY_MODE_SPECS=1280x1024 dbus-run-session -- gnome-shell --nested --wayland
- npx eslint src
- https://gjs.guide/extensions/upgrading/gnome-shell-45.html#prefs-js
- review guidelines https://gjs.guide/extensions/review-guidelines/review-guidelines.html#basics
- https://gitlab.gnome.org/ewlsh/gjs-guide/-/tree/main/src/guides/gjs/style-guide
- good extensions https://github.com/paperwm/PaperWM https://github.com/home-sweet-gnome/dash-to-panel https://github.com/aunetx/blur-my-shell https://github.com/daniellandau/switcher (As there is no really good central place to find documentation on writing Gnome Shell Extensions I'll list here where I got information from)
- seek help: https://app.element.io/#/room/#extensions:gnome.org
OpenWeather (gnome-shell-extension-openweather) is a simple extension for displaying weather conditions and forecasts for any location on Earth in the GNOME Shell. It provides support for multiple locations with editable names using coordinates to store the locations, a beautiful layout, and more.
Weather data is fetched from OpenWeatherMap including 3 hour forecasts for up to 5 days.
After completing one of the installation methods below, restart GNOME Shell (Xorg: Alt
+F2
, r
, Enter
- Wayland: log out
or reboot
) and enable the extension through the gnome-extensions app.
Visit OpenWeather on the Official GNOME Extensions website.
These are the currently available 'official' release packages that align with the E.G.O release version. There is a package in the AUR that I maintain myself, and Artem Polishchuk
maintains a package in the official Fedora repos.
Installing the extension this way provides a system wide installation.
Install using your favourite AUR helper, for example:
paru -S gnome-shell-extension-openweather
To install from the official fedora repos simply run:
sudo dnf install gnome-shell-extension-openweather
This method installs to your ~/.local/share/gnome-shell/extensions
directory from the latest source code on the master
branch.
First make sure you have the following dependencies installed:
Arch Based | Debian Based | Fedora |
---|---|---|
dconf |
dconf-gsettings-backend |
dconf |
gnome-shell |
gnome-shell-extension-prefs |
gnome-extensions-app |
git |
git |
git |
base-devel |
build-essential |
glib2-devel |
gettext |
gettext-devel |
|
libsoup3 |
Then run the following commands:
git clone https://gitlab.com/skrewball/openweather.git
cd openweather
make && make install
OpenWeather (gnome-shell-extension-openweather) is provided completely free of charge. If you enjoy using this extension and would like to help support the project, please feel free to hit the button below!
Or you can support my work by sending some crypto:
- Bitcoin: bc1q5r64qtsuxwfywfvesspathy2yun2aagpw58sv6
- Monero: 431XdMq2GsNZUXarUPtvW1j4Amt1VAzR3JYv3CHeZdTaQvn2pSKfFHM8MZi2RpN2B4JSssbKHrxVtNWrdyNDaEh3AZnstqS
- Pirate Chain: zs1eq5ju85hsutvepj9g6ysq80mlsx5wjpdty755z4l37we37crgs7lsk0zy2xyv2566gcyqlkwrla
- Equilibria: Tsz4p7GZpofQpXh2QW5St2Z1bSNfLR82gQLuV6P53LGTjDgzt3YcKt6im2eoYi5bCpddMHRaivYEidA2tE3fGz3e5MmoEtTVfA
Bugs should be reported here on the GitLab issues page.
When submitting a bug report, please make sure to provide as much information as you can about the issue, your Linux distribution, GNOME Shell version, and OpenWeather (gnome-shell-extension-openweather) version.
This project is a fork of the original OpenWeather extension by @jenslody. See AUTHORS
for previous contributor details.
Special thanks to the following people for updating translation *.po
files via merge requests since forking the project:
French: @franckgaga | Slovak: @jose1711 | Chinese: @xiaozhangup & @zyw271828 | Portuguese: @ronaldocosta | Russian: @vantu5z & @tvaliiev | Czech: @lev741 | Turkish: @oguzkarayemis | German: @zeners | Polish: @MarcinScieszka | Italian: @alealetti
OpenWeather's icon was designed by Sihan Liu and licensed under the CC-BY-SA license.
Packaged weather icons are sourced from the GNOME Project's Adwaita Icon Theme under the GPLv3 license.
PayPal donate button and template used for the Gitlab button was designed by Klemen Skerbiš under the GPLv3 license.
OpenWeather is free software available under the terms of the GPLv3 license. See COPYING
for details.