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
17 commits 1 branch 6 tags 9.9 MiB
TypeScript 90.6%
CSS 9.4%
Find a file
kvasonaft f38e5081a4 Use pure black and white reader backgrounds 
Make the dark theme background solid black (#000000) instead of dark
gray, and the light theme background pure white (#ffffff) instead of
off-white beige.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-20 22:39:18 +03:00
src Improve font selection UX on iOS and iPadOS 2026-07-20 22:19:33 +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.4: avoid static references to 1.13-only SettingTab.update 2026-07-17 10:30:42 +03:00
package-lock.json Release 0.1.4: avoid static references to 1.13-only SettingTab.update 2026-07-17 10:30:42 +03:00
package.json Release 0.1.4: avoid static references to 1.13-only SettingTab.update 2026-07-17 10:30:42 +03:00
README.md Rename plugin id to fiction-book-reader 2026-07-17 00:01:48 +03:00
styles.css Use pure black and white reader backgrounds 2026-07-20 22:39:18 +03:00
tsconfig.json initial commit 2026-07-02 22:31:02 +03:00
versions.json Release 0.1.4: avoid static references to 1.13-only SettingTab.update 2026-07-17 10:30:42 +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