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 with Pro (or up to 3 cities on the Free tier). 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.

Windows Start Menu — Quick Launch Search

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 & Layout

The Data Display settings tab allows you to customize the overlay panel layout. Toggle individual data fields on or off to choose exactly which weather metrics, atmospheric conditions, and real-time clock elements are visible on your desktop.

WeatherWidget Settings — Selectable Data Elements

Configure your weather data source, enter your API credentials, and set how frequently the widget refreshes meteorological data. Selecting and saving a valid provider in this tab is also what unlocks city editing in the Locations tab.

WeatherWidget Settings — Data Provider & API Key

Available Provider Modes

Pro vs Free Comparison

Data Provider Settings Reference

Manage the cities you want to track. You can track up to 5 cities with Pro (or up to 3 cities on the Free tier) 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.

WeatherWidget Settings — About & Application Info

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.