Files changed (2)
-A simple command-line utility (and module) to determine your current location
, using Core Location, and optionally backing off to a web service.
-Doko is a Python clone of Victor Jalencas's `whereami <https://github.com/victor/whereami>`_ utility. It requires OS X 10.6 (Mountain Lion) or later to function.
+Doko is a clone of Victor Jalencas's `whereami <https://github.com/victor/whereami>`_ utility, but unlike whereami it supports multiple strategies for finding your location.
+However, on OS X 10.6 (Mountain Lion) or later, you can also use the much more accurate Core Location framework::
-On OS X 10.6 (Mountain Lion) or later, you can enable Core Location in System Preferences, in the "Security" or "Security & Privacy" section.
+Once you've installed the corelocation-enabled doko package, you'll need to enable Core Location in System Preferences, in the "Security" or "Security & Privacy" section. Furthermore, you must be using Wifi for it to work.
-However, it relies on using wifi, and being enabled. If you won't have a wifi connection, you may see this::
-In this case, you can back off to a much more approximate service based on your external IP with the ``--approx`` command::
+This will give its best guess as to your location, depending on the strategies that are available. Use the ``--show`` option to open the location in Google Maps.
-This may return the location for the center of the nearest city. To debug the location returned, the ``--show`` option will open a Google Maps browser window displaying the coordinates on a map.
+More fine-grained control over strategies used and the precision returned is available. See ``doko --help``.