Skip to content

Your data on disk

Markdown

Your library is a folder of small, readable JSON files in your home folder. Nothing about it is locked in. Settings → Storage → Records shows the path, with Reveal to open it in Finder; so does Reveal Library File in the sidebar’s Copilka menu.

~/Library/Application Support/Copilka/

  • records/: the library itself. One file per record, in items/, rooms/, fields/ (properties), readings/, and settings/ (shared.json, which syncs, and device.json, which does not), plus manifest.json. Each file is one JSON document with the record’s id, version, timestamps, the device that wrote it, its sync sequence, and its body. Files are written atomically. A deleted record stays as a small tombstone.
  • journal.jsonl: one line per change.
  • device.json: this Mac’s identity as a writer.
  • Blobs/: the pictures you pasted, the covers you chose, and files downloaded from the cloud, each under its hash.
  • EnrichmentCache/: pages the reader fetched, kept a week.
  • Thumbnails/: previews, remade when missing.
  • prices.json and drift.json: price and change histories.
  • picture-nature.json, tag-emojis.json, aspects.json: small side files for what pictures look like, tag emoji, and picture proportions.
  • entitlement.json and sync.json: what your plan allows, and where sync got to.
  • capture.log: what the capture helper did.
  • library.migrated.json: your library as it was before records, if you used Copilka when it was one file. It is the only automatic backup, and it is not touched.

Your sign-in session is not here; it is in the login keychain.

Settings → Storage shows the footprint: Library records, Readings, Page cache, Thumbnails and the total, plus counts of Saved items, Rooms and Missing files. Under Reclaiming, Clear the page cache and Clear thumbnails free space; both are rebuilt as needed. Re-check referenced files looks for missing files again.

Settings → Storage → Export the library → Export… writes the whole library as one JSON document, Copilka Library.json, wherever you choose. It is a copy for keeping or reading elsewhere; Copilka has no import. Since the library is plain files, a copy of the whole folder with Time Machine or by hand is a backup too.

Restore default settings puts every setting back as it was; Saved items and rooms are untouched.

Files are not in this folder. They are wherever you saved them from, referenced by path; see Links, notes and files.