# Settings

Every page of Settings on the Mac, every option, and what each defaults to.

Settings is a full-window screen. Open it with **⌘,**, from the sidebar's **Settings** row, or from the Copilka menu; **⌘,** again, **esc** or **Back to app** returns to the library. The rail on the left has a search field, *Search settings…*, and the pages in three groups: **Personal**, **Library** and **App**. Options that need the subscription say *Part of the subscription.* and are greyed out without it.

The iPhone's settings are on their own page: [Settings on iPhone](https://docs.copilka.app/iphone/settings/).

## Account

*You, and what you have kept.*

- **Sign Out**.
- Your initials, your handle, your email, and your plan in one word: **Trial**, **Pro**, **Lifetime** or **Your own keys**; then **Access until** with the date, or *Your access ended on … Everything you kept is still here on this Mac; ask whoever invited you to renew it.*
- **Things kept**, **Rooms**, **Busiest day**, **Current streak**, **Longest streak**.
- **Activity**: a heatmap of the last year, viewed **Daily**, **Weekly** or **Cumulative**.
- **Your library**: the shares of links, files and pictures, and notes; how much the reader has read; favourites; tags in use.
- **Most used rooms**: the top five.
- **Other devices**, each with **Remove**. See [Devices](https://docs.copilka.app/sync/devices/).
- **Leaving** → **Delete account** → **Delete…**. See [Delete your account](https://docs.copilka.app/account/delete-account/).

## General

*What happens when you save something, open it, or throw it away.*

| Option | Default | What it does |
| --- | --- | --- |
| Default room | Unsorted | Where something goes when you save it from Everything. |
| When it is already saved | Mention it | It is saved again either way; a copy shares the first one's reading. This is whether Copilka says so. Or **Say nothing**. |
| Open details when saving | off | Opens the panel on each new save. |
| Opens on | Everything | The board the window shows when Copilka opens: **Where I left off**, a smart view, a kind, a room or a tag. Per Mac. |
| Double-click opens | Open the link or file | Or **Open its details**. Return and the card's menu always open the thing itself. |
| Open links in the background | off | Links open without bringing the browser forward. |
| Confirm before deleting | off | A question first. |
| Copy colours as | Hex | **Hex — #264653**, **RGB — rgb(38, 70, 83)** or **HSL — hsl(197, 37%, 24%)**, for palette swatches. |

## Appearance

*Everything visual: the theme, the accent, the board, the motion.*

| Option | Default | What it does |
| --- | --- | --- |
| Theme | Dark | **Match system**, **Light** or **Dark**. Dark is Copilka's own. |
| Accent colour | Blue | Blue, Purple, Pink, Red, Orange, Green, Graphite. |
| App icon | Original | Original, Cobalt, Crimson, Dawn, Sky, Prism, Blueprint. Shows on the Dock while Copilka is running. |
| Layout | Grid | Or **List**. Also in the top bar. |
| Before the board is full | Grow to fill | **A column each**, **Keep their size**, **Keep their size, centred**. |
| Card size | Medium | Small, Medium, Large. |
| Sort order | Recently added | The five orders, or a property. |
| Show prices on cards | on | The price tag, and the badge when one has moved. |
| Tile size rules | none | One rule per kind of tile, set from a card's menu; each with **Clear**, and **Clear all**. |
| Details open as | Side panel | Or **Window**. |
| Show tags in the sidebar | on | |
| When deleting | Smooth | **None**, **Smooth** or **Disintegrate**. |
| Show new text being written | on | Titles and summaries arrive like a reply after a page is read. |

## Quick Capture

*One hotkey, anywhere, and a glass box that saves whatever lands in it.* See [Quick capture](https://docs.copilka.app/saving/quick-capture/).

| Option | Default | What it does |
| --- | --- | --- |
| Global hotkey | ⌥⌘K | Click to record another; it needs ⌘, ⌥ or ⌃. |
| Capture works in the background | on | The helper that answers the hotkey while Copilka is closed, with its state: *Running.*, *Registered; starting.*, or *Off.* |
| Save captures into | Default room | Or any room. |
| Browse starts in | Downloads | The folder **browse** opens; **Choose…** and a reset. |
| Offer the page you are looking at | on | Asks the browser in front of you what it is showing. macOS asks permission the first time. |
| Stay open after saving | off | |
| Keep the panel on top | on | |

## Rooms

*Rooms group what you save, and carry the properties their things are described by. A room can hold rooms of its own; deleting one deletes those too, and keeps every item, unsorted.* See [Rooms](https://docs.copilka.app/organising/rooms/) and [Properties](https://docs.copilka.app/items/properties/).

- **New room** at the top.
- **Your rooms**: the tree, each with **Sub-room**, **Rename** and **Delete**, and *4 items · 2 sub-rooms · Default for new saves*. Under each: its properties with **Fill in…** (**Empty values** or **Everything again**) and **Edit**; the reading row, **Browser as set**, **Browser on** or **Browser off**, and **Read as you on:** with sites; **Add property** and **Preset…**; and the grouping, **Not grouped** or **Grouped by …**.
- **Properties**: every property with a summary such as *Status · every room · filled by the reader · on the tile*, and **New property**.

## Reading

*The engine: what Copilka fetches, how hard it tries, and what it asks a model.* See [How a link reads itself](https://docs.copilka.app/reading/how-a-link-reads-itself/).

| Option | Default | What it does |
| --- | --- | --- |
| Read new saves | on | Fetch and read a link the moment it lands. Off, nothing is fetched until you ask. |
| Try again on launch | Pages that said nothing | **Never**, **Pages that said nothing**, **Oldest readings too**. |
| Check prices | Daily | **Never**, **Daily**, **Weekly**. Anything with a watched fact is read again this often. |
| Use a browser for stubborn pages | on | Subscription. |
| Quick Look previews | on | Off, every document shows its icon. |
| Ask what a picture is | on | The offers to file a picture as what it shows. |
| Ask a model about pages | on | Subscription. Summaries and extra tags cost one model request per save. Off spends nothing. |
| Model, Fallback | Copilka's | On the subscription: Gemini 2.5 Flash, then Flash-Lite, on Copilka's keys. With your own key, text fields. |
| Find alternatives in | Where this Mac is set | Or a country. |

## Privacy

*What leaves this Mac, and the one setting that reads as you.* See [What leaves your device](https://docs.copilka.app/account/privacy/).

- **Read pages as you**: off; subscription; with the disclaimer behind its mark, and **Signed In…** once it is on. See [Read as you](https://docs.copilka.app/reading/read-as-you/).
- **What leaves this Mac**: four short paragraphs, **Pages you save**, **What a model sees**, **Pictures and their codes**, **What is never sent**.
- **Credentials**: an OpenRouter key, a Google Places key, and a Cloudflare token and account for developers, each **Found**, **Locked**, **Missing** or **Not set**, with **Check again**.

## Connections

*An assistant can search and save here on your behalf. This is where you say who, and take it back.* See [Connect Claude](https://docs.copilka.app/assistants/connect-claude/).

- **Endpoint**, and **In Claude Code**, each with a copy button.
- **Connected apps**: each with what it may do, when it was granted and how often it was used, and **Disconnect**. Or *Nothing is connected* with **Check again**.
- **What a connection can do**: **Read**, **Write**, **Trash**.

## Storage

*Everything lives in a folder of small, readable JSON records. Files are referenced, never copied.* See [How sync works](https://docs.copilka.app/sync/how-sync-works/) and [Your data on disk](https://docs.copilka.app/account/your-data-on-disk/).

- **Cloud**, when signed in: **Sync this library** (off by default on a Mac), the **Cloud** status, any **Not synced** records, and **Sync now**.
- **On disk**: the **Records** path with **Reveal**, and the footprint by part.
- **Contents**: **Saved items**, **Rooms**, **Missing files**.
- **Reclaiming**: **Clear the page cache**, **Clear thumbnails**, **Re-check referenced files**.
- **Your data**: **Export the library** → **Export…**, and **Restore default settings** → **Restore**.

## Shortcuts

*Every key Copilka answers to. Click one to give it a different key.* See [Keyboard shortcuts](https://docs.copilka.app/reference/keyboard-shortcuts/).

## About Copilka

*Save and organize anything you find.* The icon, the version and build, and Lumilay. **Check for updates** → **Check Now**, with when it last checked, and **Check automatically**: *Once a day, quietly. You are asked before anything is installed.* See [Updates and versions](https://docs.copilka.app/reference/updates-and-versions/).

---

This page: https://docs.copilka.app/reference/settings/ · As Markdown: https://docs.copilka.app/reference/settings.md · Every page: https://docs.copilka.app/llms.txt
