obsidian-plugin/kvasonaft_fb2-reader
1
0
Fork 0
mirror of https://github.com/kvasonaft/fb2-reader.git synced 2026-07-22 08:31:14 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
14 commits 1 branch 6 tags 9.9 MiB
TypeScript 90.6%
CSS 9.4%
Find a file
kvasonaft fddf181411 Release 0.1.3: restore support for Obsidian 1.7.2+ 
0.1.2 required Obsidian 1.13.0 for the declarative settings API, but
1.13.x is currently Catalyst-only. Restore the imperative settings-tab
fallback so the plugin works on the latest free release (1.12.7); the
declarative path still takes over on 1.13+.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-17 01:38:21 +03:00
src Release 0.1.3: restore support for Obsidian 1.7.2+ 2026-07-17 01:38:21 +03:00
.gitignore Simplify repo for study: untrack build artifacts, refactor rendering into tag maps 2026-07-03 22:00:41 +03:00
LICENSE adding MIT license 2026-07-16 14:20:27 +03:00
manifest.json Release 0.1.3: restore support for Obsidian 1.7.2+ 2026-07-17 01:38:21 +03:00
package-lock.json Release 0.1.3: restore support for Obsidian 1.7.2+ 2026-07-17 01:38:21 +03:00
package.json Release 0.1.3: restore support for Obsidian 1.7.2+ 2026-07-17 01:38:21 +03:00
README.md Rename plugin id to fiction-book-reader 2026-07-17 00:01:48 +03:00
styles.css fixing errors for new release 2026-07-17 01:06:40 +03:00
tsconfig.json initial commit 2026-07-02 22:31:02 +03:00
versions.json Release 0.1.3: restore support for Obsidian 1.7.2+ 2026-07-17 01:38:21 +03:00

README.md

FB2 Reader

An Obsidian plugin for reading FictionBook (.fb2) files directly in your vault. Works on desktop and mobile.

Features

  • Reader view. Open a .fb2 file 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.

Usage

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.

Installation

From community plugins

Search for FB2 Reader in Settings → Community plugins (once the plugin is accepted into the catalog).

Manual

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Copy them into <your vault>/.obsidian/plugins/fiction-book-reader/.
  3. Reload Obsidian and enable FB2 Reader in Settings → Community plugins.

Development

npm install
npm run dev    # watch mode, rebuilds main.js on change
npm run build  # typecheck + production build

The entire plugin lives in src/main.ts; esbuild bundles it into main.js.

License

MIT