Skip to content
This repository has been archived by the owner on Jun 9, 2018. It is now read-only.

Preferences

Clayton Burlison edited this page Mar 6, 2018 · 20 revisions

Introduction

pinpoint stores its configuration info in the com.clburlison.pinpoint preferences domain, /Library/Preferences/com.clburlison.pinpoint.plist, however configuration profiles are also supported.

Supported Keys

Key Type Default Description
AddressLookup boolean True With this enabled pinpoint will do a reverse geolocation lookup to get an estimated address from for your mac. For additional privacy this can be disabled. Removed in v1.0.
AddressLookupService string apple This allows you to choose which reverse lookup service you wish to use. Supported values: apple, google, or none.
CacheDir string /Library/Application Support/pinpoint The directory that pinpoint uses to store output data
CheckWaitTime integer 1800 The time in seconds, before another lookup will take place. The LaunchDaemon will run every 10 minutes, as such with the default of 1800 it will wait ~30 minutes before another lookup takes place.
DisableWireless boolean False With this enabled pinpoint will disable airport adapters if they are turned turned on earlier in the run. This in conjunction with the EnableWireless will allow you to complete lookups on devices that normally have wireless disabled and return the state of the device.
EnableWireless boolean False With this enabled pinpoint will enable airport adapters if they are turned off prior to a lookup. pinpoint will leave the adapter turned on at the end of the run.
Fallback boolean False With this enabled pinpoint will enable fallback to the alternative lookup services. Requires v2.0.2 (Unreleased)
GoogleApiKey string 'none' API key for using the Google location service api. Requires v2.0.1. Get your key here.
LookupService string apple This allows you to choose which lookup service you wish to use. Supported values: apple or google.

Sample

Here's a sample of /Library/Preferences/com.clburlison.pinpoint.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>AddressLookupService</key>
	<string>apple</string>
	<key>CacheDir</key>
	<string>/Library/Application Support/pinpoint</string>
	<key>CheckWaitTime</key>
	<integer>1800</integer>
	<key>DisableWireless</key>
	<false>
	<key>EnableWireless</key>
	<false/>
	<key>Fallback</key>
	<false/>
	<key>GoogleApiKey</key>
	<string>none</string>
	<key>LookupService</key>
	<string>apple</string>
</dict>
</plist>