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 |