distributednotifications

Last updated last month

Interact with NSDistributedNotificationCenter There are many notifications posted by parts of OS X, and third party apps, which may be interesting to react to using this module.

You can discover the notifications that are being posted on your system with some code like this:

foo = hs.distributednotifications.new(function(name, object, userInfo) print(string.format("name: %s\nobject: %s\nuserInfo: %s\n", name, object, hs.inspect(userInfo))) end)
foo:start()

Note that distributed notifications are expensive - they involve lots of IPC. Also note that they are not guaranteed to be delivered, particularly if the system is very busy.

API Overview

  • Functions - API calls offered directly by the extension

  • 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

API Documentation

Functions

post

Signature

hs.distributednotifications.post(name[, sender[, userInfo]])

Type

Function

Description

Sends a distributed notification

Parameters

Constructors

new

Signature

hs.distributednotifications.new(callback[, name[, object]]) -> object

Type

Constructor

Description

Creates a new NSDistributedNotificationCenter watcher

Parameters

Returns

Methods

start

Signature

hs.distributednotifications:start() -> object

Type

Method

Description

Starts a NSDistributedNotificationCenter watcher

Parameters

Returns

stop

Signature

hs.distributednotifications:stop() -> object

Type

Method

Description

Stops a NSDistributedNotificationCenter watcher

Parameters

Returns