Important
OpenWeatherMap ended the OneCall 2.5 API in middle of September 2024 and because of that the UV radiation data is no longer available for those users with free accounts registered before the obligatory "upgrade" to OneCall 3.0 API.
From now on the releases of TrayWeather will have the UV data tab, tooltip and current weather UV radiation value removed. TrayWeather will continue to work with the rest of the working API (for now) and bugs will be fixed.
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. The tray icon tooltip shows the location, weather description and temperature. The tray menu provides access to the weather 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 OpenWeatherMap and maps are from OpenWeatherMap and Google. To obtain weather information from 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).
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 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 you need to grant usage by the system to run it.
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 and are missing tabs present in the latest version.
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. It shows the detected location properties and the options to change the frequency of updates and temperature units. The OpenWeatherMap API Key must be entered here. If the location is better guessed with the DNS IP instead of the IP given by the provider the option can be enabled here. 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 tray and application theme configuration can be found here in the miscellaneous options. Also the frequency of checks for updates can be set here.
Configuration dialog in English with the application light theme.
Configuration dialog in English with the application dark 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 OpenWeatherMap Geocoding API.
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 third 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.
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
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 403 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.30.2
Status: finished.
cloc statistics
| Language | files | blank | comment | code |
|---|---|---|---|---|
| C++ | 10 | 1055 | 420 | 5120 |
| C/C++ Header | 10 | 296 | 873 | 971 |
| HTML | 1 | 33 | 0 | 152 |
| CMake | 1 | 19 | 11 | 125 |
| Total | 22 | 1403 | 1304 | 6368 |