Volodymyr Pavlyshyn59 downloadsRead PDF and EPUB books on desktop and mobile. Select text to have AI explain or simplify it for your language level, and keep highlights, notes, vocabulary and handwriting linked to each book.
Read PDFs and EPUBs in Obsidian, on desktop and mobile.
Select any text to have AI explain it or simplify it for your language level. Your highlights, notes, vocabulary and handwriting stay linked to each book.
Website · Install in Obsidian · Download · Pairs with Typed Graph

E-readers let you tap a word to see what it means. This plugin brings that into Obsidian and goes further. It explains whole passages in context, rewrites hard sentences at your language level, and turns what you read into notes connected to the book, so every book grows a small knowledge system in your vault.
A toolbar appears over any selection:
| Button | What you get |
|---|---|
| Explain | what the passage means in its context: references, idioms, why it matters |
| Simplify | the passage rewritten for your level, hard sentences paired with easier versions, and a word list |
| Word | for one to four words: meaning in this sentence, part of speech, translation, an example and easier synonyms |
| Translate | into your native language, with a note on phrases that don't translate literally |
| Ask | your own question, with the passage and its surroundings as context |
You can also Study this page (summary, hard sentences and up to 12 words from what's on screen), ask anything about the book in the panel, and ask follow-up questions in the same thread. Answers render as Markdown and can be saved as notes with one tap.
The 📚 ribbon icon opens a library with shelves, and everything you set there is written to each book's page, so it stays in your vault (and in Typed Graph) as plain notes.
Books/Library/. They are made of live book-shelf blocks, so they update by themselves, and you can put the same blocks in any note:```book-shelf
shelf: reading
```
Options: shelf: (reading, to-read, wishlist, finished, abandoned, suggested, all), view: (cards, list, stats), limit:, sort: (recent, title, rating, finished, author), year: and author:. Each author also gets a note listing their books.
Book notes with status, rating, started, finished, written_by and has_genre, so you can ask your library anything, for example which authors you've read most; the Reading log page includes ready-made queries.Open the Cat tab in the reader panel and talk about the book with the little reading cat, like a book-club friend who is reading along.
Chats/ folder, linked from the book page under Discussions, with your questions and the cat's answers as callouts and links back to the page. The transcript is updated as you talk, and anything you write below it is kept. Pick an earlier discussion from the list to continue it.word :: meaning, tagged #flashcards) in the book's folder, and any deck can be saved as a note for the Spaced Repetition plugin.Each book gets a folder (default Books/<Title>/) containing:
Chats/: your discussions with the cat, one note eachNotes/: one note per thought, with the quote and a link back to the exact spotHandwriting/: your handwritten pages as SVGVocabulary – <Title>.md: your flashcardsEvery entry links back into the book through obsidian://book-reader?file=…&loc=p12, and opening the link jumps to that page.
Built for Obsidian mobile from the start: big touch targets, swipe page turns, and the companion panel as a bottom sheet. Nothing needs a desktop except the optional subscription apps described below.
Pick it in Settings → Book Companion Reader → AI service.
| Option | Where | What you need |
|---|---|---|
| My Claude subscription (default) | computer | Claude Code installed; run claude once to sign in with your Claude Pro/Max account |
| My ChatGPT subscription | computer | Codex CLI; run codex once to sign in with ChatGPT Plus/Pro |
| My Google account (Gemini) | computer | Gemini CLI, signed in (whether it works depends on your Google plan) |
| My chat app | any device | nothing: the question opens in the Claude, ChatGPT or Gemini app, and you paste the answer back |
| Anthropic / OpenAI / OpenRouter | any device | an API key |
| Ollama / OpenAI-compatible | computer or your network | a running local server |
On a phone, the subscription options switch to chat-app hand-off automatically: tap Ask Claude, Ask ChatGPT or Ask Gemini, then Paste answer.
Typed Graph turns your notes into a typed property graph that you can query with openCypher and explore in a graph view. The two plugins are designed to work as a pair:
Book from Typed Graph's library ontology (status, format and dates as properties), with written_by:: [[Author]] {role: "author"}.ReadingNote + Quote, with note_on:: [[Book]] {loc: "p12"}, quoted_from:: [[Book]] and the page number.Explanation with explains:: [[Book]] {loc, action}. Handwritten notes become Handwriting, and word lists become Vocabulary with vocabulary_of.Types/Book Companion.md, plus Typed Graph's Library.md if your vault has no Book type yet (it is never declared twice).For example:
```graph-query
MATCH (n)-[r:note_on|explains]->(b:Book)
RETURN b.title AS book, count(n) AS notes
ORDER BY notes DESC
```
```graph-query
MATCH (q:Quote)-[:quoted_from]->(b:Book)-[:written_by]->(a:Author)
RETURN a.title AS author, b.title AS book, q.title AS quote, q.page AS page
```
These notes are checked against Typed Graph's own engine: the test vault reads back as Books, Quotes, ReadingNotes, Explanations, Handwriting and Vocabulary with every edge in place.
Volland/book-companion-reader.main.js, manifest.json and styles.css from the latest release to <vault>/.obsidian/plugins/book-companion-reader/, then reload Obsidian. From a clone: npm install && npm run build && cargo run -- --install "/path/to/vault"..epub. For PDFs, use the file menu → Open in Book Reader, or turn on Open PDFs in this reader.Books/) and, with typed notes on, two schema notes in your Typed Graph schema folder. Reading positions, highlights and page handwriting are kept in the plugin's own data. API keys are stored in plain text in the plugin's settings in your vault.src/ the plugin (TypeScript): reader view, PDF and EPUB renderers, AI client, notes, handwriting, Typed Graph schema
src/main.rs a small launcher: preview, --screenshot, --self-test, --install <vault>
test/ a stand-in Obsidian API, a sample book and the self-test
preview/ the real reader running in a browser with the sample book (EPUB and PDF)
website/ the landing page (GitHub Pages)
npm install
npm run build # plugin + preview + self-test bundles
npm run selftest # drives the reader through its core flows
cargo run # opens the preview in your browser
cargo run -- --install <vault>
npm run version:bump -- 0.2.0 # then commit and push a tag named 0.2.0 → the release workflow publishes it
MIT © Volodymyr Pavlyshyn. Not affiliated with Obsidian, Anthropic, OpenAI or Google.