Skip to content

How sync works

Markdown

With sync on, your library goes to Copilka’s service and comes back on your other Mac and your iPhone. Each device keeps a full copy and works on its own; the service is the meeting point.

On a Mac, sync is off until you turn it on: Settings → Storage → Sync this library. Its description: Keeps this Mac’s library in step through Copilka’s cloud, and backs up the files you have saved. Off keeps everything here and sends nothing. On the iPhone it is on from the start.

Sync needs a plan that includes cloud storage, which the subscription does. Without one the status reads Not in this plan and nothing is sent; your library stays on the device.

  • Items: every save, with its tags, favourite mark, note, room, cover and, for a file, its name, size and hash.
  • Rooms, tags and properties, with their values and status histories.
  • Readings: what the reader made of each page, so a page read on one device is read on all.
  • Settings, except a few that belong to one device: whether it syncs, whether it reads as you, and the folder Quick capture browses from. What the app opens on is also per device.

Not synced: thumbnails, the page cache, price and change histories, and the Mac’s undo history. Files travel separately: see Files and pictures across devices.

A pass is a pull, a merge and a push. On a Mac it runs:

  • at launch,
  • two seconds after you change something,
  • when the Mac wakes,
  • when the app comes to the front,
  • when your account becomes able to sync, and
  • every ten minutes.

Sync now on the Storage page runs one by hand; Usually there is no reason to. The iPhone runs a pass every minute while it is open, and when you pull down. See Sync on iPhone.

Every record carries a version, and the service numbers changes in the order it receives them, so ordering never depends on a device’s clock. When two devices changed the same record:

  • a change made on top of the copy the service already had wins over that copy;
  • otherwise, the later change wins, and if two are simultaneous the writer’s id decides;
  • property values on an item are merged one by one, each on its own time, and status histories are combined, so editing two different properties on two devices keeps both;
  • the shared settings merge key by key.

A deletion is a change like any other. An edit made after a deletion, on a device that had not yet seen it, brings the item back.

When your Mac receives changes from another device, its undo history is cleared, so that undo cannot take the other device’s work away.

Without a network the status is Offline and your edits wait; the Storage page counts them, One change waiting to go up. They go up on the next pass. The library on the device is complete and works as normal.

Settings → Storage → Cloud:

Status Meaning
Off Your library stays on this Mac.
Not in this plan Cloud storage is part of the subscription.
Not synced yet On, but no pass has completed.
Syncing… A pass is running.
Synced 2 min ago In step.
Offline The service could not be reached.
Could not sync The reason follows, for instance the account needs signing in again.

Below it, Not synced lists any record the service refused, with why. A record over half a megabyte is one such case.

The first pass on a device that has never synced pulls the whole library before it creates anything of its own. If the pull brings nothing, the starter rooms are created. On a Mac, where sync is off by default, the starter rooms already exist by the time you turn it on; if you then also had them on another device, you may see two of each. Delete one pair.

Sync stops on the device, and the copy on the service is kept. Everything is still on each device. The Account page says Your access ended on 12 March. Everything you kept is still here on this Mac; ask whoever invited you to renew it.