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 | Required Packages |
|---|---|---|---|---|
| OpenWeatherMap | No | 8 | 48 | -- |
| MET Norway | No | 10 | 48 | -- |
| DMI Denmark | No | 10 | 48 | -- |
| Met Office UK | No | 5 | 36 | -- |
| US National Weather | No | 7 | 156 | -- |
| WeatherBit | Yes | 16 | 0** | -- |
| Visual Crossing | Yes | 15 | 336 | -- |
| ClimacellV4 | Yes | 15 | 108 | -- |
| DarkSky | Yes* | 8 | 168 | -- |
OpenWeatherMap
Worldwide Online Weather service by OpenWeather Ltd founded in 2012 with headquaters in London UK. OpenWeatherMap Website
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
- 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
- The service is global with open weather data.
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
-
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
-
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
-
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
-
Needs an API key, you can Sign Up here and grab one
- Provides 1000 Free calls a day
Tomorrow.io (ClimacellV4)
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
-
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 from The Dark Sky Company in the US that specializes in weather forecasting and visualization. DarkSky Website
- DarkSky has been acquired by Apple as of March 31, 2020. It does not allow new signups and it will cease to function at the end of 2022.
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
- None at the moment, I can take requests for provider integrations or for new features
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 (Yahoo, for example)
- DarkSky verbose conditions are only in cm/Celsius or in/Fahrenheit
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!
311 Comments