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>

Back to top

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)"

Back to top

Start / stop the widget

1. Start the widget

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

Back to top

2. Stop the widget

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

Back to top

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

Back to top

Wiki

For detailed documentation, please visit the wiki page.

Back to top

Example Themes

Click here to see the available example themes!

Back to top