Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fulldecent/corelocationcli
Command line program to print location information from CoreLocation
https://github.com/fulldecent/corelocationcli
application corelocation gps gps-location gps-tracker gps-tracking location location-services swift
Last synced: 3 days ago
JSON representation
Command line program to print location information from CoreLocation
- Host: GitHub
- URL: https://github.com/fulldecent/corelocationcli
- Owner: fulldecent
- License: mit
- Created: 2014-08-27T00:40:41.000Z (over 10 years ago)
- Default Branch: main
- Last Pushed: 2024-11-15T21:00:34.000Z (2 months ago)
- Last Synced: 2025-01-17T22:06:41.580Z (11 days ago)
- Topics: application, corelocation, gps, gps-location, gps-tracker, gps-tracking, location, location-services, swift
- Language: Swift
- Size: 77.1 KB
- Stars: 221
- Watchers: 9
- Forks: 29
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- open-source-mac-os-apps - CoreLocationCLI - Get the physical location of your device and prints it to standard output ![swift_icon] (Applications / Utilities)
- open-source-mac-os-apps - CoreLocationCLI - Get the physical location of your device and prints it to standard output ![swift_icon] (Applications / Utilities)
- awesome-swift-macos-apps - CoreLocationCLI - Get the physical location of your device and prints it to standard output (Utilities / Text)
- awesome-swift-macos-apps - CoreLocationCLI - Get the physical location of your device and prints it to standard output (Utilities / Text)
README
# CoreLocationCLI
CoreLocationCLI gets the physical location of your device and prints it to standard output. If you move it can also print your updated location. *Kill it with CTRL-C.*
Note for Mac users: make sure Wi-Fi is turned on. Otherwise you will see `kCLErrorDomain error 0`.
## Usage
```sh
CoreLocationCLI --help
CoreLocationCLI [--watch] [--verbose] [--format FORMAT]
CoreLocationCLI [--watch] [--verbose] --json
```
| Switch | Description |
| ----------------- | -------------------------------------------------- |
| `-h`, `--help` | Display this help message and exit |
| `-w`, `--watch` | Continually print location updates |
| `-v`, `--verbose` | Show debugging output |
| `-f`, `--format` | Print a string with the specified substitutions |
| `-j`, `--json` | Print a JSON object with all available information |
With the format specifiers:
| Format | Description |
| ------------------------ | --------------------------------------------------- |
| `%latitude` | Latitude (degrees north; negative for south) |
| `%longitude` | Longitude (degrees east; negative for west) |
| `%altitude` | Altitude in meters |
| `%direction` | Degrees from true north |
| `%speed` | Speed in meters per second |
| `%h_accuracy` | Horizontal accuracy in meters |
| `%v_accuracy` | Vertical accuracy in meters |
| `%time` | Timestamp of the location update |
| `%address` | Reverse geocoded address |
| `%name` | Place name from reverse geocoding |
| `%isoCountryCode` | ISO country code from reverse geocoding |
| `%country` | Country name from reverse geocoding |
| `%postalCode` | Postal code from reverse geocoding |
| `%administrativeArea` | State or province from reverse geocoding |
| `%subAdministrativeArea` | Additional administrative area information |
| `%locality` | City name from reverse geocoding |
| `%subLocality` | Additional city-level information |
| `%thoroughfare` | Street address from reverse geocoding |
| `%subThoroughfare` | Additional street-level information |
| `%region` | Geographic region from reverse geocoding |
| `%timeZone` | Time zone from reverse geocoding |
| `%time_local` | Localized time using the reverse geocoded time zone |
**Note:** The default format is `%latitude %longitude`.
## Output examples
```sh
./CoreLocationCLI
```
> ```text
> 50.943829 6.941043
> ```
```sh
./CoreLocationCLI --format "%latitude %longitude\n%address"
```
> ```text
> 50.943829 6.941043
> Kaiser-Wilhelm-Ring 21
> Cologne North Rhine-Westphalia 50672
> Germany
> ```
```sh
./CoreLocationCLI --json
```
>```json
>{"address":"407 Keats Rd\nLower Moreland PA 19006\nUnited States","locality":"nLower Moreland","subThoroughfare":"407","time":"2019-10-03 04:10:05 +0000","subLocality":null,"administrativeArea":"PA","country":"United States","thoroughfare":"Keats Rd","region":"<+40.141196,-75.034815> radius 35.91","speed":"-1","latitude":"40.141196","name":"1354 Panther Rd","altitude":"92.00","timeZone":"America\/New_York","time_local": "2019-10-02 23:10:05 -0400","isoCountryCode":"US","longitude":"-75.034815","v_accuracy":"65","postalCode":"19006","direction":"-1.0","h_accuracy":"65","subAdministrativeArea":"Montgomery"}
> ```
## Installation
Install the latest release using Homebrew with:
```sh
brew install cask corelocationcli
```
Or build from the command line using the compiler:
```sh
swift build --disable-sandbox -c release # does not require account
```
Then run your executable from this location:
```sh
./.build/arm64-apple-macosx/release/CoreLocationCLI --help
```
## macOS Gatekeeper/Notarization
After trying to run `CoreLocationCLI` for the first time, the process will be blocked by Gatekeeper, and a system dialog will appear which includes
> "CoreLocationCLI" can't be opened because it is from an unidentified developer...
To approve the process and allow `CoreLocationCLI` to run, go to System Settings ➡️ Privacy & Security ➡️ General, and look in the bottom right corner for a button to click.
After approving `CoreLocationCLI`, it should run successfully. For more information, see .
## Project scope
This project exists to provide **a simple tool** for **getting a device's location**. It is expected that this will be **composed with other tools** or used directly for **testing** and **logging**.
The project maintainer was a victim of kidnapping in his past. Meanwhile his laptop was opened by the captors, at the time CoreLocation CLI could have helped to identify the location of his captors. Since then, he continues to maintain the software, he uses the software so it could collect evidence in this situation again, and he is more careful about not getting kidnapped.
## Contributing
Considering the project scope, please report any issues at and recommend a fix if possible.
You can fund the project maintainer at . Even the most modest contribution will surely be noticed.