Skip to content

Filters

You can add filters where your can configure to include or exclude files and folders based on file type, name, size, file age and modification date. Regular expression filtering is also supported if that is something you are into. Sync filters are specific to the folderPair for which you configure them.

Concept

  • A file/folder will be always excluded if it matches at least one exclude filter.
  • A file/folder will be included if it matches at least one include filter, it doesn’t have to match all of them.
  • If a folder, other than the root folderPair sync folder, is excluded then all of its children file/folders will also automatically be excluded.
  • Sub folders of an included folder will not be synced unless they also match a folder include filter.

Exclude filter precedence

If a file or folder matches both an exclude and an include filter, the exclude filter will take precedence and the file/folder will be excluded.

About filter values

  • Filter value should match the local folder path when using a path value in filter. Filters with a path value will not be compared to remote folder path.
  • All filters are case-insensitive.
  • File extension filters can be for example “jpg” or “doc”. Don’t include leading period.
  • If filter value for the folder filters “contains”, “equals”, “startsWith” and “endsWith” contains a forward slash “/” then the filter is applied to the device path of the folder, if not is is compared against folder name only.

Regular expression filters

Regex filters are only applied to filename, foldername, the local folder path or the file modified timestamp, depending on which type of RegEx filter is chosen.

Info about which regex expressions patterns are supported can be found here.

RegEx filter What is regular expression matched to
File name RegEx File name only
File path RegEx Local file path of the file, such as /mnt/sdcard/rootfolder/filename.jpg
File modified time RegEx The modified time of the file in ISO8601 like pattern such as 2024-05-01T11:57:33Z
Folder name RegEx File name only
Folder path RegEx Local folder path of the folder, such as /mnt/sdcard/rootfolder/xyz

Examples - include filters

Desired outcome Include filter to use Value
Include a file abc.txt File name equals abc.txt
Include all files of type avi File extension avi
Include a specific folder xyz and all its sub folders Folder name starts with /mnt/sdcard/rootfolder/xyz
Include a specific folder xyz and all files in it, but not subfolders Folder name equals /mnt/sdcard/rootfolder/xyz
Include any folder named xyz and all files in those, but not subfolders Folder name equals xyz

Examples - exclude filters

Desired outcome Exclude filter to use Value
Exclude a file abc.txt File name equals abc.txt
Exclude all files of type avi File extension avi
Exclude a specific folder xyz and all its contents Folder name starts with /mnt/sdcard/rootfolder/xyz