Restore data

Restore either files or complete synchronized files is easy in RsyncUI. A restore has to be executed to a temporary restore path. This is to secure not destroying any original data. A restore session might be as follows. Selecting and filtering First of all select from which configuration to restore from. After selection select the Files button and RsyncUI collects filenames of all synchronized data. Filter of data either by adding filter in top right search field before selecting the Files button or within the Files view.

Rsync and other settings

You can any time save the current configuration files by the Backup button. The backup button executes a copy of all configuration files into your Documents catalog and postfixes the copy with a timestamp -month-day-year/hour/minute. $HOME/Documents/RsyncUIcopy-05-06-2021/08/21 Caution: when opening the catalog it might be seen as empty. The copy is a .catalog and your filebrowser might not see such catalogs. Rsync version and path It is adviced to install rsync as part of Homebrew.

SSH settings

In this view you can let RsyncUI assist in creating ssh-keys and setup global ssh keypath and identityfile, either utilizing default values or set your own. There is some more info about ssh. Local ssh keys found If on RsyncUI has found local ssh keys. Default values for ssh are ~/.ssh/id_rsa and portnumber 22. It is not required to set your own values for key path and identityfile if default values are used.

Add and update tasks

Caution: always verify, by a dryrun, the result of a new task before executing it. A task require minimum a local catalog and a remote catalog. After entering information about a task, select the Add button to add it to RsyncUI. Continue adding new tasks until completed and tasks are saved to permanent storage after each entry. After adding or changed a task please verify the result by executing an estimation run.

Execute tasks

Caution: after adding new tasks always verify the result of task by selecting the DryRun button. The task view either lets you execute all or selected (by shortcut ⌘S) tasks in one go. Actions are triggered either by keyboard shortcuts or by buttons. The following are allowed shortcut actions: estimate - shortcut ⌘E execute - shortcut ⌘R select/deselct task - shortcut ⌘S show info - shortcut ⌘I Several tasks When RsyncUI starts it automatically open this view and by selecting the shortcut action ⌘R, execute, will commence executing all tasks.

Important

If you are new to the command line tool rsync and RsyncUI please read this information. RsyncUI is a GUI only on top of the command line tool. It is rsync which does actual work, not RsRsyncUI The –delete parameter and new tasks The --delete parameter is a default parameter set by RsyncUI to rsync. The parameter instructs rsync too keep the source and destination in sync. The parameter instructs rsync to delete all files in the destination which are not present in the source.

Pre- and post shell scripts

You can connect shell scripts to a task. A shell script can e.g. be mounting (pre) and unmounting (post) of a remote storage. Or you can execute a shell script to encrypyt your data ahead of synchronizing the data. It is only possible to execute the shell scripts utilizing Single task and the Now button. Tasks are marked if there are shell scripts connected to the task. The shell scripts names and locations is selected by the user.

RsyncUI default parameters

RsyncUI implements default parameters which are working fine for simple synchronize and restore tasks. The actual parameters used in tasks are depended upon executing rsync over network connection or not. Which standard parameters to use is computed during startup of application by reading the configuration file. The user can also remove default parameters if required. Parameters to rsync is saved by task. The ssh parameter might be set global to all tasks.

Signing and notarization

RsyncUI is signed with my Apple ID developer certificate and notarized by Apple. This means that the app is verified and checked for not containing malicious code and it will work with Apples Gatekeeper technology. A message from Apple is issued when opening either a new or updated application the first time. Notarizing is required for all software.