https://github.com/purcell/osx-location

Make Emacs watch and respond to changes in geographical location on OS X
https://github.com/purcell/osx-location

Last synced: about 2 months ago
JSON representation

Make Emacs watch and respond to changes in geographical location on OS X

• Host: GitHub
• URL: https://github.com/purcell/osx-location
• Owner: purcell
• Created: 2012-11-16T20:46:45.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2024-11-06T20:36:18.000Z (3 months ago)
• Last Synced: 2024-11-06T21:34:18.753Z (3 months ago)
• Language: Emacs Lisp
• Homepage:
• Size: 15.6 KB
• Stars: 20
• Watchers: 5
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        
[![Melpa Status](http://melpa.org/packages/osx-location-badge.svg)](http://melpa.org/#/osx-location)

[![Melpa Stable Status](http://stable.melpa.org/packages/osx-location-badge.svg)](http://stable.melpa.org/#/osx-location)



osx-location.el

===============

This library uses OS X CoreLocation services to put useful

information into variables `osx-location-latitude` and

`osx-location-longitude`.

Installation

=============

If you choose not to use one of the convenient packages in

[MELPA][melpa], you'll need to add the

directory containing `osx-location.el` and `EmacsLocationHelper` to

your `load-path`, and then `(require 'osx-location)`.

If you don't trust the required bundled executable

(`EmacsLocationHelper`) which does the communication with

CoreServices, you can build it yourself from the

[instructions here](https://gist.github.com/1416248) or using the

bundled `Makefile`.

Usage

=====

Start monitoring the location asynchronously like this:

     M-x osx-location-watch

To add code which responds to location changes, use

`osx-location-changed-hook`.  For example, you might add a hook

function which updates `calendar-latitude` and `calendar-longitude`

(defined in the built-in library `solar`), and then use

[rase.el](https://github.com/m00natic/rase) to execute code

automatically at sunrise or sunset.

Hook functions take no arguments; when your hook function runs, it can

use the freshly-updated values of `osx-location-latitude` and

`osx-location-longitude`.

Here's an example:

```el

(eval-after-load 'osx-location

  '(when (eq system-type 'darwin)

     (add-hook 'osx-location-changed-hook

               (lambda ()

                 (setq calendar-latitude osx-location-latitude

                       calendar-longitude osx-location-longitude

                       calendar-location-name (format "%s, %s" osx-location-latitude osx-location-longitude))))))

```

[melpa]: http://melpa.org



[💝 Support this project and my other Open Source work](https://www.patreon.com/sanityinc)

[💼 LinkedIn profile](https://uk.linkedin.com/in/stevepurcell)

[✍ sanityinc.com](http://www.sanityinc.com/)