watchDirectory Help

Help Home
Creating New Tasks
Running Tasks
Task History


Standard versus Pro
Version History


Creating New Tasks

  1. Select the plugin to use
  2. Plugin Settings
  3. Directory to Watch
  4. Directories to Exclude
  5. Filter Events
    • Create a new Filter
  6. Monitoring Method
  7. Events
  8. Scheduler (Pro)
  9. Other
  10. Name and Description
  11. How to Run
  12. File Permissions

Free 30 day evaluation!
Standard version: $79 USD
Professional version: $149 USD
Buy Now!


German Helpfile

German Helpfile

French Helpfile

French Helpfile

Spanish Helpfile

Spanish Helpfile

Privacy Policy

Edit Filter

Previous TopicBack to Filter Events
Filter definition

This window is used to create a new filter, or change an existing filter. It allows you to select which part of the filename the filter checks, and how it should check it.

What part of the filename is evaluated by this filter

With the selection box marked 1 on the screenshot you select the part of the filename this filter applies to. You can choose from one of the following:

Part of FilenameExample value
Complete PathC:\MonitoredDirectory\SubDirectory\Another\FileName.txt
File NameFileName.txt
File TitleFileName
(the directory always ends with a backslash!)
Relative DirectorySubDirectory\Another
(this is the part of the path "starting" from the monitored directory, without the filename)
Parent DirectoryAnother

Compare method

With the selection box marked 2 on the screenshot, you select the operator this filter uses to compare the selected filename part (from 1) with the value(s) you provide (in 3). Every operator also has a does not variant, so you can use, for example, "Equals", but also "Does not Equal".

All operators ignore UPPER- and lower-case differences.

Advanced Matching

Advanced Matching

When using the "Matches" operator, you can enable advanced matching by starting the value with 2 colons (::).

Use :9 to match a number (0-9)
Use :A to match a letter (A-Z)
Use :Z to match a letter or number (A-Z, 0-9)
Use :! to match punctuation characters such as _(),.
Use \: to match a colon (:)
Use \\ to match a single backslash

extension matches :::9:9:9
checks for a numeric file extension.

OperatorEffectExample (using extension TXT)
EqualsChecks if the selected filename part is exactly the same as valueextension equals TXT - true
extension equals JPG - false
Starts WithChecks if the selected filename part starts with the valueextension starts with T - true
extension starts with J - false
Ends WithChecks if the selected filename part ends with the valueextension ends with XT - true
extension ends with G - false
ContainsChecks if the selected filename part has the value somewhere in itextension contains X - true
extension contains P - false
MatchesChecks if the selected filename part matches a pattern (using * and ?)
The * matches zero or more positions, the ? matches exactly one position.
All other characters are used "as is".
extension matches * - true
extension matches ??? - true
extension matches TX? - true
extension matches J?? - false
Is EmptyChecks if the selected filename part is empty (does not use value)extension is empty - false

Value to compare with

Here (3 on the screenshot) you enter the value or values to compare with. If you want to compare to multiple values, separate each value with a semi-colon (;). The screenshot shows how the file extension is compared to JPG, BMP and GIF. If the file extension equals one of these values the filter evaluates to true, and the file or directory is processed or ignored depending on your next choice (in 4).

What to do if this filter evaluates to true

Here (4 on the screenshot above) you select what the result is if this filter is "true". Should the event (new file, deleted file etcetera) be processed or ignored.

Testing the filter

Testing the Filter

The bottom part of the window allows you to test the filter you are creating.
Input File: Enter a file (and sub-directory) you want to test with. The filename you enter here is appended to the "monitored directory" which is taken from your task-definition. The bottom (marked 7) shows the result for this filter.

Previous TopicBack to Filter Events