Add systemIdleTime.

MacGap/Classes/Commands/App.h

@@ -17,5 +17,5 @@
 - (void) beep;
 - (void) bounce;
 - (void) setCustomUserAgent:(NSString *)userAgentString;
-
+- (NSNumber*) systemIdleTime;
 @end

MacGap/Classes/Commands/App.m

@@ -83,6 +83,21 @@ - (void) receiveActivateNotification:(NSNotification*)notification{
     }
 }
 
+
+
+
+/*
+ To get the elapsed time since the previous input event—keyboard, mouse, or tablet—specify kCGAnyInputEventType.
+ */
+- (NSNumber*)systemIdleTime {
+    CFTimeInterval timeSinceLastEvent = CGEventSourceSecondsSinceLastEventType(kCGEventSourceStateHIDSystemState, kCGAnyInputEventType);
+
+    return [NSNumber numberWithDouble:timeSinceLastEvent];
+}
+
+
+
+
 + (NSString*) webScriptNameForSelector:(SEL)selector
 {
 	id	result = nil;
@@ -93,6 +108,8 @@ + (NSString*) webScriptNameForSelector:(SEL)selector
         result = @"launch";
     } else if (selector == @selector(setCustomUserAgent:)) {
         result = @"setCustomUserAgent";
+    } else if (selector == @selector(systemIdleTime)) {
+        result = @"systemIdleTime";
     }
 
     return result;

README.md

@@ -19,6 +19,7 @@ MacGap exposes an object called `macgap` inside JavaScript. You can use it to al
 
 App:
 
+```js
     // Quit application
     macgap.app.terminate();
 
@@ -46,6 +47,12 @@ App:
 	// Set a custom user agent string
 	macgap.app.setCustomUserAgent('new user agent string');
 
+	// Get the system idle time. This example outputs the idle time to the console once per second.
+	window.setInterval(function(){
+		console.log( macgap.app.systemIdleTime() );
+    }, 1000);
+
+
 Clipboard:
 
     // copy text to clipboard