doko /

Filename Size Date modified Message
doko
63 B
731 B
1.8 KB
1.2 KB
38 B
923 B

doko (どこ)

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 utility. It requires OS X 10.6 (Mountain Lion) or later to function.

Kudos to Richo Healey for getting me started.

Installing

$ pip install doko

Enabling Core Location

On OS X 10.6 (Mountain Lion) or later, you can enable Core Location in System Preferences, in the "Security" or "Security & Privacy" section.

Hacking

For hacking on OSX, you will likely want to install requires-corelocation.txt as well as requires.txt.

Using on the command-line

Using Core Services alone, you can just run the doko command:

$ doko
35.674851 139.701419

However, it relies on using wifi, and being enabled. If you won't have a wifi connection, you may see this:

$ doko
location could not be found -- is wifi enabled?

In this case, you can back off to a much more approximate service based on your external IP with the --approx command:

$ doko --approx
35.674 139.701

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.

Using as a module

> import doko
> doko.location()
Location(latitude=35.674851, longitude=139.701419)
> doko.geobytes_location()  # approximate method
Location(latitude=35.674, longitude=139.701)

Changelog

0.1.0

  • Fetch latitude and longitude using Core Location
  • Provide backup method via GeoBytes page
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.