W3cubDocs

hs.application.watcher

Watch for application launch/terminate events

This module is based primarily on code from the previous incarnation of Mjolnir by Markus Engelbrecht and Steven Degutis.

Constructors - API calls which return an object, typically one that offers API methods

Methods - API calls which can only be made on an object returned by a constructor

Signature	`hs.application.watcher.activated`
Type	Constant
Description	An application has been activated (i.e. given keyboard/mouse focus)
Source	extensions/application/libapplication_watcher.m line 33

Signature	`hs.application.watcher.deactivated`
Type	Constant
Description	An application has been deactivated (i.e. lost keyboard/mouse focus)
Source	extensions/application/libapplication_watcher.m line 37

Signature	`hs.application.watcher.hidden`
Type	Constant
Description	An application has been hidden
Source	extensions/application/libapplication_watcher.m line 25

Signature	`hs.application.watcher.launched`
Type	Constant
Description	An application has been launched
Source	extensions/application/libapplication_watcher.m line 17

Signature	`hs.application.watcher.launching`
Type	Constant
Description	An application is in the process of being launched
Source	extensions/application/libapplication_watcher.m line 13

Signature	`hs.application.watcher.terminated`
Type	Constant
Description	An application has been terminated
Source	extensions/application/libapplication_watcher.m line 21

Signature	`hs.application.watcher.unhidden`
Type	Constant
Description	An application has been unhidden
Source	extensions/application/libapplication_watcher.m line 29

Signature	`hs.application.watcher.new(fn) -> watcher`
Type	Constructor
Description	Creates an application event watcher
Parameters	fn - A function that will be called when application events happen. It should accept three parameters: A string containing the name of the application An event type (see the constants defined above) An `hs.application` object representing the application, or nil if the application couldn't be found
Returns	An `hs.application.watcher` object
Notes	If the function is called with an event type of `hs.application.watcher.terminated` then the application name parameter will be `nil` and the `hs.application` parameter, will only be useful for getting the UNIX process ID (i.e. the PID) of the application
Source	extensions/application/libapplication_watcher.m line 142

Signature	`hs.application.watcher:start()`
Type	Method
Description	Starts the application watcher
Parameters	None
Returns	The `hs.application.watcher` object
Source	extensions/application/libapplication_watcher.m line 224

Signature	`hs.application.watcher:stop()`
Type	Method
Description	Stops the application watcher
Parameters	None
Returns	The `hs.application.watcher` object
Source	extensions/application/libapplication_watcher.m line 247

© 2014–2017 Hammerspoon contributors
Licensed under the MIT License.
https://www.hammerspoon.org/docs/hs.application.watcher.html