search

Neroth / gnome-shell-extension-weather

A simple extension for displaying weather informations from several cities in GNOME Shell
GNU General Public License v3.0
138 stars 143 forks source link

readme

Weather Extension

Screenshot

Gitter chat

gnome-shell-extension-weather 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 report include forecasts for ~ 10 days.

Support GNOME Shell >= 3.8

Contact the author : Neroth (Christian METZLER).

We need translator ! Translate the extension.

Installation

Through extensions.gnome.org (Local installation)

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

Through a package manager

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

Ubuntu, Mint, and derivatives

Add the PPA ppa:gnome-shell-extensions to your source list, update the package list and install gnome-shell-extension-weather:

sudo add-apt-repository ppa:gnome-shell-extensions
sudo apt-get update
sudo apt-get install gnome-shell-extension-weather

Fedora

Packages for Fedora are available in the RPM Fusion repositories. If these are not enabled on your system, please install them through the following command:

sudo dnf install http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm

Then, install gnome-shell-extension-weather:

sudo dnf install gnome-shell-extension-weather

Arch Linux

Download the package from AUR, make and install it:

wget https://aur.archlinux.org/packages/gn/gnome-shell-extension-weather-git/gnome-shell-extension-weather-git.tar.gz
tar xvzf gnome-shell-extension-weather-git.tar.gz
cd gnome-shell-extension-weather-git && makepkg -si

Generic (Local installation)

Make sure you have the following dependencies installed:

Run the following commands:

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

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

Configuration

Launch gnome-shell-extension-prefs (reachable also through the Weather Settings button on the extension popup) and select Weather 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.

Debug

To debug the extension, active the switch Debug extension in the settings:

You have now two new file ("weather-extension.log" and "weather-extension-prefs.log") in your user cache dir (~/.cache/).

Licence

Copyright (C) 2011 - 2014

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

gnome-shell-extension-weather 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-weather 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-weather. If not, see http://www.gnu.org/licenses/.