# Your data on disk

Where the library lives on your Mac, what the files are, and how to take a copy.

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.

## The folder

`~/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.

## Sizes and clearing

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.

## Taking a copy

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 you saved

Files are not in this folder. They are wherever you saved them from, referenced by path; see [Links, notes and files](https://docs.copilka.app/saving/links-notes-files/).

---

This page: https://docs.copilka.app/account/your-data-on-disk/ · As Markdown: https://docs.copilka.app/account/your-data-on-disk.md · Every page: https://docs.copilka.app/llms.txt
