README
cinnamon-weather
Adaptation of Gnome Shell's weather extension for the Cinnamon desktop.
cinnamon-weather uses Semantic Versioning. For the current version number, see metadata.json.
Setup
The applet obtains the location automatically, see below what the weather providers offer and how to obtain API keys if your chosen weather provider needs one.
In Manual Location mode the applet either accepts:
- Coordinates in Latitude, Longitude format (e.g. 37.77,122.41). You can use OpenWeatherMap's finder and paste the coordinates in from there.
- or an Address (it can be just a city and country, it is pretty flexible). After 3 seconds, the applet will replace what you entered with the full address what it finds so you can verify if it's correct. You can also get your exact address to enter from OpenStreetMap's Nominatim search, that's what the applet uses as well.
You can also save locations what you entered manually and switch between them in the applet (arrows will appear on both sides of the location in the applet if you have more than two saved).
Weather providers to choose from
| Weather Providers | Needs API key | Maximum Forecast Days | Maximum Forecast Hours | Other information |
|---|---|---|---|---|
| OpenWeatherMap | No | 8 | 48 | Default provider |
| MET Norway | No | 10 | 48 | -- |
| DMI Denmark | No | 10 | 48 | -- |
| Deutscher Wetterdienst | No | 10 | 240 | -- |
| Met Office UK | No | 5 | 36 | -- |
| US National Weather | No | 7 | 156 | -- |
| WeatherBit | Yes | 16 | 0** | -- |
| Visual Crossing | Yes | 15 | 336 | -- |
| Tomorrow.io | Yes | 15 | 108 | Previously known as Climacell |
| DarkSky | Yes | 8 | 168 | Signups closed, will end Q2 2023 |
| AccuWeather | Yes | 5*** | 12 | Limited free calls |
OpenWeatherMap
Worldwide Online Weather service by OpenWeather Ltd founded in 2012 with headquaters in London UK. OpenWeatherMap Website. Read more about the service here.
- This is the default provider that works out of the box. Big Thanks to them supporting free open source projects, like this!
MET Norway
Free meteorological data and forecasts from the Norwegian Meteorological Institute founded in 1866. MET Norway Website. Read more about the institure here.
- Current weather is shown for the next hour, and the daily forecasts are generated from 6 hour forecasts, so there is a possibility that they are inaccurate sometimes.
DMI Denmark
The Danish Meteorological Institute formed in 1872 and makes weather forecasts and observations for Denmark, Greenland, and the Faroe Islands. DMI Denmark Website Read more about the institure here.
- The service is global with open weather data.
Deutscher Wetterdienst
German National Weather Provider. Deutsche Wetterdienst Website. Read more about the institure here.
- Only covers Germany.
Met Office UK
The Meteorological Office, abbreviated as the Met Office, is the UK's national weather service founded in 1854. Met Office UK Website. Read more about the agency here.
-
Sometimes it takes like 5-10 seconds to obtain weather, please be patient when it loads up the first time.
-
Only covers the UK
- It uses the nearest forecast site and observation sites in an 50km area, it displays an error if it does not find any. Please open a new issue if this happens and you live in the UK! (There are much less observation sites than forecast sites.)
US National Weather
The National Weather Service in the USA is a federal government agency formed in 1861. US National Weather Website. Read more about the agency here.
-
Sometimes it takes 10-15 seconds to obtain weather, please be patient when it loads up the first time.
-
Only covers the US
- Observations are quite spotty so it combines multiple observation stations if needed in a 50km area.
Weatherbit.io
Historical and Forecast Weather data service provided by Weatherbit LLC in the USA. Weatherbit.io Website. Read more about the service here.
-
To get an API key, go to Weatherbit.io and create an account. Then go your Dashboard where you should find your secret key already created.
-
At least 10 minutes as refresh rate is recommended, since otherwise you might exceed you daily quota, the Free API subscription is limited to 500 calls per day.
- **Hourly Weather forecast requires a non-free account
Visual Crossing
Weather service from Visual Crossing Corporation founded in 2003 with headquarters in USA and Germany. Visual Crossing Website. Read more about the service here.
-
Needs an API key, you can Sign Up here and grab one
- Provides 1000 Free calls a day
Tomorrow.io
Meteorological data from American weather technology company with headquarters in Boston since 2016. Changed name from Climacell to Tomorrow.io in March 2021. Tomorrow.io Website. Read more about the company here.
-
Please note that old ClimacellV4 keys are not working anymore. You need to re-register and get a new key.
- API key can be obtained here. Register and the API key will be shown in the Develpment section. Free plan comes with 1000 free calls per day.
DarkSky
Online Service started by The Dark Sky Company founded 2012 in the US that specializes in weather forecasting and visualization. DarkSky Website. DarkSky was acquired by Apple in 2020. Read more about the company in the early days archived here.
- The service does not allow new signups and will continue to function until March 31st, 2023.
AccuWeather
Online Service from company AccuWeather Inc, founded in 1962 with headquarters in the US, provides a global weather source. AccuWeather Website. Read more about the company here
-
With the free plan, there are only a very limited number of calls for a day, which will be displayed in the applet menu. Please lower your Update interval setting in Configuration or you may run out of calls and then the service will stop with an error message until the next day.
-
***Number of available hours and days are specified for the free plan, paid plans allow more.
- API keys can be obtained here. Register, then you must add a new App. When it's created Click on the App and the key will be displayed.
Usage of "Override label on panel" setting
The setting allows you to make the applet display basically anything in the form of text in the panel. In addition, it exposes a number of values for you to use as you like, these will be replaced with actual data values. The full text-to-value mapping can be found below.
| Text to enter | Mapped value |
|---|---|
{t} |
Temperature value |
{u} |
Temperature unit |
{c} |
Short condition text |
{c_long} |
Long condition text (same as short if not available) |
{dew_point} |
Dew point value |
{humidity} |
Humidity value (always as percent) |
{pressure} |
Pressure value |
{pressure_unit} |
Pressure unit |
{extra_value} |
API specific value (usually "Feels Like" or "Cloudiness") |
{extra_name} |
API specific value's name |
{wind_speed} |
Wind speed with unit |
{wind_dir} |
Wind direction in text format (NW, etc) |
Versions
Versions are automatically selected based on you Cinnamon's version
Configuration
Right-click to access cinnamon-settings -> Applets -> Configure.
Mailing list
http://groups.google.com/group/cinnamon-weather
Future Plans
- Add special formatting options (like padded temperature) for values in panel in the "Override label on panel" setting
Language Translations
If you want to update or change the translation in your language other than English, here are some steps to get you started. Keep in mind that your local changes will be overwritten when an update of the applets language is installed. Feel free to share your translation, which is very much appreciated, by making a PR (pull request) on Github or contact the current maintainer of the applet.
-
Install the translation editor poedit with your package manager and download your language PO file e. g. xx.po where xx is your ISO language code, and the template POT file weather@mockturtl.pot from the files/weather@mockturtl/po/ sub directory on the Github website
-
Start poedit and open your downloaded PO file xx.po, then go to menu Catalogue or Translate depending on version, choose "Update from POT file…" and open the POT file weather@mockturtl.pot. Start your editing and try to use previously contributed translations as much as possible and get familiar with the correct technical weather terms for things in your language.
- When done translating, click on Validate and Save. This creates a new MO file that you can use locally in your system by overwriting the file ~/.local/share/locale/xx/LC_MESSAGES/weather@mockturtl.mo and restart your system to check how your translation works.
Known Issues
-
Hourly forecast toggle button is not centered to the middle of the popup menu
-
Sunset/Sunrise is not displayed correctly if there is a mismatch between the Location Timezone and System Timezone when using Manual Location with some of the weather providers
- DarkSky verbose conditions are only in cm/Celsius or in/Fahrenheit
Report a new issue
You need a Github login to make a issue report. Please first check if the issue already is reported here. You will find more information about reporting in the Configuration under the Help Tab, accessible by right clicking on the applet. Here you can save logs to file with debug level that is much appreciated. By using the Submit an Issue Button under this Tab, useful system information will be generated for your report form in your default web browser at Github.com.
Troubleshooting
Enabling debug mode
You can enable debug mode for more logging by creating a file named DEBUG in the folder of the applet here: ~/.local/share/cinnamon/applets/weather@mockturtl/, then restart Cinnamon.
See the logs producing by applets
You can see Logs by opening the Cinnamon 'Looking Glass' debugger. You can open it by Right Clicking on your Panel (taskbar), then Troubleshoot->Looking Glass
Logs can be found under the Log Tab.
Log In To Comment!
338 Comments