spacemacs/layers/+tools/geolocation
2017-07-31 14:57:02 +03:00
..
extensions/theme-changer Bump year in copyright headers 2017-01-05 23:08:17 -05:00
img
config.el Bump year in copyright headers 2017-01-05 23:08:17 -05:00
extensions.el Bump year in copyright headers 2017-01-05 23:08:17 -05:00
funcs.el [show user error when location is not set in theme changer 2017-07-31 14:57:02 +03:00
packages.el fix geolocation layer on non-macos systems 2017-07-31 14:56:57 +03:00
README.org update geolocation readme 2017-07-31 14:57:00 +03:00

Geolocation layer

Description

This layer offers few location sensitive adjustment to Emacs, such as automatically switching between light (day) and dark (night) themes, weather forecast and on OS X, also automatic tracking of location, using OS X's CoreLocation services.

Supported packages in this layer

Install

To use this configuration layer, add it to your ~/.spacemacs. You will need to add geolocation to the existing dotspacemacs-configuration-layers list in this file.

All services are disable by default. To enable all, or some of them, add instead something like this:

  (geolocation :variables
               geolocation-enable-automatic-theme-changer t
               geolocation-enable-location-service t
               geolocation-enable-weather-forecast t)

Configuration

Location

Set location manually by setting the following variables to the dotspacemacs/user-config function of your dotfile:

  (setq calendar-location-name "Barcelona, Spain"
        calendar-latitude 41.23
        calendar-longitude 1.80)

osx-location

Mac users can take adavantage of automatic geogrphical discovery using the OS' CoreLocation system service, implemented as a long running background process. In order to enable it, set geolocation-enable-location-service to t as explained in installation instructions.

A helper script will need to be given proper access first time this layer is activated.

/TakeV/spacemacs/media/commit/24827b6f08ed19e5781cad13de7cc4b3c6bb1a32/layers/+tools/geolocation/img/emacs-location-helper.jpg

theme-changer

This layer implement a simple "theme changer" which, when enabled, will switch between first two themes the user has setup in dotspacemacs-themes. First theme listed will be used as light variant, while the second as the the dark. Other themes will be ignored by this layer, though they are still available for cycling, etc.

Note that theme-changer requires location to be set.

sunshine (weather forecast)

Sunshine display local weather forecast.

Setup OpenWeatherMap API key. Set sunshine-appid to some hash string from the openweathermap website. You need to sign up to the website to get a API key.

  (setq sunshine-appid "your-apikey")

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")

It will use the imperial unit system by default. To switch to metric, add sunshine-units 'metric to the variables list for this layer, or add this.

  (setq sunshine-units 'metric)

Weather forecast icons are disabled by default, and can be toggled by pressing `i' within this mode's main buffer.

To display weather forecast icons by default ("pretty mode"), add sunshine-show-icons t to the variables list for this layer, or add this:

  (setq sunshine-show-icons t)

/TakeV/spacemacs/media/commit/24827b6f08ed19e5781cad13de7cc4b3c6bb1a32/layers/+tools/geolocation/img/emacs-sunshine.jpg

Key Bindings

Weather

Evil Holy Command
SPC a w Display pretty weather forecast
SPC a W Display quick weather forecast in mini buffer