An Emacs package for displaying the forecast from OpenWeatherMap.
Switch branches/tags
Nothing to show
Clone or download
aaronbieber Merge pull request #14 from peterlebrun/master
Update documentation re: api keys
Latest commit 8959dea Oct 29, 2018
Permalink
Failed to load latest commit information.
images Added screenshot to the README. Jan 25, 2015
README.md Update documentation re: api keys Oct 29, 2018
sunshine.el Update documentation re: api keys Oct 29, 2018

README.md

sunshine.el

MELPA

An Emacs package for displaying the forecast from OpenWeatherMap.

Screenshot

Installation and Configuration

  1. Copy sunshine.el somewhere in your Emacs load-path. To see what your load-path is, run inside emacs: C-h v load-path<RET>.

  2. Add the following to your .emacs file:

    (require 'sunshine)

  3. Configure your location by setting the variable sunshine-location. You can provide a string, like "New York, NY" or a ZIP code, like "90210". This variable is available through the Customize facility.

    When specifying a ZIP code, you may receive results from a foreign country. This is due to weird behavior from OpenWeatherMap. To resolve this, append a comma and the country code after the ZIP code. Note the lack of a space in the example below.

    (setq sunshine-location "90210,USA")

  4. Set the variable sunshine-appid. You need to create a free OpenWeatherMap account. Your api key will be available at https://home.openweathermap.org/api_keys (URL requires login).

    (setq sunshine-appid "API-KEY-HERE")

A few other configuration options are available, see the configuration group called sunshine.

Usage

To display the forecast for your location, call sunshine-forecast.

Two key mappings are available within the forecast window:

  • q - Kill the Sunshine buffer and close the window.
  • i - Toggle the display of forecast icons (only available in GUI Emacs, of course)

If you are using a GUI Emacs, you may like to display the weather forecast icons by default. To do so, set sunshine-show-icons to t.

License

This program is not part of GNU Emacs.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

This file is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.