find-my-iphone

    1.1.2 • Public • Published

    find-my-iphone

    A Node module to interact with iCloud to do the following:

    1. Get the latitude / longitude of an iCloud device
    2. Send find my phone alerts
    3. Get the distance of a found device.
    4. Get the approximate address of a device.
    5. Get the approximate driving time to a device.

    Installation

    	npm install find-my-iphone

    Summary

    This module can alert the find my phone webservice, this also works with family sharing, so you can track family members on the fly. It works by pretending to be a browser and actually logging into the iCloud service.

    Example

    Here's a basic example using all the methods

    	var icloud = require("find-my-iphone").findmyphone;
    
    	icloud.apple_id = "steve@jobs.com";
    	icloud.password = "oneMoreThing"; 
    
    	icloud.getDevices(function(error, devices) {
    		var device;
    
    		if (error) {
    			throw error;
    		}
    		//pick a device with location and findMyPhone enabled
    		devices.forEach(function(d) {
    			if (device == undefined && d.location && d.lostModeCapable) {
    				device = d;
    			}
    		});
    
    		if (device) {
    
    			//gets the distance of the device from my location
    			var myLatitude = 38.8977;
    			var myLongitude = -77.0366;
    
    			icloud.getDistanceOfDevice(device, myLatitude, myLongitude, function(err, result) {
    				console.log("Distance: " + result.distance.text);
    				console.log("Driving time: " + result.duration.text);
    			});
    
    			icloud.alertDevice(device.id, function(err) {
    				console.log("Beep Beep!");
    			});
    
    			icloud.getLocationOfDevice(device, function(err, location) {
    				console.log(location);
    			});
    		}
    	});

    Legacy API

    var find = require('find-my-iphone');
    
    // Alert the first (or only) device on the account
    find('user@icloud.com', 'password');
    
    // Alert a specific device
    find('user@icloud.com', 'password', 'iPhone 6');
    
    // Callback when successful
    find('user@icloud.com', 'password', 'iPhone 6',function() {
    	console.log("Done!");
    });
    find(email,password[,label[,callback]])
    • email (required): The email address you use to login to iCloud
    • password (required): Your iCloud password
    • label (optional): The label of the phone you want to alert (iCloud accounts may have multiple devices). The label can be found under "All Devices" in the Find My iPhone app. If there are multiple phones with the same label, the last one matching will be alerted. You should rename devices to be unique.
    • callback (optional): A function to execute when the phone has been alerted

    Tests

    apple_id=someone@gmail.com apple_password=somePassword mocha test

    Install

    npm i find-my-iphone

    DownloadsWeekly Downloads

    40

    Version

    1.1.2

    License

    MIT

    Unpacked Size

    12 kB

    Total Files

    5

    Last publish

    Collaborators

    • mkruse