Launchd.plist with WatchPaths key: How to set a minimum interval?

Question

How would one set a minimum interval for a launchd.plist script with a WatchPath key?

For example, I want to run a script every time new files appear in a directory, but I would like it to only run once an hour at maximum.

The launchd.plist might look something like this:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"&gt;
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>org.me.pytag</string>
  <key>ProgramArguments</key>
  <array>
    <string>/Users/me/bin/pytag.py</string>
  </array>
  <key>WatchPaths</key>
  <array>
    <string>/Volumes/Data/Media/Video/Processing/Converted</string>
  </array>
  <key>StandardOutPath</key>
  <string>/dev/null</string>
</dict>
</plist>

Answer 1

Add this property. Note that the integer is in seconds.

<key>ThrottleInterval</key>
  <integer>3600</integer>