Differences
This shows you the differences between the selected revisions of the page.
| ui_synchronize 2024-02-15 | ui_synchronize 2025-12-26 (current) | ||
| Line 16: | Line 16: | ||
| The //Delete files// checkbox makes WinSCP delete files and subdirectories in target directory that are not present in a source directory. The option is not available for //Both// direction, because then such files and subdirectories are always considered as new and transferred into the opposite directory (unless //Existing files only// is checked).((If you want to synchronize file removals, install an extension [[library_example_two_way_synchronize_delete|*]].)) Deleted local files are moved to recycle bin if preference option //[[ui_pref_panels#common|Delete local files to recycle bin]]// is enabled only. | The //Delete files// checkbox makes WinSCP delete files and subdirectories in target directory that are not present in a source directory. The option is not available for //Both// direction, because then such files and subdirectories are always considered as new and transferred into the opposite directory (unless //Existing files only// is checked).((If you want to synchronize file removals, install an extension [[library_example_two_way_synchronize_delete|*]].)) Deleted local files are moved to recycle bin if preference option //[[ui_pref_panels#common|Delete local files to recycle bin]]// is enabled only. | ||
| - | The //Existing files only// checkbox makes WinSCP not to consider files and subdirectories not existing in an opposite directory as new. Such files and subdirectories will be ignored. | + | The //Existing files only// checkbox makes WinSCP not to consider files and subdirectories not existing in the opposite directory as new. Such files and subdirectories will be ignored. |
| The //Preview changes// checkbox makes WinSCP display [[ui_synchronize_checklist|synchronization checklist]] to allow you to further refine what changes you want to actually make. | The //Preview changes// checkbox makes WinSCP display [[ui_synchronize_checklist|synchronization checklist]] to allow you to further refine what changes you want to actually make. | ||
| Line 25: | Line 25: | ||
| The section defines criteria for determining whether two files (local and remote) are the same or not. | The section defines criteria for determining whether two files (local and remote) are the same or not. | ||
| - | With //Modification time// checked (default) two files are considered different when they have different timestamps. | + | With //Modification time// checked (default), two files are considered different when they have different timestamps. |
| - | With //File size// checked two files are considered different when they have different sizes. The option is not available with //Both// direction selected. When using the option, you should avoid [[transfer_mode|text transfer mode]] as it may change the file size. | + | With //File size// checked, two files are considered different when they have different sizes. The option is not available with //Both// direction selected. When using the option, you should avoid [[transfer_mode|text transfer mode]] as it may change the file size. |
| - | With //Checksum// checked two files are considered different when they have different checksums. The option is not available with //Both// direction selected. Requires [[protocols#checksum|support for calculating checksum]]. SHA-256 checksum is used by default, with automatic fallback to SHA-1, when not supported. | + | With //Checksum// checked, two files are considered different when they have different checksums. The option is not available with //Both// direction selected. Requires [[protocols#checksum|support for calculating checksum]]. SHA-256 checksum is used by default, with automatic fallback to SHA-1, when not supported. |
| When //Modification time// is checked along with any other the other two, it has higher priority. As a consequence, in the default //Synchronize files// [[task_synchronize_full#mode|synchronization mode]], a file is not considered updated, despite having different size or checksum, if the source file is older than the destination file. | When //Modification time// is checked along with any other the other two, it has higher priority. As a consequence, in the default //Synchronize files// [[task_synchronize_full#mode|synchronization mode]], a file is not considered updated, despite having different size or checksum, if the source file is older than the destination file. | ||
| Line 53: | Line 53: | ||
| To change the settings, use //Transfer settings// button to show [[ui_transfer_custom|Transfer Settings dialog]] (alternatively you may click //Transfer settings// box). Clicking drop-down icon on the button reveals menu with list of configured [[transfer_settings#presets|presets]]. Command //Configure// opens Preferences dialog on //[[ui_pref_transfer|Transfer page]]//. | To change the settings, use //Transfer settings// button to show [[ui_transfer_custom|Transfer Settings dialog]] (alternatively you may click //Transfer settings// box). Clicking drop-down icon on the button reveals menu with list of configured [[transfer_settings#presets|presets]]. Command //Configure// opens Preferences dialog on //[[ui_pref_transfer|Transfer page]]//. | ||
| - | You may want to change transfer settings particularly to [[ui_transfer_custom#other|exclude certain files and subdirectories]] from synchronization. Although the [[file_mask|file mask]] is part of transfer settings, in context of synchronization it affects also file deletion. | + | ==?file_mask== You may want to change transfer settings particularly to [[ui_transfer_custom#other|exclude certain files and subdirectories]] from synchronization. Although the [[file_mask|file mask]] is part of transfer settings, in context of synchronization it affects also file deletion. |
| ===== [[new_window]] Starting in New Window ===== | ===== [[new_window]] Starting in New Window ===== | ||
| In the drop-down menu of the //OK// button, you can also start synchronization in a separate window, to avoid blocking the current window. | In the drop-down menu of the //OK// button, you can also start synchronization in a separate window, to avoid blocking the current window. | ||
| + | |||
| + | An alternative is to [[ui_synchronize_checklist#background|push synchronization actions into background queue]] from the Synchronization checklist window. | ||