Download
Requested Features
Beta Release

Quick Start Guide



Getting Started Guide
 

This quick start guide is provided to help you get basic sync operations configured. 

BEFORE YOU GET STARTED


** PLEASE READ THIS BEFORE PROCEEDING WITH SYNCING ***

FIRSTMake a backup of your local files you plan to sync with Google Documents. You can also export your data from Google documents as well. This way as you work through how you want KumoSync to sync your local folders with Google documents you will not lose any files. 

SECOND: Many may notice that in Google Documents there are groupings called "collections" which appear to function like a typical folder. These "collections" are not like local file folders and work like tags or categories used as a way to group or classify your documents.

A single Google document can exist in multiple collections whereas on the local file system this is not possible; the same file would need to exist as a _copy_ in each of the local folders.

COLLECTIONS ARE NOT LIKE FOLDERS

If you look at how Google Documents is organized it is really just a single list of files without a "directory" type structure. Google Documents provide a way to create collections structure as a way to organize your documents into groups allowing a single document to be referenced by multiple collections. Obviously, this is very different from how a traditional local file system works. Additionally, Google Document's allows for multiple documents with the SAME NAME to exist in the same collection. This again is something that a traditional local file system does not allow. This furthers the complexity and challenge of syncing Google Documents to a local file/directory structure.

During development of KumoSync we found that attempting to mimic the Google document collection structure as a local file structure was quite problematic and would likely be confusing for many users. It was also very confusing to us which is why we are writing this!

 

We suggest syncing with the "all items" Google Document list with a specific local folder or syncing with a specific Google document collection with a specific local folder. This is the simplest approach to syncing and has the least amount of complexity.

It is possible to sync local subfolders with Google Document collections by enabling the option to sync sub-folders/collections. It's important to take note that Google Documents allows for multiple documents with the same name and the same document can exist in multiple collections. Local file systems do not support either of these cases.
   

CONFIGURING THE SYNC PROCESS
 

Once KumoSync is installed you'll find a KumoSync icon in the windows system tray that allows you to control the overall sync process including manually performing the sync, editing your settings, and quick access to your local folders configured for synchronization.



To start configuring KumoSync select the "Settings" option which will then display the main KumoSync settings dialog.

From here you can configure the sync 'mappings' that link your folders with Google document accounts, set you general sync preferences, adjust any settings related to using a proxy server and find out about the current product.

Select "Sync Mappings" and then click the [NEW] button to create a new document sync mapping.

 

A new dialog will appear allowing you to configure the sync mapping. The basic idea is that you will map a local folder to the Google documents "All Items" list or to a specific collection.

Then enter your Google username/password, select the appropriate Google Document list you want to sync with then select the local directory you want to sync with. You can optionally configure a drive letter that will map to the local folder you've selected for easier access and where in Windows.  

You can also enable the option setting to sync sub-folders/collections with the local file system. This option applies only when syncing with a specific collection. For example, if you wanted to sync your Windows "My Documents" folder with Google Documents you would create a collection called "My Documents" in Google Documents, configure KumoSync to sync your local "My Documents" folder with the "My Documents" Google Documents collection and enable the option to sync sub-folders/collections.
 

Following this you can then adjust any additional settings on the sync options, permissions, and other tab as needed. In most cases these options can remain as defaults. 

At this point you are ready to sync. You can either click sync from the KumoSync system tray or use the Sync Options panel on the KumoSync settings dialog to configure automatic synchronization.