GoodReader can automatically sync
individual files and entire folders to their remote versions hosted on online servers of the
following types: Dropbox
, Google Drive
and also any WebDAV
* or SFTP
There are two different types of sync - normal
sync and download-only
sync. The idea of
sync is to keep the contents of a local file or a folder identical to what you have on a server. The idea of download-only
sync is a convenient distribution of frequently updated
documents to a group of people.
The sync process consists of two parts: initial setup and actual synchronization. Initial setup.
Do this only once per each file/folder you wish to
synchronize. Open a connection to a server, find a file or folder that you wish to sync, tap it so it becomes highlighted. The Sync
button will appear at the bottom. Press it. Then select a target local folder
inside GoodReader where you want this file/folder to be put. Then press the Download here & Synchronize
button. This will create a synchronization record in the Sync Records list and show you the Sync
Parameters window where you can set various sync options. Once you've selected sync parameters, tap the final Sync button.
All relevant remote files will be automatically downloaded to your device when
doing the very first synchronization, so there is no need to run a separate downloading process for this file/folder with the Download
All files and folders that are a part of the sync
process are tagged with a special badge: Actual synchronization.
You execute the sync by tapping the Sync button in the bottom menu of GoodReader's main screen (it's not the same Sync button that
you used for the initial setup), or if you're viewing a file (on iPad only), a Sync button appears at the top right corner of the screen.
This button will execute the sync for all the folders and files with
all the servers that you have set up for synchronization. However, if you only want to sync one record, tap Connect, then tap Sync Records to access individual Sync buttons for each sync record.
A progress popup appears during the sync process. Press the Hide
button to hide this popup and continue the sync in the background. You will be able to continue reading your documents while the
sync is working. Press the Sync
button again to bring back the hidden progress popup. Also, you can press the popup's Schedule
button to set up an automatic periodical sync execution:
. During this process GoodReader analyzes the contents of both local and remote folders and does the following:
- looks for modified files (for example, freshly annotated PDFs) on your device and uploads them to a server, replacing old ones there
- looks for modified files on a server and downloads them to your device, replacing old ones there
- looks for new files on a server and downloads them to your device
- looks for new local files and uploads them to a server
- looks for deleted files on a server that were previously present, and deletes them from your device
- looks for deleted local files that were previously present, and deletes them from a server
. This type of sync doesn't care what happens with your local files, it never puts anything on a server, never deletes anything from it, it only looks for new
remote files and downloads them as needed. By default, files that were deleted from a server will be deleted from your local device. However, you can prevent this from happening by resetting the
Delete local files
switch in the sync record parameters window. In case if you choose to delete such local files, you can also choose whether or not you want to keep modified
local files that were
deleted from a remote server. This option may be useful to preserve your valuable notes that you've put over a PDF file, even if the corresponding remote file was deleted from a server.
When doing a normal sync, be extra careful when deleting files/folders from a synced zone, either on your device or on a server, because this will make GoodReader delete their synced counterparts
during the next sync session. If you accidentally deleted such local file, do not sync
, but rather open a connection to a server, find this file there and manually download it to a local folder where you
accidentally deleted it from.
However, you can prevent this from happening. In the Sync Parameters window, there are two switches: Delete Local Files, and Delete Remote files. Disabling these switches allows you to
prohibit a deletion of local/remote files/folders if the remote/local counterpart is missing at the time of syncing.
If you modify a synced file both locally and on a server independently and then try
to sync it, this will create a sync conflict
, because GoodReader will not know which version of a file to choose. You can set up a policy on sync conflicts per each sync record individually. The following
options are available: Ask what to do
(the default option, you will be able to manually choose an appropriate action per each conflicted file individually during every sync session), Leave
(leaves both files intact, allowing you to deal with this conflict later), Local files have priority
(replaces remote conflicted files with local ones, making you loose remote ones
forever; be careful with this option!!!), Remote files have priority
(replaces local conflicted files with remote ones, making you loose local ones forever; be careful with this option!!!),
Create duplicates (renames both files to avoid further conflicts, leaving you with different versions of file on both your device and on the server. This is the safest option, but be aware that it means the
remote and local files will not be identical).Also, during the actual synchronization, GoodReader may sometimes offer you the Discard this conflict, files are identical
conflict resolution option. Use this
option only if you know for sure that these files are identical.
While every effort was made to ensure data integrity in all abnormal situations (losing Internet connection, manual process abortion, etc.), we
strongly encourage you to take precautions to make sure that the sync process will not be aborted halfway. Sync process is a sensitive one, and it may result in a data loss if used inappropriately. Just keep that in mind, and
everything should be fine.
Important!!! Do not modify
(upload, rename, delete, etc.) your files and folders, both local and remote, while GoodReader performs the actual synchronization. Doing so
may result in a damaged file being transferred and/or inconsistent file/folder structure either on your device, or on your server.