Insurgently

Obsidian plugin· Active · beta · not yet released

Books & Shelves

Shelves across Obsidian, Calibre and Audible, as an Obsidian plugin over the shelf engine.

Beta. Books & Shelves is not released yet. These pages describe the build in progress.

Settings

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

Library

SettingWhat it doesDefault
ConnectionsWhether Calibre and Model Hub are reachable.
Sync notes from Calibre → Sync…One note per book. Shows what it would do first.
Resync everyMinutes between resyncs while Obsidian is open. Zero turns it off.0
Resync nowBrings notes and covers up to date.
Write queueOpens 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 ServerOpens the guide.

Notes

SettingWhat it doesDefault
Book notesThe folder with one note per book.Books/Library
ShelvesThe folder for shelf notes.Books/Collections
ReviewThe folder for proposed changes waiting for you.Books/Review
CoversThe folder for cover images.Books/Covers
Book note namesThe template for new notes: {title}, {surname}, {author}, {year}.{title} — {surname}
Skip books taggedBooks with this Calibre tag get no note.not-a-book
Show covers in book notesShows the cover under the title, with a button to replace it.on
Google Books API keyOptional. 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

SettingWhat it doesDefault
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 noteThe reading queue: a numbered list you can edit by hand.Books/Up Next.md

Review

SettingWhat 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

SettingWhat it doesDefault
Built inThe built-in packs, each with a switch.Buddhism, off
Packs folderFolders 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.

TaskWhat it doesDefault tier
books.title-pageReads a book's title pageQuick
books.researchResearches a book on the web, each field with a sourceResearch
books.matchDecides whether a found record is this bookBalanced
books.plausibleAccepts a proposed change or sends it to reviewDecision
books.same-authorJudges whether two author names are one personDecision
books.summarizeOne-page summariesQuick
books.chaptersChapter notes with checked quotesBalanced
books.shelf-nameNames a suggested shelfQuick
books.shelf-keepKeeps the books that belong on a described shelfQuick
books.shelf-planSplits a broad subject into shelvesBalanced
books.seriesJudges whether a book is part of a seriesQuick
books.embedBook vectors for shelves and similar booksEmbedding