4.13  More About Syncing Among Macs

This section gives technical detail which may be helpful for troubleshooting any problems that might occur when synchronizing your bookmarks among Macs, assuming that you have fully activated Simple Syncers for two-way syncing like this…

4.13.1  Step By Step

We show the actions which occur when you add or otherwise change a bookmark in a client web browser’s built-in bookmarks under the above conditions, using Dropbox as the Online File Syncing Service.

As you read the steps below, you can follow along in this drawing…

A.  Due to the to Import Changes from Clients checkbox, after 1-5 minutes, bookmarks changes you make in the bulit-in bookmarks of your web browsers are detected and imported into Smarky, Synkmark or BookMacster.  Provided that the involved Collection is not open in BookMacster, Synkmark, or Smarky, BkmxAgent will silently and invisibly open the Collection.  If you have checked the box Export Results to Clients, BkmxAgent will export changes, if any, to the other client web browsers on the local Mac.

B.  Internally, this Syncer has a command to Save Document after the export, so the Collection() (.bkmxDoc file), which is in your Dropbox folder, gets saved to your Dropbox folder.

C.  The Dropbox application is always watching your Dropbox folder.  When it sees the changes in your Collection, it compresses them and then…

D.  Uploads the changes to the nearest Dropbox server.

E.  The Dropbox servers synchronize each other over the internet.

F.  The Dropbox application on your other Mac will receive the changes.  If you have just logged in or waken from sleep, Dropbox waits about 60 seconds for the things to calm down, and probably to get some assurance that the connection is going to stick around.

G.  The Dropbox application on your other Mac moves the original version to an archive in ~/.dropbox/cache, and then reconstructs the file, including the changes it receives, back into the Dropbox folder.  After Dropbox has received the file, you’ll see a Growl notification from Dropbox (unless you’ve disabled them).

H.  BkmxAgent sees that the file has changed and performs the Commands of the relevant Syncer.

I.  The same Syncer has a command (its only command) to Export changes to the Client web browsers on your other Mac.

(The cloud and network icons in the figure are provided by Open Security Architecture under the Creative Commons License.)

4.13.2  Deleted or Replaced Files

If a file is deleted or replaced on one Mac, Dropbox moves it into a special cache folder on other Macs, and appends (deleted) and a string of characters to its name, resulting in something funky like this:

   My Bookmarks (deleted 95d803a1e8aa701e86fbcbd1506e338e).bkmxDoc

Therefore, if you want to trash a Collection file which is in your Dropbox, you must trash it on each Mac.  To do that,

If you’ve changed your mind about this document and instead you want to keep it, instead of Close and Trash, you’ll want to rename and move the document.  To rename and move,