# Settings

> Every setting, in the order the settings tabs show them.

## Library

| Setting | What it does | Default |
|---|---|---|
| **Connections** | Whether Calibre and Model Hub are reachable. | |
| **Sync notes from Calibre** → **Sync…** | One note per book. Shows what it would do first. | |
| **Resync every** | Minutes between resyncs while Obsidian is open. Zero turns it off. | 0 |
| **Resync now** | Brings notes and covers up to date. | |
| **Write queue** | Opens the changes waiting to be written to Calibre. | |
| **Calibre** → **Connect…** | The Content Server's address, login, library and library folder. | `http://localhost:8080` |
| **How to start the Content Server** | Opens the guide. | |

## Notes

| Setting | What it does | Default |
|---|---|---|
| **Book notes** | The folder with one note per book. | `Books/Library` |
| **Shelves** | The folder for shelf notes. | `Books/Collections` |
| **Review** | The folder for proposed changes waiting for you. | `Books/Review` |
| **Covers** | The folder for cover images. | `Books/Covers` |
| **Book note names** | The template for new notes: `{title}`, `{surname}`, `{author}`, `{year}`. | `{title} — {surname}` |
| **Skip books tagged** | Books with this Calibre tag get no note. | `not-a-book` |
| **Show covers in book notes** | Shows the cover under the title, with a button to replace it. | on |
| **Google Books API key** | Optional. Kept in Obsidian's keychain. | empty |
| **Find covers** → **Find…** | Finds a cover for every book note without one. | |

A folder that doesn't exist yet is made when first needed.

## Shelves

| Setting | What it does | Default |
|---|---|---|
| **Book vectors** → **Import…**, **Embed…** | Makes or imports the one vector per book that shelves use. | |
| **Shelf suggestions** → **Suggest…**, **Apply…** | Suggests named groups as review notes, then turns accepted ones into shelves. | |
| **Similar books** → **Find…** | Writes each book note's five nearest books as links. | |
| **Up next note** | The reading queue: a numbered list you can edit by hand. | `Books/Up Next.md` |

## Review

| Setting | What it does |
|---|---|
| **Look up books without an ISBN** → **Look up…** | Reads each book's first pages and looks its details up. |
| **Duplicate author names** → **Find…** | Sends likely duplicates to review. |
| **Apply accepted reviews** → **Apply…** | Turns accepted rows into changes in the write queue. |

## Packs

| Setting | What it does | Default |
|---|---|---|
| **Built in** | The built-in packs, each with a switch. | Buddhism, off |
| **Packs folder** | Folders with a `pack.yml` in here are your own packs. | `Books/Packs` |

## Models

Each task given to a model, and the Model Hub tier it runs on. Choose another tier here, or open Model Hub's editor for a task's own models and limits.

| Task | What it does | Default tier |
|---|---|---|
| `books.title-page` | Reads a book's title page | Quick |
| `books.research` | Researches a book on the web, each field with a source | Research |
| `books.match` | Decides whether a found record is this book | Balanced |
| `books.plausible` | Accepts a proposed change or sends it to review | Decision |
| `books.same-author` | Judges whether two author names are one person | Decision |
| `books.summarize` | One-page summaries | Quick |
| `books.chapters` | Chapter notes with checked quotes | Balanced |
| `books.shelf-name` | Names a suggested shelf | Quick |
| `books.shelf-keep` | Keeps the books that belong on a described shelf | Quick |
| `books.shelf-plan` | Splits a broad subject into shelves | Balanced |
| `books.series` | Judges whether a book is part of a series | Quick |
| `books.embed` | Book vectors for shelves and similar books | Embedding |