Rob Stewart10 downloadsRead, listen to and annotate ebooks in your vault, and make your reading part of your knowledge base.
An ebook reader for your Obsidian vault. Read your books, hear them read aloud and annotate them. Make your reading part of your knowledge base, on your terms.

Learn more: Book Sources · Format Support · Read in Orbis Reader · Notes to EPUB
Learn more: Library Dashboards
Learn more: Reading a Book · Display Settings · Reading Progress
Learn more: Listening
Learn more: Marks and Notes · Annotations and Presets
Learn more: Reading Records · Generate Notes · Deep Links · Save as Markdown
Learn more: Exporting and Converting · Save as PDF · Save Annotations as PDF · Save as Markdown · Notes to EPUB
Learn more: Getting Started · Sync and Devices · The .orbis File · Settings Reference · Command Reference

Reading on a computer: passage selections in several marks, and the Navigator's Annotations tab.

The same page after Save as PDF, with your marks drawn where you made them and your notes as PDF comments.
The User Guide explains every feature step by step.
| Format | Extension | Passage selections | Notes | Search | Listen | Export |
|---|---|---|---|---|---|---|
| EPUB | .epub |
✓ | ✓ | ✓ | ✓ | ✓ |
| Mobipocket | .mobi |
✓ | ✓ | ✓ | ✓ | ✓ |
| Kindle Format 8 | .azw3 |
✓ | ✓ | ✓ | ✓ | ✓ |
| FictionBook 2 | .fb2 |
✓ | ✓ | ✓ | ✓ | ✓ |
| Comic Book Archive | .cbz |
— | — | — | — | — |
EPUB has the broadest compatibility and the most consistent behavior across sources. File quality varies — if something behaves unexpectedly with a particular book, try sourcing it from a different provider.
Orbis Reader is not in Obsidian's community plugin store yet. It will be submitted once testing is finished. Until then, install it with BRAT or by hand.
BRAT is a community plugin that installs plugins from GitHub and keeps them up to date.
https://github.com/rastewart/obsidian-orbis-reader as the repository, select Latest version (not dictionaries, which is Look-up's dictionaries), keep Enable after installing the plugin selected, and select Add pluginBRAT installs each new version when Obsidian starts, betas included. See Getting Started for how to stay on one version.
main.js, manifest.json, and styles.css from the newest Orbis Reader release (the Dictionaries release contains Look-up's dictionaries, not the plugin)<your-vault>/.obsidian/plugins/orbis-reader/Once Orbis Reader is listed:
.epub, .mobi, .azw3, .fb2, .cbz) anywhere in your vaultSee Getting Started for a full walkthrough.
Orbis never changes your book files. It keeps each book's data in a !orbis-data/ folder beside the book:
.orbis file with your passage selections, notes, bookmarks, reading stats and the book's detailsaudio/ folder, if you record the bookThe .orbis and location files are plain JSON that you can inspect, back up or sync. Selecting a .orbis file opens the book's reading data: its cover, reading activity on each device, contents, annotations and the notes that link to the book. See The .orbis File.
Orbis Reader has no accounts, ads or telemetry, and it never sends your books, notes or reading data anywhere, unless you set up a speech server to record with (below). It connects to the internet only for the features below, and nothing is downloaded until you ask for it. Dictionaries, voices and fonts are saved on your device, so those features work offline after their first download.
| Feature | Connects to | What for |
|---|---|---|
| Book sources | Project Gutenberg (gutenberg.org) and any OPDS catalog you add, such as your own Calibre server |
Browsing, searching and downloading books |
| Look-up dictionaries | GitHub, from this repository's releases | Downloading Webster's 1913 and Open English WordNet |
| Orbis voices | Hugging Face (huggingface.co), cdnjs.cloudflare.com and cdn.jsdelivr.net |
Downloading the speech engine and the voices you choose to your device |
| Recording with a speech server (off until you set it up) | The Kokoro or OpenAI-compatible server address you enter, such as one on your own computer | Sending the text being recorded, a sentence at a time, and getting the audio back. Recording on your device, the default, sends nothing |
| Expanded character set for PDFs | cdn.jsdelivr.net |
Downloading the DejaVu fonts |
| Download test fixtures (a developer command) | GitHub, from this repository's releases | Downloading the test books and notes for the test plans |
Web look-ups and links in books open in your web browser, but only when you select them. When you select a link in a book, you are prompted to confirm that you want to visit it before it opens. System voices come from your operating system, which may use online services of its own.
Orbis Reader reads and writes files in your vault only, with one exception that you choose each time. On a computer, Save as PDF, Save annotations as PDF, Save as Markdown, Generate notes and Notes to EPUB have an Export… button. It opens your system's save dialog, so that you can save the file wherever you pick: to send it to someone, or to open it in another app. Orbis Reader writes only that one file, and only after you select Save.
On a phone or tablet, the same dialogs have Share… instead. The file goes to your device's share sheet from Orbis Reader's plugin folder, and nothing is written outside the vault.
Orbis Reader implements ARIA roles, keyboard navigation, and semantic focus management for its interface components (menus, sidebars, toolbars).
Screen readers: Orbis Reader hasn't been tested with screen readers or other assistive technology, and some of them may have trouble reading a book's text. However, the plugin can read books aloud; see Listening.
Orbis Reader's interface is available in English only for now. However, its text isn't written into the code. Every menu item, setting, command, dialog and message lives in one locale file, so a translation can be added later without changing how the plugin works. Since English is the only language I speak, I haven't attempted any translations myself. How a translation would fit in is described in Localization.
Orbis Reader is designed by Rob Stewart and coded by Claude Code, Anthropic's AI coding assistant. I decide what Orbis Reader does, how it looks and behaves, and when a change is finished. Claude Code writes the code including all of the TypeScript, the styles, the automated tests, and the build scripts. Claude Code also writes the majority of the documentation.
Orbis Reader is designed to work on every device, and wherever possible every feature works the same on a phone, a tablet and a computer. Its dialogs are designed for the phone first. They work just as well on a computer, but they're laid out to fit the smaller screen rather than squeezed onto it afterward.
Each change runs through automated tests and checks, and I test Orbis Reader on macOS, Windows, Android, iPhone and iPad.
Orbis Reader isn't the only way to read ebooks in Obsidian. Before I started on it, I looked through the community plugins that support ebooks. Several already do a great deal well. If Orbis Reader isn't the right fit for you, search for "EPUB" or "ebook" in Settings → Community plugins → Browse, and one of the others may suit you better.
The open-source projects Orbis Reader builds on, such as foliate-js and lamejs, are their authors' work; see License.
MIT — see LICENSE.
Third-party components and their licenses are listed in NOTICES. In
particular, recorded (pre-generated) audio is encoded to MP3 using
lamejs, a JavaScript port of the
LAME MP3 encoder, under the LGPL-3.0 (full
license texts in licenses/). It is vendored, unmodified, in
src/vendor/lamejs, and stays under the LGPL there. The
reader engine, foliate-js (MIT), is
vendored with Orbis's changes in src/vendor/foliate-js.
Word look-up can download two offline dictionaries, neither of them bundled.
Webster's Revised Unabridged Dictionary (1913) is in the public domain.
Open English WordNet (2025 edition) is derived from
Princeton WordNet by the Open English WordNet community and licensed under
CC BY 4.0 (full text in
licenses/CC-BY-4.0.txt). The asset Orbis builds from
it is modified — reshaped for offline look-up, as described in
NOTICES — and is not the release itself.
PDF export can use the DejaVu fonts as its
Expanded character set, so a PDF can show arrows, Greek, Cyrillic,
mathematical symbols and other characters beyond the standard PDF fonts. The
fonts are not bundled with Orbis Reader; they are downloaded to your device on
request, and each PDF includes only the characters it uses. Fonts are
© Bitstream, Inc., and glyphs imported from the Arev fonts are © Tavmjong Bah;
DejaVu's own changes are in the public domain. Full terms are in
licenses/dejavu-fonts-LICENSE.txt.
Report a bug or request a feature as an issue in this repository. Pull requests are by invitation only; see Contributing.