Documentation

Welcome to SyncBelt! In this guide you will find detailed information about this application; how it works and how to set it up, among others.

SyncBelt is a folder synchronization program: sync folders easily, without having to manually log in to your servers every time.

SyncBelt is really easy to install and use. There are no special requirements, no dependencies and no restrictive hardware limitations, except for a basic list of minimum requirements as seen below.

Check the how to... section, in case you need help, or contact us for assistance.

This documentation is valid for SyncBelt v2, available at syncbelt.com.

Requirements

The requirements below list the minimal configuration. Any better hardware or newer software may be used. If you experience problems nonetheless, please do not hesitate to contact us.

Software
  • Windows 10 (64-bit)
  • Windows 11 (64-bit)
Hardware
  • 1 gigahertz (GHz) or faster processor
  • At least 2 GB of memory
  • 20MB available disk space
Web Browser
  • Firefox
  • Chrome
  • Microsoft Edge

Installation

To install SyncBelt, execute syncbeltsetup.exe and follow the directions that appear on screen. If an old version is found, it will be automatically upgraded. Old settings are preserved when possible.

Upgrading

To upgrade SyncBelt, install the new version without uninstalling your old copy. If an old version is found, it will be automatically upgraded, when possible.

Uninstallation

To uninstall SyncBelt, open Windows Settings, locate Apps & features, select SyncBelt and click on Uninstall.

Setup

After the installation is over, SyncBelt runs on your system, ready to work. SyncBelt is web-based, which means you need to open it on your web browser. To open SyncBelt point your browser to http://localhost:2350 or http://127.0.0.1:2350.

  • SyncBelt requires a web browser to work, but it is not in the cloud
  • SyncBelt must be manually installed

License

Syncbelt v2 is licensed under a Creative Commons Attribution-NoDerivatives 4.0 International Public License. If you use and enjoy SyncBelt, let us know! 🎉

Projects

Create projects to manage your synchronization folders. SyncBelt allows you to create up to 15 projects.

To create a new project, click and enter your project details.

First, we will configure the folder of Origin, on the left side of the screen:

  • Decide if you wish to sync from a local or remote folder, by clicking on the Protocol box. Select either Local, SFTP or FTP.
  • Enter the folder from where files will be copied.
  • If the folder is a remote server, enter the server address and port, with username and password, if required. Click the Test Connection button to check your server details.

Now, move to the right side and repeat the same process to configure the folder of Destination. Click Save when finished.

Your first project is now ready. Check the Project Summary at the top. By default, files are synchronized by modification date, no destination files are deleted and no files are skipped. If you wish to modify the defaults, click on Edit and then click Advanced at the bottom of your project.

Advanced options allow you to modify your project's defaults:

  • Determine if a file has changed by: allows you to set the file comparison method to by file modification date or file size, or alternatively do not compare and always copy.
  • Orphaned files in destination must be: allows you to decide if destination files that do not exist in origin should be deleted in destination, or ignored.
  • Skip files matching the following rule: allows you to skip files that match the chosen rule.

After making changes to your project, check again the Project Summary at the top to make sure everything is configured as desired.

If you need to delete a project, open the Edit menu, select Delete and click Confirm.

Syncing

In order to synchronize a folder, first you'll need to create a project. Once you have a project, open it and click Start at the bottom to begin.

The synchronization process has 4 different steps:

  • Simulation: during this step, SyncBelt executes your project and compares origin and destination files. Nothing is actually done, yet.
  • Review: on this step, SyncBelt is ready to sync and shows you a list of files based on the simulation results. Now, you know what will exactly happen with each individual file and still can make changes. When you are ready, click Sync Files.
  • Syncing: on this step, SyncBelt synchronizes files based on the selected data on the previous step.
  • Results: on this final step, SyncBelt shows you a brief summary of what happened. For more details open the Report menu and click on View Report or Export as CSV.

The Review step is the most important one. Double-check the list of files to make sure the synchronization process will proceed as expected. Files are checked or unchecked based on their resolution:

  • Checkbox: Indicates if the file should be copied/deleted (checked) or ignored (unchecked).
  • File: Name of the file, including path.
  • Size: File size, including icons to indicate if the file is bigger in Origin (▲), smaller in Origin (▼) or equal (=).
  • Resolution: A short sentence explaining what will happen with the file, which can be overridden: checked files will be copied/deleted, unchecked files will be ignored.

For resolutions, the source file (origin) is always the reference. Take this into account when interpreting the presented information.

  • Unmodified: Origin and Destination files are equal. Origin file will not be copied. Check to override resolution and copy anyway.
  • Orphan: Destination file/folder does not exist in Origin. Destination file/folder will be deleted. Uncheck to avoid deletion.
  • Modified: Origin file is different than Destination's and will be copied. Uncheck to skip.
  • New: Origin file does not exist in Destination and will be copied. Uncheck to skip.
  • Skipped: Origin file will be skipped based on a rule. This resolution cannot be overridden. Revisit your rule to obtain a new resolution.

Comparing

During synchronization, you'll be able to compare files before proceeding which allows you to see specific differences between files.

After the simulation process has ended, you'll find this symbol to the right side of some files. Click on it to compare. These are the requirements in order to be able to compare files:

  • Different size/time: files must have a different size or modification time.
  • Text extension: only text files can be compared.
  • 1MB: only files smaller than 1MB can be compared.

Rules & Permissions

Rules are helpful to skip files during synchronization. For example, you may want to skip .tmp files or .git folders.

To create a rule, click on the Rules link at the top of the screen and then click on the New Rule button. Rules must include a set of conditions:

  • File size: this condition is triggered when a file is equal/greater than/less than a specific number of bytes/KB/MB/GB.
  • File name: this condition is triggered when a file name is/begins with/ends with/contains a specific text.
  • Folder name: this condition is triggered when a folder name is/begins with/ends with/contains a specific text.

By default, rules require any condition to be met in order to be triggered, but you can change it to all conditions, at the top of your rule. Use the X button at the right side of each rule to remove it.

Unix-style permissions can be optionally applied to files after synchronization. Permissions only apply to remote servers and can be configured from the Rules screen. Use the X button at the right side of each permission to remove it.

To create a permission, click on the Rules link at the top of the screen, then click on the Permissions tab and then click on the New Permission button. Enable or disable permission settings by clicking on each button.

  • Permissions are applied based on file extension.
  • By default, files synchronized via FTP/SFTP have the following permissions: User: Read & Write, Group: Read, World: Read.
  • By default, folders synchronized via FTP/SFTP have the following permissions: User: Read & Write & Execute, Group: Read & Execute, World: Read & Execute.

How to...

Create a new folder

Edit your project and click on , next to the folder path box. On the Select Folder window, select a folder and click on at the top right corner of the window. Type the folder name and press Enter to save, or Esc to cancel.

Compare folders without making changes

Create a new project and then click Start at the bottom. SyncBelt will show you a list of files with all the details. Click Cancel when finished.

Skip a folder or file when synchronizing

First, create a new rule and then edit your project and select the rule in the Advanced section at the bottom of the screen.

Duplicate a project

Open the desired project, then open the Edit menu and select Duplicate.

Duplicate a project as mirror

Open the desired project and click on

Compare files before syncing

Open a project and click Start. After the simulation step is done, you'll be presented with a list of files. Simply click on next to a file to compare origin and destination.

Export and import data

Go to Help and click on the Data button. Then select Export to save your sites and rules into a file. And select Import to import a previously saved data file with your sites and rules.

Privacy

This privacy statement refers to the product SyncBelt. Please, check our online privacy statement for complementary information.

What information does Anfibia Software collect regarding SyncBelt?

SyncBelt is not an online service. SyncBelt is self-hosted software. The software is installed on your computer, and only you have access to it. We only collect the following anonymous data upon installation: country, operating system and product version.

What is done with the information?

We use anonymous data to keep track of product usage for product developement purposes.

How is my information protected?

The SyncBelt website and server use industry standard protocols to protect all information obtained including SSL encryption (secure socket layers), and hardware firewalls.

Why and how does SyncBelt use cookies?

SyncBelt does not use cookies.

How is SyncBelt protected from remote intrusions?

SyncBelt does not work remotely, only locally. SyncBelt does not require an internet connection to work.

What if I have a question or problem related to my privacy?

Please contact us at privacy@anfibia.net.

Consent

You must consent to this privacy policy to use SyncBelt.

EULA

End-user Software License Agreement

Notice to users: Carefully read the following legal agreement. Use of the software ("SyncBelt v2") provided with this agreement (the "software") constitutes your acceptance of these terms. If you do not agree to the terms of this agreement, do not install and/or use this software. User's use of this software is conditioned upon compliance by user with the terms of this agreement.

1. License grant. This software is licensed under a Creative Commons Attribution-NoDerivatives 4.0 International Public License.

1.1 Software misuse. This software should never be installed, or used, without the PC administrator's consent. This software is designed for use when any required consents have been obtained. Anfibia Software declines all responsibility concerning any illicit usage.

2. Ownership. The software is owned and copyrighted by Anfibia Software. Your license confers no title or ownership in the software and should not be construed as a sale of any right in the software.

3. Copyright. The software is protected by European copyright laws and international treaty provisions. You acknowledge that no title to the intellectual property in the software is transferred to you. You further acknowledge that title and full ownership rights to the software will remain the exclusive property of Anfibia Software and you will not acquire any rights to the software except as expressly set forth in this license. You agree that any copies of the software will contain the same proprietary notices which appear on and in the software.

4. Reverse engineering. You agree that you will not attempt to reverse compile, modify, translate, or disassemble the software in whole or in part.

5. No other warranties. Anfibia Software does not warrant that the software is error free. Anfibia Software disclaims all other warranties with respect to the software, either express or implied, including but not limited to implied warranties of merchantability, fitness for a particular purpose and noninfringement of third party rights. Some jurisdictions do not allow the exclusion of implied warranties or limitations on how long an implied warranty may last, or the exclusion or limitation of incidental or consequential damages, so the above limitations or exclusions may not apply to you. This warranty gives you specific legal rights and you may also have other rights which vary from jurisdiction to jurisdiction.

6. Severability. In the event of invalidity of any provision of this license, the parties agree that such invalidity shall not affect the validity of the remaining portions of this license.

7. No liability for consequential damages. In no event shall Anfibia Software be liable to you for any consequential, special, incidental or indirect damages of any kind arising out of the delivery, performance or use of the software, even if Anfibia Software has been advised of the possibility of such damages. In no event will Anfibia Software's liability for any claim, whether in contract, tort or any other theory of liability, exceed the license fee paid by you, if any.

8. Governing law. This license will be governed by the European law. The united nations convention on contracts for the international sale of goods is specifically disclaimed.

9. Entire agreement. This is the entire agreement between you and Anfibia Software which supersedes any prior agreement or understanding, whether written or oral, relating to the subject matter of this license.

SyncBelt Copyright © 2023 by Anfibia Software.