Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Simple library for locating iOS devices (iPad, iPhone and iPod).
branch: master

Merge pull request #1 from brock/master

handle unknown location in example
latest commit 53b520d564
@ThomasHenley authored
Failed to load latest commit information.
examples handle unknown location (old devices, some MacBooks, etc)
lib Few tweaks Few tweaks
package.json Few tweaks


Simple library to locate iOS devices (iPhone, iPod and iPad)


First install node.js. Then:

$ npm install iphone-finder


var iPhoneFinder = require('iphone-finder');

// Replace with valid iCloud email and password
var iCloudUser = '';
var iCloudPass = '#############';

// Find all devices the user owns
iPhoneFinder.findAllDevices(iCloudUser, iCloudPass, function(err, devices) {
    // Got here? Great! Lets see some device information
    devices.forEach(function(device) {
        // Output device information
        console.log('Device Name: ' +;
        console.log('Device Type: ' + device.modelDisplayName);

        // Output location (latitude and longitude)
        var lat = device.location.latitude;
        var lon = device.location.longitude;
        console.log('Lat/Long: ' + lat + ' / ' + lon);

        // Output a url that shows the device location on google maps
        console.log('View on Map:' + lat + '+' + lon);
Something went wrong with that request. Please try again.