Obsidian plugin · desktop & mobile · free & open source

Read your books in Obsidian.
Understand every sentence.

A PDF and EPUB reader for Obsidian with an AI companion, like the one on an e-reader but tuned to your language level. Select a word or a sentence to have it explained or rewritten in simpler words. Your highlights, notes, vocabulary and handwriting become a small knowledge system around each book, right in your vault.

Works with the AI subscription you already have: Claude, ChatGPT or Gemini. API keys and local models work too.

The reader on a computer with the AI panel open, and on a phone with the answer sheet
Desktop: select text and Explain, Simplify, Translate, highlight or take a note. Phone: the same reader, with answers in a bottom sheet.

Everything a reading companion should do

📖

PDF and EPUB, one reader

EPUBs turn like pages (tap the edges or swipe) or scroll. PDFs have selectable text, zoom and an outline. Sepia and dark paper, font size, and your place is always remembered.

✨

Explain what you select

Explain, Simplify, Word meaning, Translate or ask your own question about any passage. The AI sees the surrounding text, so answers fit the book. Ask follow-up questions in the same thread.

🎓

Written for your level

Tell it your native language, the language you're learning and your level, A1 to C2. Hard sentences get simpler versions, and difficult words get short definitions and translations.

🗂️

A small system around each book

Each book gets a folder and a book page listing its highlights, notes, handwriting, vocabulary and saved AI answers. Every entry links back to the exact page.

✍️

Handwriting

Write straight on PDF pages with a pen, highlighter and eraser, or start a handwritten note on lined or dotted paper. Notes are saved as SVG you can open and edit later. Supports Apple Pencil and other styluses, with a pen-only mode that ignores your palm.

📱

Same on phone and desktop

Built for Obsidian mobile from the start: big touch targets, swipe page turns, a bottom-sheet companion. Your progress and notes travel with your vault.

🧠

Flashcards that stick

Tap Card on a word: it is saved with the sentence from the book, its translation and an example. Group cards in book and topic decks and practise them with built-in spaced repetition.

📚

Library

All your PDFs and EPUBs on one shelf with generated covers, reading progress, highlight and word counts, and a search box.

Learn a language by reading real books

Pick a novel in the language you're learning. When a sentence is too hard, select it and tap Simplify:

  • a simpler rewrite at your level
  • each complex sentence next to an easier version
  • the hard words, each with a short definition and a translation into your language

Study this page does the same for everything on screen: a short summary, the hard sentences and up to 12 words to learn. Explanations come in simple words of the language you're learning, or in your native language. You choose.

You select

Notwithstanding the gales that battered the headland every November, she climbed the hundred and twelve steps each evening…

Simplified for B1

Even with the strong winds every November, she climbed the 112 steps each evening…

Words

notwithstanding: even though; despite
gale: a very strong wind
meticulous: very careful about small details

A library with a librarian cat

See everything you read, plan to read and want to read, on shelves, with books that are files and books that aren't.

  • Reading now, Up next, Wishlist, Finished: move a book with one tap, rate it with stars, and carry on where you stopped
  • Paper books and wishlist titles live next to your PDFs and EPUBs, and can be linked to a file later
  • Suggested to read: the librarian cat reads your shelves and your ratings and suggests what to read next, even books that suit your language level
  • a reading goal, a year in numbers and a month-by-month chart
  • Library pages made of live shelf blocks, ready to pin in your vault, and ready-made Typed Graph queries

Everything is stored in your book pages as plain notes, so it stays yours and stays queryable.

The library with the librarian's suggestions on desktop and a library page on a phone

Chat with the cat about your book

The little cat on the pile of books isn't just a logo. Open the Cat tab and talk about what you're reading, like with a friend from a book club who is reading along.

  • ask what's happening, what a line means, or to be quizzed on the chapter
  • point it at a passage: select text and tap Cat
  • it sees your page and the whole conversation, and never spoils what comes next
  • practise the language you're learning: it chats at your level and gently corrects you

Every discussion is saved as a note in the book's folder, linked from the book page, with links back to the pages you talked about.

Chatting with the reading cat in the reader panel
Flashcard decks on desktop and a study session on a phone

Flashcards, decks and a little trainer

Select a word and tap Card. The AI gives its dictionary form, a translation, a simple meaning and an example, and the card keeps the sentence it came from with the word marked, plus a link back to the page.

  • a deck for every book, and topic decks you make yourself
  • spaced repetition: Again, Good or Easy, with reviews after 1, 3, 7, 14 and 30 days
  • keyboard shortcuts on desktop, big buttons on phones
  • decks can be saved as word :: meaning notes for the Spaced Repetition plugin

One reader, several languages

Learning German and English at once? Give each language its own level, such as German B1 and English C1. The reader picks the right one from the book.

Use the AI you already pay for

Your subscription, on a computer

Claude Pro/Max through Claude Code, ChatGPT Plus/Pro through Codex, or Gemini through the Gemini CLI. Sign in once in a terminal, and the reader asks through that app. You need no API key and pay no extra bill.

Your chat app, on a phone

Tap Ask Claude, Ask ChatGPT or Ask Gemini. The app opens with your question and the book's context already filled in. Copy the answer and tap Paste answer, and it's saved with the book.

Or any API or local model

Anthropic, OpenAI and OpenRouter keys, Ollama on your own computer, or any OpenAI-compatible server. Requests go only to the service you choose.

Better together

Pair it with Typed Graph

Typed Graph turns Obsidian notes into a typed property graph that you can query with openCypher. With both plugins installed, the reader writes typed notes:

  • the book page is a Book, written_by its Author (Typed Graph's library ontology)
  • notes from a selection are ReadingNote + Quote, with quoted_from and the page
  • saved AI answers are Explanations that explains the book, with the action and the place
  • handwriting and vocabulary are typed too, and the schema notes are added for you
MATCH (n)-[r:note_on|explains]->(b:Book)
RETURN b.title AS book, count(n) AS notes
ORDER BY notes DESC

Then the graph view shows each book with everything you thought about it. Install Typed Graph and typed notes turn on by themselves.

written_byquoted_fromexplains note_onvocabulary_ofnote_on Book Author Quote Explanation ReadingNote Vocabulary Handwriting
A PDF page with a highlight, the selection toolbar and the AI panel
PDFs too: real text selection, highlights that stay where you put them, and the companion beside the page.

Install

  1. In Obsidian: Settings → Community plugins → Browse, search for Book Companion Reader, then install and enable it. Or open it in Obsidian.
  2. Recommended: also install Typed Graph to get typed, queryable reading notes.
  3. Pick your AI: Settings → Book Companion Reader → AI service. Choose your subscription, a chat app on phones, an API key or Ollama.
  4. Set your level: your native language, the language you're learning and your level.
  5. Open a book: click any .epub, or a PDF's menu → Open in Book Reader.

Manual install: copy main.js, manifest.json and styles.css from the latest release into <vault>/.obsidian/plugins/book-companion-reader/. Beta builds: BRAT → Volland/book-companion-reader.

Your books stay yours

Local first

Books, positions, highlights and notes stay in your vault and the plugin's settings. Nothing is uploaded on its own.

AI only when you ask

The selected text and a little surrounding context go to the AI service you picked, and only when you press a button.

Open source

MIT licensed. The code, the tests and how it all works are on GitHub.