Conky widget with clock and current weather report

This widget uses openweathermap.org API, to get weather information.
Easy to customize, supports appearance on light and dark backgrounds. (See: Example Themes).
Supports 12 and 24-hour clock format.

Dark text with light background	Light text with dark background

A list of successful tests can be found here.

Get the OpenWeatherMap API key

Go to the openweathermap.org/users/sign_up page and create your account.
After the registration, you should receive your API key via e-mail.
For easier installation, export this API key before running the script below:
```
export OPENWEATHER_API_KEY=<YOUR-API-KEY>
```

Installation

You can install it via the command-line with either wget or curl:

... via wget:

bash -c "$(wget --no-check-certificate --no-cache --no-cookies -O- https://raw.githubusercontent.com/takattila/Clock-With-Weather-Conky/v1.0.0/scripts/install.sh)"

... via curl:

bash -c "$(curl -fsSLk https://raw.githubusercontent.com/takattila/Clock-With-Weather-Conky/v1.0.0/scripts/install.sh)"

Start / stop the widget

1. Start the widget

bash ~/.conky/Clock-With-Weather-Conky/scripts/start.sh <YOUR-API-KEY>

2. Stop the widget

bash ~/.conky/Clock-With-Weather-Conky/scripts/stop.sh

Change settings after installation

bash ~/.conky/Clock-With-Weather-Conky/scripts/setup.sh

Use the above command to change the following settings:

city
country code
language code
temperature unit:
1. metric (for displaying Celsius)
2. imperial (for displaying Fahrenheit)
theme number
hour format (12 or 24)
window alignment and position

Wiki

For detailed documentation, please visit the wiki page.

Example Themes

Click here to see the available example themes!

takattila / Clock-With-Weather-Conky

readme