Skip to content

Format Support ​

← User Guide


Overview ​

Orbis Reader opens five book formats. When the plugin is enabled, a file in your vault with one of these extensions opens in the reader when you select it.

FormatExtensionDescription
EPUB.epubThe standard ebook format. Project Gutenberg, Standard Ebooks, most retailers and most library loans use it
MOBI.mobiAn older Amazon Kindle format
AZW3.azw3The newer Amazon Kindle format
FB2.fb2An XML ebook format, common in Russian and Eastern European book collections
CBZ.cbzA zip file of images, for comics, manga and scanned books

When you have a choice of format, use EPUB. Every feature in this guide works with EPUB.


Zoom in on a CBZ page ​

  1. Select the page. The page opens in the image viewer.
  2. Pinch or scroll to zoom.

Use this to read small lettering on a phone. See Reading a Book for the image viewer.


Text formats and image formats ​

EPUB, MOBI, AZW3 and FB2 contain text. CBZ contains only images: each page is a picture. A CBZ book has no text to select, search or listen to.

FeatureEPUB, MOBI, AZW3, FB2CBZ
Read the book✓✓
Turn pages, use the table of contents✓✓
Reading progress and locations✓✓, by page
Deep links✓✓
Select an image to zoom in✓✓, the page itself
Covers and cataloging✓✓
Select text✓—
Passage selections, notes and bookmarks✓—
Search✓—
Look-up✓—
Listening and recordings✓—
Reading speed and time remaining✓—, no words to count
Generate notes, Save as Markdown, Save as PDF✓—
Reading records✓—

You can read and track your progress in a CBZ book, but you cannot annotate it.


Notes on each format ​

EPUB ​

Everything in this guide applies to EPUB.

MOBI and AZW3 ​

MOBI and AZW3 books work like EPUB books. Text, annotations, search and listening work the same way.

FB2 ​

An FB2 book is one XML file. It works like the other text formats.

CBZ ​

Turning pages, reading progress and deep links work as they do in other formats. The other features need text, which a CBZ book does not have. See Text formats and image formats.

The cover of a CBZ book is the first image in the file. This is almost always the cover.


What each format gives the Library ​

When Orbis Reader catalogs a book, it reads the book's details from the file to make the title note. The details that it can read depend on the format, and on what the person who made the file included. See Library Dashboards for what each property does.

FormatDetails that cataloging readsCover
EPUBTitle, authors, publisher, publication date, language, ISBN, series and series index, from the book's OPF file✓ From the book
FB2Title, authors, publisher, publication year, language, ISBN, series and series index✓ From the book
MOBI and AZW3Title, authors, publisher, publication date, language✓ From the book
CBZNo details. A CBZ file has no metadata✓ The first image

For a CBZ book, the title comes from the file name. Orbis Reader does not take an author from a file name. A CBZ book usually gets a title note with a title and no author. You can add the author to the title note.

Every book gets a cover. If Orbis Reader cannot find a book's cover, it makes one. See Library Dashboards.


Downloading books ​

An OPDS feed in Book Sources lists each book in the formats that its publisher chose. Orbis Reader downloads the first of these formats that the feed lists: EPUB, AZW3, MOBI, CBZ, then FB2.

Some books are available only in formats that Orbis Reader cannot open, such as PDF or a file with DRM. The row of such a book shows Not a format Orbis Reader opens before you select it.


Formats that Orbis Reader does not open ​

Orbis Reader cannot open a book that has DRM copy protection, such as many books bought from Amazon and other stores.

Orbis Reader does not open PDF files. To read a PDF, use Obsidian's own PDF viewer. Orbis Reader can write a PDF from a book. See Save as PDF.

Orbis Reader does not open plain text, HTML, DOCX or audiobook files. To read a Markdown note, convert it with Notes to EPUB or Read in Orbis Reader, then open the result.


Troubleshooting ​

A book does not work as expected ​

Ebook files from different sources follow their format's specification more or less closely. Navigation, table of contents links and search results depend on how well the file was made.

If a book does not work as expected, try the same book from a different source, or in a different format.


See also ​