gnome-shell-extension-openweather/README.md

## gnome-shell-extension-weather

gnome-shell-extension-weather is a simple extension for displaying weather notifications in Gnome Shell.

Currently, the weather report including forecast for today and tomorrow is fetched from [Yahoo! Weather](http://weather.yahoo.com/).

### Screenshots

![Screenshot](https://github.com/simon04/gnome-shell-extension-weather/raw/master/data/screenshot.png)

And with French translation:  

![Screenshot](https://github.com/simon04/gnome-shell-extension-weather/raw/master/data/screenshot2.png)

### Installation

For installation, run the following commands:

```bash
./autogen.sh --prefix=/usr
make
sudo make install
```
  
That's it!

### Configuration

Gnome extension weather use gsettings to save your configuration. you can use dconf-editor or gsettings from the command line to modify some parameters

#### Location (cf. [WOEID](http://developer.yahoo.com/geo/geoplanet/guide/concepts.html))

You can specify your location buy using this command:

```bash
gsettings set org.gnome.shell.extensions.weather woeid your_woeid
```

#### Temperature units (optional, celsius by default)

You can modify the temperature unit with one of the following commands:

```bash
gsettings set org.gnome.shell.extensions.weather unit celsius
gsettings set org.gnome.shell.extensions.weather unit fahrenheit
```

#### Displayed location (optional)

Sometimes your WOEID location isn't quite right (it's the next major city around). To customise the displayed city you can type:

```bash
gsettings set org.gnome.shell.extensions.weather city your_city
```

### Restart Gnome-Shell

Don't forget to restart GNOME Shell:

1. Restart Gnome Shell (`[Alt]+[F2]`, `r`)
2. Fork this project as you like

### Licence

Copyright (C) 2011
Ecyrbe <ecyrbe+spam@gmail.com>,
Timur Kristóf <venemo@msn.com>,
Elad Alfassa <elad@fedoraproject.org>,
Simon Legner <Simon.Legner@gmail.com>

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/>.