docs » hs.pasteboard.watcher

Gets or sets the polling interval (i.e. the frequency the pasteboard watcher checks the pasteboard).

• value - an optional number to set the polling interval to.

• The polling interval as a number.

• This only affects new watchers, not existing/running ones.
• The default value is 0.25.

Creates and starts a new hs.pasteboard.watcher object for watching for Pasteboard changes.

• callbackFn - A function that will be called when the Pasteboard contents has changed. It should accept one parameter:
  • A string containing the pasteboard contents or nil if the contents is not a valid string.
• name - An optional string containing the name of the pasteboard. Defaults to the system pasteboard.

• An hs.pasteboard.watcher object

• Internally this extension uses a single NSTimer to check for changes to the pasteboard count every half a second.
• Example usage:

generalPBWatcher = hs.pasteboard.watcher.new(function(v) print(string.format("General Pasteboard Contents: %s", v)) end)
specialPBWatcher = hs.pasteboard.watcher.new(function(v) print(string.format("Special Pasteboard Contents: %s", v)) end, "special")
hs.pasteboard.writeObjects("This is on the general pasteboard.")
hs.pasteboard.writeObjects("This is on the special pasteboard.", "special")```

Returns a boolean indicating whether or not the Pasteboard Watcher is currently running.

• None

• A boolean value indicating whether or not the timer is currently running.

Starts an hs.pasteboard.watcher object

• None

• The hs.pasteboard.watcher object

Stops an hs.pasteboard.watcher object

• None

• The hs.pasteboard.watcher object