OpenWeatherWidget

Minimal weather widget for your desktop updates using the OpenWeatherMap API.

Status

⚠️ Work in progress - not ready for general use.

Configuration

The widget reads configuration from:

~/.config/candywidgets/openweathermap.toml

Example:

[general]
api_version = "free_2.5"    # Other APIs are WIP

[query_params]
api_key = "your_api_key_here" # Get a free API key from https://openweathermap.org
city_id = "your_city_id_here" # Find it in the url of your city at https://openweathermap.org/find?
units = "metric"
lang = "en"

⚠️ WIP - Full configuration format will be released later.

API

• Currently supports the Free API v2.5. Find details on OWM or Postman.
• One Call API 3.0 is free for up to 1000 API calls per day, but requires payment information for subscription.
• Support for student plan may be considered later.
• Support for One Call v3.0 may be considered later.

To-do

• TOML configuration file
• Fetch and parse current weather data from OWM
• Weather forecast query
• Complete library
• Complete configuration
• CLI args
• GUI - iced
• Icons
• Support One Call API 3.0

Low-probability To-do

• Historical weather query
• Weather maps