# Library Hub

> Keep your Calibre library as notes: covers, living shelves, a reading list, summaries, and metadata fixes you review before they reach Calibre. Uses Model Hub for models.

## Start

- [Library Hub](https://insurgently.com/docs/library-hub/index.md): Your Calibre library as notes in Obsidian, with covers, shelves that stay current, a reading list and summaries.
- [Getting started](https://insurgently.com/docs/library-hub/getting-started.md): Install Library Hub, connect it to Calibre and make a note for every book.

## How to

- [Connect to Calibre](https://insurgently.com/docs/library-hub/connect-to-calibre.md): Point Library Hub at Calibre's Content Server, and decide whether it may write to your library.
- [The Library panel](https://insurgently.com/docs/library-hub/library-panel.md): One side panel for the open book, the open shelf, the whole library and what has run. Most commands are buttons in it.
- [Reading in Obsidian](https://insurgently.com/docs/library-hub/reading.md): Open a book from its note, turn pages, and come back to where you stopped.
- [Highlights](https://insurgently.com/docs/library-hub/highlights.md): Keep passages from the books you read, with a link back to the exact place, and one brought back each day.
- [Sync notes from Calibre](https://insurgently.com/docs/library-hub/sync-notes.md): Keep one note per Calibre book, matched to the notes you already have.
- [Year in review](https://insurgently.com/docs/library-hub/year-in-review.md): A note that counts what you finished in a year, and progress through the book you are reading.
- [Library health](https://insurgently.com/docs/library-hub/library-health.md): A report of what is missing or doubled in your library, and a count in the Library panel.
- [Find covers](https://insurgently.com/docs/library-hub/covers.md): Give every book note a cover, from Calibre first and from the web when Calibre has none.
- [Build shelves](https://insurgently.com/docs/library-hub/shelves.md): Group related books into shelves, by describing what you want or by hand, and find similar books.
- [Shelf health](https://insurgently.com/docs/library-hub/shelf-health.md): Find shelves that are really one shelf, review and apply proposals, and keep a shelf as it is.
- [New books](https://insurgently.com/docs/library-hub/new-books.md): Bring new book files and new Calibre books in through one pass you review, and shelve the books offered to your shelves.
- [Grow a shelf](https://insurgently.com/docs/library-hub/grow-a-shelf.md): Find books that fit a shelf and aren't in your library yet, kept as a wishlist you review.
- [Keep a reading list](https://insurgently.com/docs/library-hub/reading-list.md): Track what you want to read, what is up next, what you are reading and what you finished.
- [Series](https://insurgently.com/docs/library-hub/series.md): A note for each series you own, with what is missing; and series Calibre doesn't know about, found in titles.
- [Authors](https://insurgently.com/docs/library-hub/authors.md): A note for each author you have several books by, listing them and how many you have read.
- [Summarize a book](https://insurgently.com/docs/library-hub/summaries.md): Get a one-page summary or chapter-by-chapter notes from a book's own text, and see what each one costs.
- [Fix book details](https://insurgently.com/docs/library-hub/metadata-review.md): Look up missing details such as an ISBN, review what was found, and accept only what is right.
- [Changes to Calibre, and undo](https://insurgently.com/docs/library-hub/changes-to-calibre.md): How an accepted change reaches your Calibre library, how it is checked, and how to take it back.
- [Providers](https://insurgently.com/docs/library-hub/providers.md): Where your books come from: Calibre, Audiobookshelf, OPDS catalogs, Hardcover, Readwise, Audible, and what each one adds to a book note.
- [Audiobookshelf](https://insurgently.com/docs/library-hub/audiobookshelf.md): Your Audiobookshelf audiobooks and ebooks as notes, with how far you have listened, and ebook files that open in the reader.
- [OPDS catalogs](https://insurgently.com/docs/library-hub/opds.md): Books from Komga, Kavita, Calibre-Web or any OPDS server, and their files, in your notes and your reader.
- [Hardcover](https://insurgently.com/docs/library-hub/hardcover.md): Your Hardcover status, ratings and dates in your notes, and your want-to-read list as notes you do not own yet.
- [Readwise](https://insurgently.com/docs/library-hub/readwise.md): Your Readwise highlights, from Kindle and other readers, in each book's highlights note.
- [Reading activity from providers](https://insurgently.com/docs/library-hub/activity.md): How a provider's status, rating and dates reach your notes: filling blanks, and showing differences you can accept.
- [Packs](https://insurgently.com/docs/library-hub/packs.md): Add fields and rules for a kind of library, with a pack of your own.
- [Sharing shelves](https://insurgently.com/docs/library-hub/sharing.md): Publish a shelf, with covers and your recommendations, as schema.org JSON-LD and as notes a site can read.
- [Templates](https://insurgently.com/docs/library-hub/templates.md): Choose which provider fields go into your book notes, in what order, and generate the library Base from the same file.
- [Publishing a book](https://insurgently.com/docs/library-hub/publishing-books.md): Write a book's public page with a skill you can swap, keep your own writing beside it, and undo any run.

## Reference

- [Settings](https://insurgently.com/docs/library-hub/settings.md): Every setting, in the order the settings pages show them.
- [Troubleshooting](https://insurgently.com/docs/library-hub/troubleshooting.md): The problems you may meet, and how to fix each one.
- [Privacy and costs](https://insurgently.com/docs/library-hub/privacy-and-costs.md): What is sent where, what costs money and where your files are kept.

## For plugin developers

- [Read books from your plugin](https://insurgently.com/docs/library-hub/developers.md): Find Library Hub from another plugin, read its book list, shelves, book files and book text, change shelves, and open a book at a place.

## API reference

- [Declarations](https://insurgently.com/docs/library-hub/api/library-hub-api.d.ts): every public declaration in one TypeScript file, with comments
- [Reference as data](https://insurgently.com/docs/library-hub/api/api.json): each declaration's name, kind, signature, comment and members

## Changes and plans

- [Changelog](https://insurgently.com/docs/library-hub/changelog.json): every version's changes, as JSON
- [Roadmap](https://insurgently.com/docs/library-hub/roadmap.json): what's coming, as Soon and Later, as JSON
- [Everything in one file](https://insurgently.com/docs/library-hub/llms-full.txt)