An Obsidian plugin for reading FictionBook (.fb2) files directly in your vault. Works on desktop and mobile.
- Reader view. Open a
.fb2file and it renders as a formatted book: cover, title page, authors, annotation, chapters, poems, quotes, footnotes, images, and tables. - Table of contents. A side panel lists the chapters of the active book; click a chapter to scroll to it.
- Reading position. The plugin remembers where you stopped in each book (up to 300 books) and takes you back there when you reopen it.
- Appearance settings. Theme (light / dark / sepia or follow Obsidian), font family, font size, line height, text color, and optional drop caps.
- Encoding detection. Older FB2 books in windows-1251 and other legacy encodings are decoded automatically.
Put a .fb2 file anywhere in your vault and click it — it opens in the reader. Use the Open table of contents command (or switch to a reader tab) to show the chapter panel.
Note: zipped books (.fb2.zip) are not supported — unpack them to plain .fb2 first. Obsidian identifies files by their final extension only, so claiming .zip would hijack every archive in the vault.
Search for FB2 Reader in Settings → Community plugins (once the plugin is accepted into the catalog).
- Download
main.js,manifest.json, andstyles.cssfrom the latest release. - Copy them into
<your vault>/.obsidian/plugins/fiction-book-reader/. - Reload Obsidian and enable FB2 Reader in Settings → Community plugins.
npm install
npm run dev # watch mode, rebuilds main.js on change
npm run build # typecheck + production buildThe entire plugin lives in src/main.ts; esbuild bundles it into main.js.