openHAB

# FolderWatcher Binding

This binding is intended to monitor FTP, local folder and S3 bucket and its subfolders and notify of new files

# Supported Things

Currently the binding support three types of things: ftpfolder, localfolder and s3bucket.

# Thing Configuration

The ftpfolder thing has the following configuration options:

Parameter Name Description Required Default value
ftpAddress FTP server IP address of FTP server yes n/a
ftpPort FTP port Port of FTP server yes 21
secureMode FTP Security FTP Security yes None
ftpUsername Username FTP user name yes n/a
ftpPassword Password FTP password yes n/a
ftpDir RootDir Root directory to be watched yes n/a
listRecursiveFtp List Sub Folders Allow listing of sub folders yes No
listHidden List Hidden Allow listing of hidden files yes false
connectionTimeout Connection timeout, s Connection timeout for FTP request yes 30
pollInterval Polling interval, s Interval for polling folder changes yes 60
diffHours Time stamp difference, h How many hours back to analyze yes 24

The localfolder thing has the following configuration options:

Parameter Name Description Required Default value
localDir Local Directory Local directory to be watched yes n/a
listHiddenLocal List Hidden Allow listing of hidden files yes No
pollIntervalLocal Polling interval, s Interval for polling folder changes yes 60
listRecursiveLocal List Sub Folders Allow listing of sub folders yes No

The s3bucket thing has the following configuration options:

Parameter Name Description Required Default value
s3BucketName S3 Bucket Name Name of the S3 bucket to be watched yes n/a
s3Path S3 Path S3 path (folder) to be monitored no n/a
pollIntervalS3 Polling Interval Interval for polling S3 bucket changes, in seconds yes 60
awsKey AWS Access Key AWS access key no n/a
awsSecret AWS Secret AWS secret no n/a
awsRegion AWS Region AWS region of S3 bucket yes ""
s3Anonymous Anonymous Connection Connect anonymously (works for public buckets) yes true

# Events

This binding currently supports the following events:

Channel Type ID Item Type Description
newfile String A new file name discovered

# Full Example

Thing configuration:

folderwatcher:localfolder:myLocalFolder [ localDir="/myfolder", pollIntervalLocal=60, listHiddenLocal="false", listRecursiveLocal="false" ] 
folderwatcher:ftpfolder:myLocalFolder   [ ftpAddress="X.X.X.X", ftpPort=21, secureMode="EXPLICIT", ftpUsername="username", ftpPassword="password", ftpDir="/myfolder/",  listHidden="true", listRecursiveFtp="true", connectionTimeout=33, pollInterval=66, diffHours=25 ]
folderwatcher:s3bucket:myS3bucket       [ s3BucketName="mypublic-bucket", pollIntervalS3=60, awsRegion="us-west-1", s3Anonymous="true" ]

# Using in a rule:

FTP example:

rule "New FTP file"
when 
    Channel "folderwatcher:ftpfolder:myLocalFolder:newfile" triggered
then

    logInfo("NewFTPFile", receivedEvent.toString())

end

Local folder example:

rule "New Local file"
when 
    Channel "folderwatcher:localfolder:myFTPFolder:newfile" triggered
then

    logInfo("NewLocalFile", receivedEvent.toString())

end

S3 bucket example:

rule "New S3 file"
when 
    Channel "folderwatcher:s3bucket:myS3bucket:newfile" triggered
then

    logInfo("NewS3File", receivedEvent.toString())

end
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)

← [email protected] →