Skip to content

Latest commit

 

History

History
109 lines (65 loc) · 4.84 KB

README.md

File metadata and controls

109 lines (65 loc) · 4.84 KB
Raw

Screenshot

gnome-shell-extension-openweather is a simple extension for displaying weather conditions and forecasts in GNOME Shell, featuring support for multiple locations, no need for WOEID, a symmetrical layout and a settings panel through gnome-shell-extension-prefs.

The weather data is fetched from OpenWeatherMap (including forecasts for up to ten days) or Dark Sky (including forecasts for up to eight days).

Note: since version 29 this extensions uses coordinates to store the locations and makes the names editable to support multiple weather-providers!

If you update from versions prior to 29 to 29 or greater (with Dark Sky - support) you have to recreate your locations.

Installation

After the installation, restart GNOME Shell (Alt+F2, r, Enter) and enable the extension through gnome-tweak-tool.

Through extensions.gnome.org (Local installation)

Go on the OpenWeather extension page on extensions.gnome.org, click on the switch ("OFF" => "ON"), click on the install button. That's it !

Through a package manager

Note: you need the root password for all these installation modes, if you do not have root-access, and the needed build-dependencies are installed, use the generic install.

Debian

Debian uses the (former master now ) yahoo-branch !

My fork of the extension is currently only available for unstable/sid.

Install the package through APT (or use your favourite package-manager, e.g. synaptic):

sudo apt-get install gnome-shell-extension-weather

Fedora

You can install the extension from the official Fedora repos.

Install the package through DNF

sudo dnf install gnome-shell-extension-openweather

Arch Linux (AUR)

sudo yaourt -S gnome-shell-extension-openweather-git

Generic (Local installation)

Make sure you have the following dependencies installed:

  • dconf,
  • gettext,
  • pkg-config,
  • git,
  • glib2 (and development packages),
  • zip,
  • gnome-common,
  • autoconf,
  • automake,
  • gettext-devel.
  • gnome-tweak-tool.

Run the following commands:

cd ~ && git clone git://github.com/jenslody/gnome-shell-extension-openweather.git
cd ~/gnome-shell-extension-openweather
./autogen.sh && make local-install

Configuration

Launch gnome-shell-extension-prefs (reachable also through the OpenWeather Settings button on the extension popup) and select OpenWeather from the drop-down menu to edit the configuration.

Screenshot

You can also use dconf-editor or gsettings to configure the extension through the command line.

On OpenWeatherMap you can either use the extensions default-key or register to get a personal API key. This key has to be added in the preferences dialog. Don't forget to switch the a appropriate switch in the dialog to "off" in this case.

To use Dark Sky you also need to register and get an API key. With this key you can make 1000 requests per day for free. This should be enough for this extension in any normal use case. Do not add billing information, otherwise you might have to pay for the weather-data if something went wrong !

Licence

Copyright © 2011 - 2013

Copyright © 2013 - 2017

This file is part of gnome-shell-extension-openweather.

gnome-shell-extension-openweather is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

gnome-shell-extension-openweather is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with gnome-shell-extension-openweather. If not, see http://www.gnu.org/licenses/.