Tray Weather is a simple application to retrieve and show weather information for a given geographic location in a small dialog and in the Windows OS system tray. When executed the application sits in the system tray, showing the current weather icon and/or temperature. The tray menu provides access to the weather conditions and configuration dialogs. If there is a network error and the information cannot be retrieved the tray icon will inform of the error and show the error icon.
The computer location can be automatically obtained by using the services of http://ip-api.com/ or entered manually by specifying latitude and longitude coordinates. The weather information are obtained from a weather data provider.
You can select one the following data providers in the condifuration dialog:
Not all them provide the same data:
| Name | Weather forecast | Pollution forecast | UV index forecast | Weather alerts | Geolocation | Maps | Requires API key |
|---|---|---|---|---|---|---|---|
| OpenWeatherMap | ✔️ | ✔️ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ |
| Open-Meteo | ✔️ | ✔️ | ✔️ | ❌ | ✔️ | ❌ | ❌ |
To obtain weather information from providers that require a registration, like OpenWeatherMap, you need to register in their website and enter the given API Key into the Tray Weather configuration dialog (currently only the free plan is supported).
If you want a provider to be added you can ask for it in the Discussions page. The only requirements are to be free and to provide a REST API.
NOTE: Please note that after you register in OpenWeatherMap and are given an API key, that key may not be valid right away. If you enter the API key in TrayWeather and get an "host requires authentication" error, you must wait a little longer until it becomes valid.
The temperature units (Celsius or Fahrenheit) and the frequency of update requests are some of the configurable options. Other visual configuration options can be seen in the configuration dialog screenshot.
From version 5.6 onwards the WebKit module has been replaced by a new Chromium-based equivalent that doesn't compile on Mingw. In addition to that, the QtCharts module is only officially available in Qt from versions 5.6 onwards. So the easiest way to compile the application is to use the 5.5.1 release of Qt and, separately, compile and add to the project the QtCharts module from GitHub.
The following libraries are required:
- Qt 5.5.1 opensource framework compiled with SSL support.
- Qt Charts 2.1.0 submodule.
Download the latest installer or zip file (portable mode).
Neither the application or the installer are digitally signed so the system will ask for approval before running it the first time.
NOTE: The application will use a ini file in the same folder as the executable if the file exists and can be written. So its possible to use the application in "portable mode" even if it has been installed using the installer by just copying the installation folder to another location and creating an empty TrayWeather.ini file in it. It is recommended to execute the application before creating the empty file because then the setting will be loaded from the windows registry and saved to the ini file.
NOTE: Some screenshots are from older versions of Tray Weather. The tabs the appear in the main dialog depend on the data that the selected weather provider can supply.
Tray icon showing the current weather icon. At night and on clear sky days it shows the current moon phase as the weather icon.
Tray icon can also show the temperature alone or composed with the weather icon. It can also be configured to show two tray icons, one with the temperature and other with the weather icon. The temperature text color can be set by the user or can change dynamically between a range of colors according to the current value. Temperature icon color, size and composition can be modified in the configuration dialog.
Several different icon themes are available for the application weather icons. The color of the mono-color themes can be selected by the user.
Configuration dialog. The providers can be selected here and, if the selected provider requires configuration, the API key can be entered and tested. The geographic location coordinates can be entered manually or detected by the geo-location. If the selected provider has Geo-Location you can search for a location coordinates by entering its name. A 'roaming' mode can be enabled, where the geographical coordinates are requested before any weather data request, so the weather information is up to date even if the computer location is moving. Roaming mode can only be enabled if the geolocation services are being used.
The rest of the available options are self-explanatory.
Configuration dialog in English with the application light theme.
In the configuration dialog the location can be specified manually by coordinates, automatically using IP GeoLocation or can be selected by using the 'Find' dialog.
Location coordinates search dialog. Searches by location name using the provider Geolocation.
Weather dialog, showing the current weather tab.
Weather forecast for the next days. If the user puts the mouse over a point in the temperature line or a bar a tooltip will provide the weather conditions for that day and hour. Background is colored to day/night according to sunrise/sunset values for the day. The graph can be zoomed by selecting the area to zoom with the mouse and reset to the initial state by using the reset button below the graph. Data series can be hidden and shown again by clicking on its legend text below the graph.
Pollution forecast can be obtained in the Pollution tab, showing the projections for the next days. The chart can be zoomed in the X axis and reset by using the reset button below. The pollution chart also has a tooltip with detailed information for each point of the lines and the background is colored according to air quality value. As with the weather forecast it can be zoomed in and graph series can be hidden and shown again in the same way.
Ultraviolet radiation index forecast can be obtained from de UV tab, showing the forecast for the next days. As the other charts it can be zoomed and reset. The tooltip of each points gives the UV index and the recommendation for it.
Weather maps are interactive. While initially the map is centered in the detected location it can be moved and zoomed in and out. The maps consumes much more memory than the rest of the application so the user can be disable them using the button below.
Available maps:
- OpenStreetMap.
- Google Maps (roadmaps).
- Google Hybrid (Satellite images & roadmaps).
Tray Weather is available in:
- English
- Spanish
- Russian
- German
- French
- Chinese (Simplified)
- Portuguese (Brazilian)
- Ukrainian
- Slovenian
- Korean
- Polish
- Turkish
- Italian
If 'TrayWeather' hasn't a translation for your language you can collaborate and translate the application using the Qt Linguistic Tools (available here) or manually editing the 'empty' translation source file and making a pull request. Currently it's just 461 texts.
To do it manually just edit the 'empty translation' file in the 'languages' directory (empty.ts) and replace the untranslated messages, for example:
<message>
<location filename="../AboutDialog.ui" line="429"/>
<source>Weather data provided by</source>
<translation type="unfinished"></translation>
</message>
To the translation in your language. For example in Spanish it is:
<message>
<location filename="../AboutDialog.ui" line="429"/>
<source>Weather data provided by</source>
<translation>Datos meteorológicos proporcionados por</translation>
</message>
Version: 1.31.0
Status: finished.
cloc statistics
| Language | files | blank | comment | code |
|---|---|---|---|---|
| C++ | 12 | 1292 | 505 | 6340 |
| C/C++ Header | 12 | 404 | 1193 | 1237 |
| HTML | 1 | 33 | 0 | 152 |
| CMake | 1 | 19 | 12 | 129 |
| Total | 26 | 1748 | 1710 | 7858 |