Skip to content

Examples

Aditya Rajput edited this page Mar 10, 2026 · 2 revisions

For each MOVE rule, enter a regex pattern to match against files in the source folder, and a regex template to use while naming the files created in the destination folder. For DELETE_STALE rules, the latter is not required.

Patterns

The pattern must match the entire file name (along with its extension). Here are some examples:

Target one specific file

trackbook-backup\.zip

Important

Escape special characters, like periods and parentheses.

Target files starting with a certain string and having a certain extension

AntennaPodBackup(.*)\.db

Caution

Ensure that the prefix is specific enough. Too-broad patterns may lead to data loss.

Target files while extracting information to be used in the template (see below)

TubularData-(?<date>\d{8})_(?<time>\d{6})\.zip

Templates

The template can contain references to groups captured in the pattern. Prefer named groups to avoid ambiguity. Here are some examples:

Static template

antennapod.db

Important

If a file with the same name is already present in the destination and the "overwrite existing" option has not been turned on, the flow will fail.

Dynamic template (named references)

tubular${date}.zip

Important

${folder} is a special reference which will contain the name of the direct parent of the file being considered. This is useful for "flattening" rules (i.e., rules which scan subfolders, but don't recreate structure).

Example: for the file /storage/emulated/0/Foo/Bar/Baz.png, ${folder} will be replaced by Bar.

Dynamic template (indexed references)

tubular$1.zip

Tip

$0 will be replaced by the entire file name (including the extension). This is useful for copying/moving files without renaming them.


Use these examples to build your own pattern/template pairs. You can visit regexr.com to learn more about regex, as well as build & test patterns. For advanced usage, you can use this playground to test against the actual Kotlin regex engine.

If you're having difficulty targetting certain files, you can raise an issue describing your situation.