* 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!
That's it!
### Versions
### Versions
Due to incompatible changes between GNOME 3.0 and 3.2, separate versions of this extension are provided:
Only for GNOME Shell 3.2 (not tested under GNOME Shell 3.0)
* For GNOME Shell 3.2, use the `master` branch.
* For GNOME Shell 3.0, use the `gnome3.0` branch.
----
----
### Configuration
### 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.
Use the `Weather Settings` button to edit the configuration.
You can also use `dconf-editor` or `gsettings` to modify some parameters from the command line.
#### Location ("Cambridge, MA" (GNOME Foundation) by default)
#### City (`Cambridge, MA` (GNOME Foundation) by default)
You can specify your location using the following command. Perhaps you need quotation marks as in the second command.
You can specify your location using the following command. Perhaps you need quotation marks as in the second command.
@ -52,6 +51,14 @@ 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 celsius
gsettings set org.gnome.shell.extensions.weather unit fahrenheit
gsettings set org.gnome.shell.extensions.weather unit fahrenheit
#### 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
#### Translate Weather Conditions (optional, true by default)
#### 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.
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.
@ -59,12 +66,12 @@ You may want to configure whether to translate the weather condition. If enabled
gsettings set org.gnome.shell.extensions.weather translate-condition true
gsettings set org.gnome.shell.extensions.weather translate-condition true
gsettings set org.gnome.shell.extensions.weather translate-condition false
gsettings set org.gnome.shell.extensions.weather translate-condition false
#### Use Symbolic Icons (optional, true by default)
#### Symbolic Icons (optional, true by default)
If desired, you can enable the usage of symbolic icons to display the weather condition (instead of full-colored icons).
If desired, you can enable the usage of full-colored icons to display the weather condition (instead of symbolic icons).
gsettings set org.gnome.shell.extensions.weather use-symbolic-icons false
gsettings set org.gnome.shell.extensions.weather use-symbolic-icons true
gsettings set org.gnome.shell.extensions.weather use-symbolic-icons true
gsettings set org.gnome.shell.extensions.weather use-symbolic-icons false
#### Show Text in Panel (optional, true by default)
#### Show Text in Panel (optional, true by default)
@ -73,21 +80,13 @@ You can configure whether to show the weather condition text (aka. comment) toge
gsettings set org.gnome.shell.extensions.weather show-text-in-panel true
gsettings set org.gnome.shell.extensions.weather show-text-in-panel true
gsettings set org.gnome.shell.extensions.weather show-text-in-panel false
gsettings set org.gnome.shell.extensions.weather show-text-in-panel false
#### Show Comment in Panel (optional, false by default)
#### Include condition (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).
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 false
gsettings set org.gnome.shell.extensions.weather show-comment-in-panel true
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, 300 by default)
#### Refresh Interval (optional, 300 by default)
The interval to refresh the weather information may be set arbitrarily and is specified in seconds.
The interval to refresh the weather information may be set arbitrarily and is specified in seconds.
@ -111,6 +110,7 @@ Timur Kristóf <venemo@msn.com>,
Elad Alfassa <elad@fedoraproject.org>,
Elad Alfassa <elad@fedoraproject.org>,
Simon Legner <Simon.Legner@gmail.com>,
Simon Legner <Simon.Legner@gmail.com>,
Simon Claessens <gagalago@gmail.com>
Simon Claessens <gagalago@gmail.com>
Christian METZLER <neroth@xeked.com>
This file is part of gnome-shell-extension-weather.
This file is part of gnome-shell-extension-weather.