Skip to content

Latest commit

 

History

History
148 lines (88 loc) · 6.62 KB

README.md

File metadata and controls

148 lines (88 loc) · 6.62 KB
Raw

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.

Screenshots

Screenshot

Installation

  • Arch Linux
  • Frugalware
  • Ubuntu
  • Generic: For a generic installation, run the following commands: ./autogen.sh --prefix=/usr && make && sudo make install
    • Make sure you have the libglib2.0-dev package (or equivalent for your distribution) installed, or else you'll get an error about GLIB_GSETTINGS.
  • Please report further links!

That's it!

Versions

Due to incompatible changes between GNOME 3.0 and 3.2, separate versions of this extension are provided:

  • For GNOME Shell 3.4, use the gnome3.4 branch.
  • For GNOME Shell 3.2, use the master branch.
  • For GNOME Shell 3.0, use the gnome3.0 branch.

Configuration

gnome-shell-extension-weather uses gsettings to save your configuration. You can use dconf-editor or gsettings from the command line to modify some parameters.

Location

At the moment, only WOEIDs consisting of 4 uppercase letters followed by 4 digits are supported. Determine your WOEID using edg3.co.uk or xoap.weather.com.

You can specify your location using the following command. Perhaps you need quotation marks as in the second command.

gsettings set org.gnome.shell.extensions.weather woeid your_woeid
gsettings set org.gnome.shell.extensions.weather woeid "'your_woeid'"

Temperature Units (optional, celsius by default)

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

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

Wind Speed Units (optional, kilometers per hour (km/h) by default)

You can modify the wind speed unit using one of the following commands:

gsettings set org.gnome.shell.extensions.weather wind-speed-unit kph
gsettings set org.gnome.shell.extensions.weather wind-speed-unit mph
gsettings set org.gnome.shell.extensions.weather wind-speed-unit m/s
gsettings set org.gnome.shell.extensions.weather wind-speed-unit knots

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:

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

Translate Weather Conditions (optional, true by default)

You may want to configure whether to translate the weather condition. If enabled, the condition is translated based on the weather code. If disabled, the condition string from Yahoo is taken. Note: Enabling the translation sometimes results in loss of accuracy, e.g., the condition string "PM Thunderstorms" cannot be expressed in terms of weather codes.

gsettings set org.gnome.shell.extensions.weather translate-condition true
gsettings set org.gnome.shell.extensions.weather translate-condition false

Show Sunrise / Sunset times (optional, false by default)

You may display today's Sunrise / Sunset times as retrieved from Yahoo! Weather in the current weather panel

gsettings set org.gnome.shell.extensions.weather show-sunrise-sunset true
gsettings set org.gnome.shell.extensions.weather show-sunrise-sunset false

Use Symbolic Icons (optional, false by default)

If desired, you can enable the usage of symbolic icons to display the weather condition (instead of full-colored icons).

gsettings set org.gnome.shell.extensions.weather use-symbolic-icons false
gsettings set org.gnome.shell.extensions.weather use-symbolic-icons true

Show Text in Panel (optional, true by default)

You can configure whether to show the weather condition text (aka. comment) together with the temperature in the panel (requires restart). If only weather condition text is undesired, consider show-comment-in-panel option.

gsettings set org.gnome.shell.extensions.weather show-text-in-panel true
gsettings set org.gnome.shell.extensions.weather show-text-in-panel false

Show Comment in Panel (optional, false by default)

Configures whether to show the comment (aka. weather condition text, e.g. "Windy", "Clear") in the panel. Note that the temperature is still shown (if undesired, consider show-text-in-panel option).

gsettings set org.gnome.shell.extensions.weather show-comment-in-panel false
gsettings set org.gnome.shell.extensions.weather show-comment-in-panel true

Position in Panel (optional, center by default)

The position of this GNOME Shell extension in the panel can be configured to either 'left', 'center' or 'right' (requires restart of GNOME Shell).

gsettings set org.gnome.shell.extensions.weather position-in-panel center
gsettings set org.gnome.shell.extensions.weather position-in-panel left
gsettings set org.gnome.shell.extensions.weather position-in-panel right

Refresh Interval (optional, 240 by default)

The interval to refresh the weather information may be set arbitrarily and is specified in seconds.

gsettings set org.gnome.shell.extensions.weather refresh-interval 240

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-2012 Ecyrbe ecyrbe+spam@gmail.com, Timur Kristóf venemo@msn.com, Elad Alfassa elad@fedoraproject.org, Simon Legner Simon.Legner@gmail.com, Simon Claessens gagalago@gmail.com, Mark Benjamin weather.gnome.Markie1@dfgh.net

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