whereami

by victor

victor / whereami

get your location from the command line

208 Stars 24 Forks Last release: almost 6 years ago (v1.0) MIT License 19 Commits 1 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Build Status

So what is it?

whereami
is a simple command-line utility that outputs your geographical coordinates, as determined by Core Location, which uses nearby WiFi networks with known positions to pinpoint your location. It prints them to the standard output in an easy to parse format, in good UNIX fashion.

Requirements

This version of

whereami
only works in versions of Mac OS X 10.9 (Mavericks) or greater; as it is implemented in Swift. Why in Swift? Well, mostly because the command-line parsing libraries I could find in Objective-C where either a nuisance to install (because of lack of CocoaPods support) or required a lot of code to configure the options I need. On the other hand, SwiftCLI makes it really easy.

To build it, you will require Xcode 6.1 and optionally

xctool
. You can build it from the command line using either
xcodebuild
or
xctool
, whichever you like best. Both should work equally well, but
xctool
’s output is fancier. You can install
xctool
using homebrew.

INSTALLATION

whereami
comes with batteries included. You just need to clone the project to your local machine, switch to the swift branch, init the submodules, and install it using
xcodebuild
/
xctool
. In the near future, I will make that branch the main one, but not just yet.
$ git clone https://github.com/victor/whereami.git whereami
$ cd whereami
$ git checkout swift
$ git submodule update --init --recursive
$ xctool install

USAGE

Once

whereami
is installed, you can just invoke it to output your location:
$ whereami
41.386905825791,2.14425782089087

This is the default format, the tersest. You can also make it output JSON:

$ whereami --format json
{"latitude":41.386905825791, "longitude": 2.14425782089087}

Or even output in sexagesimal form:

$ whereami --format sexagesimal
41° 23′ 12.8609728477426″, 2° 8′ 39.3281552071449″

Apart from these options, the standard

--version
and
--help
options are recognized.

CONTRIBUTING

Please see CONTRIBUTING.md for details.

LICENSE

This code is released under the MIT license. Check the file LICENSE for details.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.