Locator
=======

Automatically set your Mac's location based on the currently-joined SSID, or
the ability to resolve one or more hostnames.

locator works by running as a LaunchAgent, and waking up every time your
computer's network interface(s) change state in some way. It runs through each
configured location detection snippet, and determines what Location to select.
It sets your Mac's Location to the most appropriate choice, or to "Automatic"
if nothing matched.


Installation
------------

   1. Clone locator
   2. Run INSTALL.sh (creates ~/Library/LaunchAgents/com.github.nwatkiss.locator.plist)
   3. Start locator: reboot or launchctl load ~/Library/LaunchAgents/com.github.nwatkiss.locator.plist
   4. Add one or more Location snippets (see below)


Configuration
-------------

Locations are configured by creating subdirectories under the locations/
directory in the distribution. For example, if you want Locator to switch your
Mac's Location to "Work" based on some criteria, you should create a directory
called "Work":

   locator/locations/Work

Inside each Location directory, locator looks for two files:

   - SSID: contains wireless SSIDs, one per line. If the Mac is
     currently connected to one of these SSIDs, locator will select this
     location.

   - DNS: each line contains DNS names to resolve, and either '*' if the
     address does not matter (a successful resolution is all that matters) or
     an IP address. If any of the listed names resolve to one of the listed
     IPs (or '*'), locator will select this location.


Author
======

Neil Watkiss <neil.watkiss@gmail.com>

Copyright (C) 2011, Neil Watkiss.

All Rights Reserved. This package is free software. It may be used,
redistributed, and/or modified under the same terms as Perl.

(see http://dev.perl.org/licenses/artistic.html)