Skip to content

Support

Michal Zelinka edited this page Apr 10, 2020 · 4 revisions

A short intro to grsyncx

grsyncx is developed to be an easy-to-use synchronize and backup tool. The main purpose is to ease the use of rsync (stable and very well tested UNIX tool) and synchronize files on your Mac to backup location. And of course restore files from such locations as well. It's not required to know rsync but it will ease the use and understanding of grsyncx. But it is though, possible to use grsyncx by just filling in a source and destination paths using the default parameters.

Main window of grsyncx

If your plan is to use grsyncx as your main tool for backup of files, please investigate and understand the limits of it. grsyncx is very easy to use, yet having quite a lot of options to toggle, but it's not primarily meant to be a Time Machine alternative due to the extended features set Time Machine has. If making a one-time, 1:1 clone of your data is the right way you desire to handle the data, you can use grsyncx with no hesitation.

Before you start

grsyncx is a sandboxed (if installed from the Mac App Store) macOS app and the first to do is ask for permission to read certain locations. This can be set up in System PreferencesSecurity & PrivacyPrivacy tab → Full Disk Access by adding the app to the list.

Executing synchronization tasks

As easy as the application UI is, the only required steps to perform is picking a Source and Destination locations to be used for synchronization process.

Any additional settings you may want to use can be picked using the respective checkboxes. If you're unsure about a meaning of any particular option, feel free to hover the mouse cursor over it to invoke a tooltip with a brief description.

Caution: if you're unsure about the impact your chosen setup may end, feel free to perform a Simulated run first. This can be accessed by pressing a Chess figure button in the app window's title bar.

Simulated run button

Please pay attention to the info in the display when the simulate run is completed. A drop down display presents the result.

When all options are set, you can exetute the synchronization using the Play button in the app window's title bar.

Synchronization execution button

All tasks can be aborted at any time by selecting the Stop button.

Synchronization progress

Reporting issues

Having any issue, feedback or question, feel free to file an issue on project's issue tracker on GitHub.

Clone this wiki locally