WeatherWidget Manual

WeatherWidget is a compact, native desktop weather utility built in Go. It floats as a transparent overlay on your desktop, showing real-time weather and local time for up to 5 cities simultaneously. All configuration is managed through the built-in Settings UI, accessible from the system tray.

WeatherWidget runs in the system tray (notification area). Right-click the tray icon to access the context menu with the following options:

System Tray Context Menu

WeatherWidget is available through two distribution channels. Choose the one that fits your platform.

The Appearance tab controls how and where the weather widget is displayed on your desktop. Configure the widget's position, monitor selection, transparency, temperature unit, and startup behaviour.

WeatherWidget Settings — Appearance

Configure the weather data source, your API key, and how frequently the widget refreshes weather data. WeatherWidget supports two provider modes: the free OpenWeatherMap API and the premium EasyWeatherWidget Pro API.

WeatherWidget Settings — Data Provider & API Key

Manage the cities you want to track. You can add up to 5 cities and reorder them to control the display sequence on the weather overlay. Each city entry includes name, region, coordinates, and timezone.

WeatherWidget Settings — Locations

Saved Cities

The saved cities list shows all currently tracked locations. Each entry displays its position number, city name, and region code. Use the ↑ ↓ arrows to reorder cities and the Remove button to delete a city from the list.

Add New City

Choose your preferred interface language. WeatherWidget supports 9 languages. The selected language affects all labels, descriptions, and weather condition text displayed in the widget and settings window.

WeatherWidget Settings — Language

The About tab displays application version information, license details, and links to the project resources. Use this tab to verify which version you are running and access support channels.

All configuration is stored locally in a single JSON file. No cloud dependencies — your data stays on your machine.

Windows

Linux

The configuration file contains all widget settings. While it's recommended to use the Settings UI, advanced users can edit this file directly.

{
  "dataSource": "remote_api",
  "cities": [
    {
      "name": "Holambra",
      "region": "BR",
      "latitude": -22.6332,
      "longitude": -47.0545,
      "timezone": "America/Sao_Paulo"
    },
    {
      "name": "Edinburgh",
      "region": "UK",
      "latitude": 55.95,
      "longitude": -3.19,
      "timezone": "Europe/London"
    },
    {
      "name": "Warsaw",
      "region": "PL",
      "latitude": 52.231958,
      "longitude": 21.006725,
      "timezone": "Europe/Warsaw"
    }
  ],
  "refreshInterval": 10,
  "cornerPosition": "top-right",
  "monitorIndex": 0,
  "opacity": 25,
  "locale": "en-GB",
  "apiConfig": {
    "provider": "openweathermap",
    "apiKey": "YOUR_API_KEY"
  }
}

Common issues and their solutions.

At-a-glance summary of key values and limits.