glucero0.github.io

Home

Welcome to Sync2Folders Pro!

Sync2Folders Pro is a comparison and synchronization tool. It compares files based on their modified date/time, and in the case of executable files (those with the extensions .EXE and .DLL), it compares their version information.

Sync2Folders Pro compares files and presents a list of all of the files it finds. This file comparison list includes the filename, comparison status, the source file’s modified date/time, the source file’s version, the destination file’s modified date/time, the destination file’s version, the source folder of the file, and the destination folder of the file.

Once compared, files can be synchronized using either Sync Methods or File Operations.

Sync methods are powerful commands that act on the entire file comparison list, copying or deleting files depending on the sync method’s properties. New sync methods can be added and existing can be edited and deleted. They are completely customizable.

File operations act on only those files that are selected in the file comparison list. They perform a single action, such as “copy source file to destination”.

Sync2Folders Pro provides features to filter the file comparison list, search for items in it, select items, and it includes options to exclude files from the list based on folder name, filename, file extension, or by using regular expressions.

Sync2Folders Pro also has a feature called “revisioning” that allows it to maintain backups, or revisions, of destination files. When revisioning is enabled, each time before a destination file is overwritten or deleted, a revision of it is copied into a special folder. These revisions can be accessed later and copied (restored), deleted, compared using third party apps, or otherwise managed.

Please continue reading for more information on Sync2Folders Pro.

What Sync2Folders Pro Isn’t

What Sync2Folders Pro isn't is a file contents comparison tool. It doesn't open files and compare the text or binary contents of the files. It only compares the modified date and times or the file version info. 

And while it can synchronize files, that is, copy or delete files, it doesn't provide a means to synchronize the contents within files. So Sync2Folders Pro can't perform line-by-line differential comparisons and then sync those lines of text from one file to another.

Last but not least, Sync2Folders Pro is not a premium app. It’s free.


What's New in Sync2Folders Pro


Sync2Folders Pro Version 1.2 has a few significant changes:

See Change Logs for more info on what has changed in Sync2Folders Pro.

A Quick Tour of Sync2Folders Pro



  1. Profile - Create new, save, and load profiles; manage excluded files, folders, file extensions and regular expressions
  2. Filters - Use built-in and custom filters to limit what's displayed in the file comparison list
  3. Search - Search by filename, extension, modified date/time, version, or folder
  4. Sync Methods - Use powerful commands to synchronize files
  5. File Operations - Perform operations on selected files
  6. Options - Configure an external application and toggle settings on/off for sync method and file operation confirmations, compact mode, empty folder deletions, and logging
  7. Help - Display this help file, keyboard shortcuts, and version/licensing/copyright info
  8. Source folder - Type in or use the Browse... button to select a source folder
  9. Checkbox - Check to lock the source folder so file operations and sync methods cannot alter (overwrite, delete) files in the source folder
  10. Browse... - Browse for a source folder
  11. Destination folder - Type in or use the Browse... button to select a destination folder
  12. Checkbox - Check to lock the destination folder so file operations and sync methods cannot alter (overwrite, delete) files in the destination folder
  13. Browse... - Browse for a destination folder
  14. File Spec - Enter a mask or wildcard to limit which files are compared
  15. Compare - Click this button to compare the Source and Destination folders
  16. Compare EXE/DLL versions - When checked, all files with .EXE and .DLL extensions are checked for version info and this version info is compared. When unchecked, all files, including EXEs and DLLs, are compared using modified date and time
  17. Revision destination files - When checked, all destination files that are to be overwritten or deleted are first revisioned
  18. Indicator - If the current profile has changed, this indicator is displayed. This might necessitate performing the comparison again or saving the profile
  19. Indicator - If exclusions are disabled in Options, this indicator is displayed. When exclusions are enabled, the number of each type is shown here
  20. File Comparison List - The files currently being compared
  21. Progress Bar - Displays progress as files are compared
  22. Status Bar - Displays information as comparison takes place, and includes summary once comparison has completed

The Sync2Folders Pro Menus

Profile

The Profile menu gives you menu items to create new profiles, as well as save, load, rename and delete profiles.


What’s a Profile?

A profile in Sync2Folders Pro is made up of the following:


Please note that Revision destination files cannot be checked when the source folder is unlocked.
Profile Location and Naming

Profiles are stored in your user folder under Documents, which is typically “C:\Users[username]\Documents\Sync2FoldersPro”.

Profiles are made up of multiple XML files. The main profile is stored in a file that ends in “_Profile.xml” and the exclusions are stored in files that end in:

_ExcludedFolders.xml
_ExcludedFiles.xml
_ExcludedExtensions.xml
_ExcludedRegEx.xml

The prefix for all of these files is the name given when the profile is saved. If you named your profile “Compare C and D Drives”, the files would be named:

Compare C and D Drives_Profile.xml
Compare C and D Drives_ExcludedFolders.xml
Compare C and D Drives_ExcludedFiles.xml
Compare C and D Drives_ExcludedExtensions.xml
Compare C and D Drives_ExcludedRegEx.xml

Note that not all of these files will necessarily be present. If your profile doesn’t have any exclusions, then the excluded XML files won’t exist.
Auto-Save Note that if a profile has been previously saved, Profiles > Save saves the profile to the existing filename, but the profile will also automatically save if you close Sync2Folders Pro or select Profiles > New or Profiles > Load.

This is important to consider when you want to take an existing profile, modify and save it to a new name. It’s recommended you save it first using Profiles > Save As and then make your changes, otherwise you may modify your original profile without intending to.

Profile Changed Indicator

If the current profile has changed, the indicator, “The current profile has changed.” displays above the file comparison list. Depending on the changes, this could mean the current comparison results are invalid, and/or that the profile should be saved.

Save, Load, Rename and Delete Profiles

Profile > Save either prompts for a name to save the profile to, or, if the profile already exists and is loaded, saves without prompting.
Profile > Load prompts for a profile to load.
Profile > Rename prompts for a new name for the currently loaded profile.
Profile > Delete prompts to confirm for the deletion of the currently loaded profile.

Please note that when saving and renaming a profile, only the following characters are allowed for the profile name:

Space, dash, underscore, and comma characters as well as the characters a-z, A-Z, 0-9, &, %, $, #, @, !, ‘, (, and ).

The Profiles section below explains profiles in more detail.

Filters

Filters are used to limit which comparison files are displayed.

Default Filters

Sync2Folders Pro has several filters built-in:

  • Show All Files - Shows all files in the file comparison list regardless of comparison status or other criteria
  • Show All New Files - Shows all files with a comparison status of Source: New
  • Show All Newer Files - Shows all files with a comparison status of Source: Newer
  • Show All Older Files - Shows all files with a comparison status of Source: Older
  • Show All Missing Files - Shows all files with a comparison status of Source: Missing
  • Show All Matching Files - Show all files with a comparison status of Source-Dest: Match
See the Comparison Statuses section later down in the page for info on them.


Creating, Editing, and Deleting Filters

Manage Filters… is used to edit, delete, and create filters. While Show All Files cannot be edited or deleted, the rest of the filters can be. New filters can also be created.

Drag and drop filters in the Manage Filters list to order them. They appear in the Filters drop list in the same order they appear in the Manage Filters form. Please note that Show All Files always appears first and Manage Filters… always appears last.

Here’s the Manage Filters form:

Add, edit, delete, and order filters.


When you specify a filter, you decide how to match files from the file comparison list. You can match on comparison statuses (Matching, New, Newer, Older, and Missing), perform full or partial matches on the Filename field, a file extension from the Filename field, the Version fields, the Folder fields, and/or the Modified Date/Time fields, or filter on files that have one or more revisions.

NOTE: Sync2Folders Pro ORs together the criteria from a given filter. For example, if you set up a filter with New and Older both checked, when you select this filter, if a given file has a comparison status of either Source: New or Source: Older, it’s displayed. The same goes with the Filename, Extension, Version, Folder, and Modified Date/Time fields. If the file in question partially or completely matches one criteria, then the file is displayed.

On Partial Matching:

By partial matching it is meant that if you create a filter and set the Filename field to “boardroom”, the filter will match all filenames that contain the text “boardroom”. This means “Dec 2019 Boardroom Meeting.xls” and “Boardroom Notes.txt” will match, but “Meeting in Board Room.docx” will not.

How to Get the Default Filters Back

Filters are stored in a Filters.xml file in the “C:\Users[username]\Documents\Sync2FoldersPro” folder. To restore the default set of filters:

  1. Close Sync2Folders Pro
  2. Rename or delete Filters.xml
  3. Start Sync2Folders Pro
  4. A new Filters.xml file is created and has the default set of filters

Search

The Search menu lets you search the file comparison list by filename, file extension, number of revisions, modified date/time, version, and folder. When searching by modified date/time, version, and folder, it searches both the source and destination columns.


The Search forms all have a field to enter your search term, Search and Cancel buttons.

When it finds a match, it selects the file. You can reset the search to the top of the list by selecting the first item. It keeps track of your position in the list, so pressing F3 or using the search form and clicking Search again with the same search criteria will look for the next match.


Keyboard Shortcuts - Search

  • F3 - Search for the next occurrence using the current search criteria
  • Ctrl-N - Search for item with comparison status Source: New
  • Ctrl-Shift-N - Search for item with comparison status Source: Newer
  • Ctrl-O - Search for item with comparison status Source: Older
  • Ctrl-M - Search for item with comparison status Source: Missing
  • Ctrl-Shift-M - Search for item with comparison status Source-Dest: Match
Keyboard Shortcuts - Select

These select items in the list, the first selecting all items, and the remainder selecting based on the current selection:


  • Ctrl-A - Select all items
  • Ctrl-P - Select all items with the same source path as selected
  • Ctrl-F - Select all items with the same filename as selected
  • Ctrl-E - Select all items with the same extension as selected
  • Ctrl-S - Select all items with the same comparison status as selected
Sync Methods

What Are Sync Methods

Sync Methods are convenient, powerful, and customizable. There are eight default sync methods, but these can be edited or deleted.

Sync methods perform file operations on the entire file comparison list with a single command. For example, Two-Way Sync copies files with Source: New and Source: Newer comparison statuses from the source to the destination folder, while copying files with Source: Older and Source: Missing from the destination to the source folder. Sync methods only copy or delete files with specific comparison statuses, though, so choosing the sync method for the current source and destination folders is very important.

After choosing a sync method, the File Operation form displays and shows the progress and results. Please note that if a sync method is selected but the current profile hasn’t been compared, you will be prompted by Sync2Folders Pro whether you’d like to compare then automatically perform the synchronization.

See How Sync Methods Are Related to File Operations below for more info on how the two differ, and Using Sync Methods and File Operations on how to use them effectively.

Default Sync Methods

Menu Item Name Definition
Two-Way Sync Files with New and Newer statuses are copied from the source to the destination and files with Older and Missing statuses are copied from the destination to the source.
Two-Way Sync and Purge Files with Newer statuses are copied from the source to the destination and files with Older statuses are copied from the destination to the source. All files with New or Missing statuses are deleted from the source and destination, respectively.
One Way Sync - Source to Dest Files with New and Newer statuses are copied from the source to the destination.
One Way Sync - Dest to Source Files with Older and Missing statuses are copied from the destination to the source.
One Way Sync and Purge - Source to Dest Files with New, Newer and Older statuses are copied from the source to the destination. Files with Missing statuses are deleted from the destination.
One Way Sync and Purge - Dest to Source Files with Newer, Older and Missing statuses are copied from the destination to the source. Files with New statuses are deleted from the source.
One Way Overwrite - Source to Dest All source files are copied to the destination regardless of the comparison status of the files
One Way Overwrite - Dest to Source All destination files are copied to the source regardless of the comparison status of the files

Creating, Editing, and Deleting Sync Methods

The Manage Sync Method form.


When you create or edit a sync method, you have to decide how you wish to map file operations to comparison statuses. For example, if the comparison status is Source: New, do you want to copy the file to the destination folder or delete it? You can also choose None, which means this sync method won’t perform any file operation when the comparison status is Source: New.

The Manage Sync Methods form.


Drag and drop sync methods in the Manage Sync Methods list to order them. They appear in the Sync Methods menu in the same order they appear in Manage Sync Methods.

Tip: The sync method’s Description is the tooltip that displays when you hover over the menu item name in the Sync Method’s menu, so give it a description that helps you to remember what file operation’s the sync method performs on the file comparison list.

How to Get the Default Sync Methods Back

Sync methods are stored in a SyncMethods.xml file in the “C:\Users[username]\Documents\Sync2FoldersPro” folder. To restore the default set of sync methods:

  1. Close Sync2Folders Pro
  2. Rename or delete SyncMethods.xml
  3. Start Sync2Folders Pro
  4. A new SyncMethods.xml file is created and has the default set of sync methods

File Operations

What’s a File Operation?

A file operation either copies or deletes source or destination files. It is the simplest operation that can be performed, and it can either be performed on only those files that are selected, or when used via sync methods, on the entire comparion list.

File operations are accessed either from the File Operations menu, or from the file comparison list by right-clicking it. The menu also gives access to the menu item, Manage Revisions

To use a file operation, select one or more files, right-click, and select one from the context menu. If a file operation cannot be performed on a selected file, that operation is grayed. If the mix of selected files means no file operation can be performed on all of the files, then they are all grayed.

After choosing a file operation, the File Operation form displays and shows the progress and results.

Manage Revisions

When the “Revision destination files” profile option is checked, Revisions are created each time a file operation is going to overwrite or delete a destination file. Revisioning occurs immediately before the destination file is overwritten or deleted, and it only occurs when there is a destination file in the first place. This means if the file’s comparison status is Newer, Older, or Matching, and a file operation is either going to overwrite the destination file (Copy Source to Destination) or delete it (Delete Destination File), before it does so it copies the current destination file into a special folder and renames it to indicate when it was revisioned.

The Manage Revisions menu item, which is accessible from the context menu available by right-clicking on the file comparison list, displays a form with a list of revisioned files as well as the destination file. Manage Revisions shows these revisions even when there are revisions but the destination file no longer exists (the file’s comparison status is New, in other words). Revisions are not accessible via Sync2Folders Pro if neither the source or the destination file exists, but they can still reside on on disk.

Manage Revisions has options to copy revisions, delete revisions, pass their path and filenames to third party apps, and more. See Managing Revisions for more information.

See How Sync Methods Are Related to File Operations below for more info on how the two differ, and Using Sync Methods and File Operations on how to use them effectively.

File Operation List

File Operation Definition
Copy Source File to Destination Copy the selected file(s) from the source folder to the destination folder
Copy Destination File to Source Copy the selected file(s) from the destination folder to the source folder
Delete Source File Delete the selected file(s) from the source folder
Delete Destination File Delete the selected file(s) from the destination folder
Delete Source and Destination Files Delete the selected file(s) from the source and the destination folder


Options

The Options menu gives you access to the following forms:

Third Party Integration

First is Manage Third Party Apps. Use this to manage a list of third party applications accessible with the keyboard shortcut Ctrl-L, that takes the currently selected source and/or destination filenames and passes it to the selected application. Here you can add, edit, and delete third party applications.

Add, edit, delete, and launch third party apps.


In the screen shot below, Compare JPEG Tags (CompareJPGTags.exe) is configured as one of the third party applications. The command-line passed to it includes both the source and the destination filenames. Each is surrounded by quote marks.

Choose an app and then select the command-line using the Parameters list.


Compare JPEG Tags is a MaxLeafSoft application that takes two JPEG (.JPG) files and compares their tags.

See Launch a Third Party App section for more info on this feature.

Options

Next is the Options menu item, which displays the Sync2Folders Pro Options form.


Display Options

The first group is Display.


When Enable compact mode is on, the file comparison list is hidden, and all menus that relate to it, including Filters, Search, and File Operations, are disabled. This provides a streamlined user interface which is also more performant because it doesn’t have to update the list with files, statuses, and other data. “Enable compact mode” can also be toggled on and off using the keyboard shortcut Ctrl-Shift-C.

Sync2Folders Pro in Compact Mode
When Display completed messages is on, messages are displayed after a comparison or file sync operation has completed. These completed messages include file counts. For example, when a comparison completes, the number of New, Newer, Older, Missing, and Matching files is included in the completion message. File sync operations include a more comprehensive list of file counts, as well as a generic "Total Failed" count.

When off, these events complete without notice.


The options Prompt to confirm file operations and Prompt to confirm sync methods control whether you are prompted when you select a file operation or sync method, respectively. This provides a safeguard to prevent performing an operation which could potentially overwrite or delete important files.

Files and Folders

This section has a single checkbox: Delete empty folders. This controls what happens when a file operation or sync method deletes the last file in a folder. If this is checked and the folder is empty (it has no other files or folders), then the folder deleted.

Logging

Logging has four options

Please see the Logging section later in this help web page for more info on the topic.

Exclusions

When Disable exclusions is checked in the Exclusions section, then all folder, file, extension, and RegEx exclusions are ignored for profiles. Exclusions can still be edited for a given profile, but they are not used during comparison.

This option is normally unchecked but is useful when you don't want to edit your exclusions but you wish to perform the comparison without them.

When this is checked, an indicator displays on the main form above the file comparison list, "Exclusions are currently disabled."


When unchecked, the number of each type of exclusion (file, folder, extension, and regular expression) is shown here.

Help

The Help menu’s three options are simple enough:

Creating and Editing Profiles

To create a new profile, select Profiles > New. This clears the Source folder field, clears the Destination folder field, resets File Spec to “.”, unchecks the two checkboxes that lock the source and/or destination, checks the Compare EXE/DLL versions checkbox, unchecks the Revision destination files checkbox, and clears all excluded files, extensions, folders, and regular expressions.

Profiles

A profile is a collection of settings for a particular source and destination folder, including:


Notes on Revisioning

Revisioning is not available during bi-redirectional synchronization. It is intended for uni-directional (source to destination) synchronization only, which means the Source folder is locked and cannot be altered by sync methods or file operations setting must be checked in order for Revision destination files to be checked. Revisioning is automatically disabled when the source is unlocked.

The Manage Revisions menu item in the file comparison list’s context menu is available regardless of the setting of Revision destination files, meaning all existing revisions of destination files are accessible during bi-directional synchronization.

Source and Destination Folders

Sync2Folders Pro compares the source folder to the destination, looking at each to see which files they contain. It determines how the folders differ. You decide which is source and which is destination. The source is often the more important folder; the one you use to determine how to synchronize files.

For example, you could specify a source that is your central repository for documents, images, or music files. A destination could be a folder to backup to, or maybe your phone or music player. You compare the source (the central repository) to the destination (let’s say your phone) and then decide what to sync to or from that source and destination.

File Spec

This is a mask or wildcard, such as “.” or “my book.txt”. The first example includes all files and the second those that start with “my book” and have the “.txt” file extension. The file spec controls which files will be part of the file comparison list. If you only want the JPEGs, you can use “.jpg”, for example.

Changing the file spec doesn’t change which files are on either the source or destination, it just changes which files you see as you’re  using Sync2Folders Pro.

Locking Profiles

When you use either of the check boxes to lock the source or destination, you’re blocking Sync2Folders Pro from copying files to or deleting files from that folder and its sub-folders. Anytime you select a sync method or file operation that attempts to alter that folder, a message appears telling you it’s locked. This allows you to control when that source or destination is altered.

Compare EXE/DLL versions


Normally when files with the extension .EXE or .DLL are encountered during the comparison stage of the process, their version info is extracted and subsequently used in comparisons. This checkbox can be toggled off if you’d prefer not using version info as the means to compare executable files, and when off, such files are compared using their modified date and time instead.

Revision destination files


As mentioned previously, revisioning creates backups or revisions of destination files altered by file operations and sync methods. This process occurs when the source folder is locked, revisioning is enabled, the file comparison status is newer, older, or matching, and the destination file is going to either be overwritten or deleted by the file operation.

Exclusions

See Configuring Exclusions below for more info.

Saving Profiles

To save a new profile, select Profile > Save or Profile > Save As. Either menu item will display the Save Profile form. Enter a name and click Save to save the profile to the “C:\Users[username]\Documents\Sync2FoldersPro” folder.



Note that if a profile has been previously saved, Profiles > Save saves the profile to the existing filename, but the profile will automatically save if you close Sync2Folders Pro or select Profiles > New or Profiles > Load.

Please note that when saving and renaming a profile, only the following characters are allowed for the profile name:

Space, dash, underscore, and comma characters as well as the characters a-z, A-Z, 0-9, &, %, $, #, @, !, ‘, (, and ).

Loading Profiles

To load a profile, select Profile > Load and Manage, which displays the Load and Manage Profiles form. This displays all profiles, with the full details of each one. Double-click a profile or select one and click Load to load it into Sync2Folders Pro.


Renaming Profiles

To rename a profile, select Profile > Load and Manage, select the profile you wish to rename, and click Rename. This prompts for a new profile name. Enter the new profile name and click Rename. This renames all of the files associated with the current profile.
Please note that when saving and renaming a profile, only the following characters are allowed for the profile name:

Space, dash, underscore, and comma characters as well as the characters a-z, A-Z, 0-9, &, %, $, #, @, !, ', (, and ).


Duplicating Profiles

To create a duplicate of a profile, select Profile > Load and Manage, select the profile you wish to duplicate, and click Copy. This prompts for a new profile name. Enter the new profile name and click Save. This creates a complete copy of the current profile.
Please note that when saving and renaming a profile, only the following characters are allowed for the profile name:

Space, dash, underscore, and comma characters as well as the characters a-z, A-Z, 0-9, &, %, $, #, @, !, ', (, and ).


Deleting Profiles

To delete a profile, select Profile > Load and Manage, select the profile you wish to delete, and click Delete. Select Yes to delete all of the files associated with the current profile.

Configuring Exclusions

To edit exclusions, select Profiles > Manage Excluded. This displays the following form:

Add, edit, and delete folder, file, extension, and RegEx exclusions.


Use the tabs to exclude files, folders, extensions and regular expressions.

Filenames

A filename shouldn't include any path information. Valid filename examples: Desktop.ini, web.config, A Day In the Life.mp3.

A filename exclusion requires an exact match, although it ignores case.

Folders

A folder shouldn't include any path information. Valid folder examples: temp, Windows, Program Files (x86).

A folder exclusion requires an exact match, although it ignores case.

Extensions

An extension can include the dot or exclude it. Valid extension examples: ini, .exe, .mp3

An extension exclusion requires an exact match, although it ignores case.

RegEx

Regular expressions are used for pattern matching. They are powerful and versatile, and there are many tutorials on the Internet that can help you to understand them. There are also great online RegEx testers that do a great job of helping you write regular expressions. Please check the Internet for more help.

Regular expression exclusions do NOT require an exact match. If a regular expression has a partial match, it is a valid match.


Editing Exclusions

To add a new item to a list, type in the text field and click Add or press the Enter key.

To edit an item, select it from the list and click Edit. Make the necessary changes and then add the item back to the list using Add or the ENTER key.

To remove an item, select it and press the DELETE key or click Delete.

Notes

Regular expression exclusions are applied to files and folders, so all filenames and folder names are evaluated. They are evaluated against the entire path of the current folder or file.

Folder exclusions only compare against the current folder, not the entire path.

Where file, folder, and extension exclusions must be an exact match, regular expressions can be a partial match.
Keyboard Shortcuts
There are some keyboard shortcuts to simplify adding exclusions for files, folders, and extensions. From the file comparison list, select one or more files. Next, use the following keyboard shortcuts to add exclusions based on the selections:

Note that Shift-Ctrl-P only adds the last folder in the source and destination folders to the excluded folders list. For example, if the current path is “C:\Temp\my_test_files”, it adds “my_test_files” to the folder exclusions.

Exclusions Disabled Indicator

When the indicator, "Exclusions are currently disabled.", displays above the file comparison list, it means the "Disable exclusions" option is checked. When exclusions are disabled, they are not loaded or used during comparison.


Comparing the Source and Destination Folder

How to Compare

To compare the source and destination folders, click Compare. This searches both folders for files, comparing the files for differences. It compares two aspects of each file:

In the case of an executable, if the version number of the source file is greater than that of the destination, the file is considered Newer. If the version of the source file is smaller than the destination, the source file is considered Older. If the version info matches, the files are considered Matching.


IMPORTANT NOTE:

Extracting version info from .EXE and .DLL files is slower than simply comparing the modified date and time. The Compare EXE/DLL versions setting is on by default because it’s the preferred way to compare executable files, but it’s worth considering this slowdown if you are comparing tens or hundreds of thousands of files and want to reduce the time it takes. Similarly, using compact mode and turning off logging can also speed up comparisons.

Determining What’s New, etc.

If a file is found in the source folder structure but not the destination’s, it’s considered to be New (Source: New). The source file is “new” in relation to the destination file.

If a file is found in the source and destination folder structures, but the source file’s modified date/time is newer and/or the version info is greater (has a higher version number), than the destination’s, the file is considered to be Newer (Source: Newer). The source file is “newer” in relation to the destination file.

If a file is found in the source and destination folder structures, but the destination file’s modified date/time is newer and/or the version info is greater (has a higher version number) than the source’s, the file is considered to be Older (Source: Older). The source file is “older” in relation to the destination file.

If a file is found in the destination folder structure but not the source’s, the file is considered to be Missing (Source: Missing). The source file is “missing” in relation to the destination file.

If a file is found in the source and destination folder structures, and the source file’s modified date/time or the version info are the same as the destination’s, the file is considered to be Matching (Source-Dest: Match). The source file and the destination file match in relation to one another.

Notes

Comparison Statuses

Comparison statuses describe the source file in relation to the destination file.

Here are all the possible comparison statuses:


Comparison Status Definition
Source: New File exists in the source folder but not the destination
Source: Newer Source file's version or modified date and time is newer then the destination's
Source: Older Source file's version or modified date and time is older then the destination's
Source: Missing File exists in the destination folder but not the source
Source-Dest: Match Source file's version or modified date and time matches the destination's

The File Comparison List and Context Menu

The file comparison list displays all of the files that are part of the current profile. It only shows those files that are included by the File Spec, and not excluded by the file, folder, extension, and RegEx exclusions. If the comparison was canceled before it completed, it might not show all of the files it would have had the comparison been able to.

The context menu displays all of the file operations as well as three additional menu items:

Managing Revisions

The Manage Revisions form.

The Manage Revisions form displays information on the selected source file and lists the destination file, if it exists, as well as all revisions. It includes the following information:

To manage the destination file or revisions, right-click the list, which displays the following menu items:

Menu Item Definition
Copy Selected File to Source Only available with a single selection - Copies the selected destination file or revision to the source folder
Copy Selected File to... Only available with a single selection - Prompts for a folder then copies the selected destination file or revision to the selected folder
Delete Destination File Only available with a single selection when Type is Destination File - Deletes the destination file and optionally, all revisions
Delete Selected Revision Only available with a single selection when Type is Revision - Deletes the selected revision
Delete All Revisions Only available when there is no selection - Deletes all files of Type Revision
Explore Selected File's Folder Only available with a single selection - Opens File Explorer to the file's folder
Pass Selected Files to Third Party Apps Only available when two files are selected - Passes the two files to the Manage Third Party Apps form
Pass Source and Selected File to Third Party Apps Only available with a single selection - Passes the source file and the selected file to the Manage Third Party Apps form


Using Manage Revisions

While creating revisions is an automated process that occurs when using file operations and sync methods, what you do with revisions is up to you. The available menu items on the Manage Revisions context menu provide the tools to restore (copy) revisions, compare (using third party apps) revisions, examine (using explore) revisions, as well as delete them. With these it’s possible to find revisions of files that have changed over time.

So while revisions provide back ups of what might be important files, it’s necessary to use these tools to make sense of what is backed up so you can, for example, restore an earlier version of an important document.

Please note that when revisioning is enabled, it has a performance impact as it has to take the time to revision files.

Launch a Third Party App

As mentioned in the Options Menu section, once a third party application has been configured, you can select a file in the list then press Ctrl-L to launch the app, passing as command-line parameters the paths and filenames of the two files. The application has to then deal with the command-line arguments.
In this example, the third party application that's configured is Compare JPEG Tags, a MaxLeafSoft application that takes two filenames of JPEG (.JPG) files as its command-line arguments and compares the file's tags. Any application that accepts filenames as their command-line arguments can be used, so if you have a favorite app to compare files for content differences, for example, that can be configured as the external app.


The configured external app is launched, and the source and destination files passed it as command-line arguments.
If a single third party app is configured, when Ctrl-L is used, that app is immediately launched. If more than one is configured, though, the Manage Third Party Apps form is displayed, along with the current file's filename, source folder, and destination folder. Select an app from the list and click Launch to pass the filename(s) to the selected app and run the app.

When brought up with the keyboard shortcut Ctrl-L, the Manage Third Party Apps form displays the current Filename, Source, and Dest folders, as well as the list of third party apps that have been configured.
Regardless of how you get to the Manage Third Party Apps form, you can use it to add, edit, and delete third party apps.


How Sync Methods Are Related to File Operations

A file operation is the lowest level operation Sync2Folders Pro is capable of performing and it comes down to performing one of two things:

A sync method, on the other hand, assigns file operations to particular comparison statuses, and when you select a sync method, it examines every file in the file comparison list and decides which file operation to perform based on the comparison status of that file.
Some comparison statuses are assigned None, meaning, do not perform a file operation on a file with this comparison status, whereas others are assigned file operations to copy a source file to the destination, copy a destination file to the source, delete the source file, or delete the destination file.


Using Sync Methods and File Operations

There are two tools at your disposal for synchronizing files: Sync Methods and File Operations.
Sync Methods To make this point entirely clear, sync methods are powerful commands that are applied to the entire file comparison list, even those files not currently visible because a filter isn’t showing them. The reason for this is because a sync method goes through every file, checks its comparison status, then makes a decision on which file operation to apply based on that status.

Whether using one of the built-in sync methods or one you’ve customized, the properties of that sync method determine whether files are going to be copied, deleted, or will be unaffected. This makes sync methods extremely powerful, with the potential to quickly synchronize files but also with the potential to delete or overwrite files.

Use sync methods carefully! Before committing to using one, make sure you understand what it’s doing.

Please note that if a sync method is selected but the current profile hasn’t been compared, you will be prompted by Sync2Folders Pro whether you’d like to compare then automatically perform the synchronization.

If you attempt to use a sync method and it can potentially alter the source or destination, and that folder is locked, the sync will be aborted and a message to that affect will display.

File Operations File operations, on the other hand, can only affect those files you’ve selected, and apply the same action to every file. If you select some files and choose to “Delete Source File”, for example, then all of the selected files are deleted from the source folder structure. But no other actions are taken, so what occurs is well defined and very predictable.

If you attempt to use a file operation and it can potentially alter the source or destination, and that folder is locked, the file operation will be aborted and a message to that affect will display.

Logging

Sync2Folders Pro include many logging options which are detailed above in the section concerning the Options Menu. This section provides a little more information, but mostly covers how errors are logged.

Performance Impact

Note that with logging enabled Sync2Folders Pro will be less performant as it will write to disk as it compares and syncs files.

Log Location and Filename Format

The Logs folder is located here:

“C:\Users[username]\Documents\Sync2FoldersPro\Logs”

Comparison and exclusion info are logged to the Comparison Log. This log’s filename starts with the text “ComparisonLog”. The filename then includes an underscore character, the date and time, and has the “.txt” extension.

For example:

ComparisonLog_2019112811063714.txt is for the date 11-28-219 and has the time 11:06:14.14.

Synchronization info is logged to the Sync Log. This log’s filename starts with the text “SyncLog”. The filename then includes an underscore character, the date and time, and has the “.txt” extension.

For example:

SyncLog_2019120609233224.txt is for the date 12-06-2019 and has the time 09:23:32.24.
Error Handling Errors can occur when Sync2Folders Pro is attempting to compare or synchronize files, and those errors are written to the ComparisonLog and SyncLog, respectively. Error messages refer to the files and folders where the errors occurred, as well as exceptions that occurred, and provide information needed to troubleshoot such issues. In some situations the errors can be ignored, others might prompt adding exclusions to skip problematic folders or files, or it might be necessary to edit folder and/or file permissions to allow access.

Keyboard Shortcuts

Add to Exclusions

Shift-Ctrl-P - Add the folders of the selected files to the excluded folders list
Shift-Ctrl-F - Add the filenames of the selected files to the excluded files list
Shift-Ctrl-E - Add the extensions of the selected files to the excluded extensions list


Search

F3 - Search for the next Filename, File Extension, Modified Date/Time, Version or Folder using the current search criteria
Ctrl-N - Search for item with comparison status Source: New
Ctrl-Shift-N - Search for item with comparison status Source: Newer
Ctrl-O - Search for item with comparison status Source: Older
Ctrl-M - Search for item with comparison status Source: Missing
Ctrl-Shift-M - Search for item with comparison status Source-Dest: Match


Selection

Ctrl-A - Select all items
Ctrl-P - Select all items with the same source path as selected
Ctrl-F - Select all items with the same filename as selected
Ctrl-E - Select all items with the same extension as selected
Ctrl-S - Select all items with the same comparison status as selected


Launch

Ctrl-L - Launch Selected File(s) in External Application

Compact Mode

Ctrl-Shift-C - Toggle compact mode on and off

Change Logs

Here are the bug fixes, enhancements, and other changes made for Sync2Folders Pro Version 1.21:

Bug Fixes:

-The synchronization report always incorrectly reported 0 file operations on matching files

Here are the bug fixes, enhancements, and other changes made for Sync2Folders Pro Version 1.2:

Bug Fixes:

-When the Manage Filters form was accessed then closed, even if the currently selected filter hadn’t changed, the file comparison list would unnecessarily refresh. Now the list won’t refresh as long as the current filter still exists and is unchanged
-If files, folders, and/or extensions were added using the keyboard shortcuts, the excluded hint was not updated to reflect the correct number of exclusions

Enhancements:

-Added new context menu item, “Create New Profile from Selection”, which creates a new profile using the source and destination folders of the selected file

-Added new context menu item, “Populate Source and Dest Folders from Selection”, which replaces the current profile’s Source and Destination field values with the source and destination folders of the selected file

-Added revisions feature, which adds:

New Property for Profiles:

New Revisions column in file comparison list:

New file comparison list context menu item:

New filter in Manage Filter form:

New search menu item:

NOTE: The Manage Revisions form and all existing revisions are accessible even when revisioning is disabled

Changes:

-Now all sync methods are enabled in the Sync Methods menu even if the current profile hasn’t been compared. If a sync method is selected, a prompt displays asking if you’d like to perform the comparison and then automatically sync
-The completion messages that are optionally displayed when a comparison or file sync operation completes now include file counts
-Now when the keyboard shortcuts are used to exclude a file, folder, or extension, a message displays to indicate they were added
-The Profile menu’s “Load” menu item has been renamed to “Load and Manage” and selecting it displays all profiles, their details, and provides buttons to load and manage (rename, copy, delete) them
-The Profile menu’s “Save As” menu item has been replaced by the Copy button in the Load and Manage Profiles form
-The Profile menu’s “Rename” menu item has been replaced by the Rename button in the Load and Manage Profiles form
-The Profile menu’s “Delete” menu item has been replaced by the Delete button in the Load and Manage Profiles form
-The underscrore (“_”) is now an allowed character for profile names
-Milliseconds are no longer displayed in the file comparison list
-Milliseconds are no longer considered when comparing files
-The File Sync Operation form is now sizeable
-The columns in the File Sync Operation form’s list are now automatically sized for the content
-Column sorting has been improved in the file comparison list
-New sync methods now default all comparison methods to the file operation setting “None”

Here are the bug fixes, enhancements, and other changes made for Sync2Folders Pro Version 1.1.2:

Bug Fixes:

-Using the Profile “Save As” menu item would silently fail for saving new profiles
-Saving new profiles was not updating the name of the profile in the title bar of Sync2Folders Pro

Here are the bug fixes, enhancements, and other changes made for Sync2Folders Pro Version 1.1.1:

Bug Fixes:

-Saving profiles were broken but are now functional again

Here are the bug fixes, enhancements, and other changes made for Sync2Folders Pro Version 1.1:

Bug Fixes:

-The exclusion indicator was not updating after using Profiles > Manage Exclusions
-Sometimes the File Operations menu items did not enable/disable correctly when the file comparison list was empty

Enhancements:


-Added Profile > Rename to rename the currently loaded profile
-Added Profile > Delete to delete the currently loaded profile
-Added File Operations > Delete Source and Destination Files to delete both the source and the destination file in one file operation
-Added new category, “File Operation for Matching”, to Manage Sync Method form. This allows files to be copied or deleted when their comparison status is matching
-Added new file operation, “Delete both files”, to Manage Sync Method form. This allows the source and destination files to both be deleted at the same time. This is available for comparison statuses of Newer, Older, and Matching
-Added Edit button to each tab of the Manage Excluded form to edit the currently selected item
-Added Options > Manage Third Party Apps to manage one or more third party applications to launch from Sync2Folders Pro. This replaces the previous Options > Configure External Application Support. Now, instead of storing a single app and its command-line parameters in the config file, multiple are maintained in a new file, ThirdPartyApps.xml, found in the “Sync2FoldersPro” folder in “C:\Users[username]\Documents”. See online help for complete documentation on this and the other enhancements in Verison 1.1
-Now parameters for command-line options for third party apps can be typed in or added by selecting parameters from the Parameters list
-Added new option, “Display completed messages”, which defaults to ON, but when OFF, suppresses messages normally displayed when comparison results complete or a synchronization completes using a file operation or sync method

Changes:


-Renamed Profiles menu to simply “Profile”
-Moved confirmation options into the Display grouping in the Sync2Folders Pro Options form and removed the Confirmations grouping entirely
-Widened the Manage Excluded form
-Previously, the Delete button in the Manage Excluded form did not disable when there wasn’t a selection. Now it does
-Now only the space, dash, and comma characters as well as the characters a-z, A-Z, 0-9, &, %, $, #, @, !, ‘, (, and ) are allowed in profile names

Sync2Folders Pro Support

If you have questions, comments, suggestions, or with to report any issues, please check the MaxLeafSoft website, our Twitter account, or e-mail our support.

Sync2Folders Pro is available to download from the Microsoft Store on device running Windows 10. Please note that Version 1.1 may not be available until closer to the end of 2019.


Home