UNreader

by UNcore
5
4
3
2
1
Score: 41/100

Description

E-book reader for Obsidian — EPUB first, plus MOBI/AZW3 and TXT. 连续滚动、浮动目录、高亮/书签/批注与外观预设的电子书阅读器。

Reviews

No reviews yet.

Stats

2
stars
616
downloads
0
forks
66
days
4
days
4
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
2
total issues
1
open issues
1
closed issues
34
commits

Latest Version

5 days ago

Changelog

阅读进度与数据保护

书籍移动或改名后继续保留进度与标注;标注和订阅数据读取失败时停止覆盖,并可在恢复后重新读取。

  • 书籍改名、移动或通过同步换到新路径后,阅读进度和高亮仍会跟随同一本书;同名书也不会再共用标注笔记。
  • 标注文件暂时读不到时不再显示成空标注或覆盖原文件,并新增“重试读取当前标注”命令。
  • RSS 索引或单个订阅损坏时进入只读保护,刷新、状态更新和删除失败不会再用空数据覆盖原记录。
  • 切换数据文件夹时会一并保存和迁移书籍身份、阅读统计、订阅和标注,并刷新已打开的阅读标签。
  • 打开书籍只读取一次文件内容,书籍内容指纹延后计算;多标签的书架、订阅、笔记和标注刷新也更快更一致。
  • 面向 UNagent 的自动化接口保持稳定,数据目录切换后仍会继续指向当前存储。

Reading progress and data protection

Keep progress and annotations when books move or are renamed, stop overwriting unreadable annotation or feed data, and reload it after recovery.

  • Reading progress and highlights now follow a book after renames, moves, and synced path changes. Books with the same name no longer share one annotation note.
  • Unreadable annotation files are no longer treated as empty or overwritten, and a new command lets you retry loading the current annotations.
  • Damaged feed indexes or subscriptions enter read-only protection so refreshes, state updates, and failed removals cannot replace existing records with empty data.
  • Changing the data folder now saves and migrates book identities, reading statistics, feeds, and annotations together, then refreshes open reader tabs.
  • Book files are read once when opened and content fingerprints are calculated later. Shelf, feed, note, and annotation refreshes also stay consistent across multiple tabs.
  • The automation API used by UNagent remains stable and follows the active storage after a data-folder change.

README file from

Github

UNreader

Read your books inside Obsidian. Pick up where you left off, and keep your highlights and comments close to your notes.

UNreader is for people who want to read EPUBs and other books alongside the notes they already keep in Obsidian. It brings continuous reading, a table of contents, highlights, bookmarks, and comments into your vault. It also includes RSS/Atom/JSON Feed reading.

Selected passages and comments are saved as Markdown notes in the vault. Books use bookmarks; feed articles use stars.

Install from the Obsidian Community directory · Read release notes · Open the public repository

Part of the UN series: UNmemos 记 · UNreader 读 · UNagent 用.

Start reading

  1. In Obsidian, open Settings → Community plugins → Browse, search for UNreader, then install and enable it.
  2. Add an EPUB, MOBI, AZW3, or TXT file to your vault.
  3. Open the Command Palette (Cmd/Ctrl + P) and choose UNreader: Vault: choose and open a book (or UNreader: 全库:选择并打开书籍 in Chinese). You can also open a supported book from Obsidian's file list.

The bookshelf and book picker list EPUB, MOBI, AZW3, and TXT files. Local HTML/HTM files can be opened from the file list, but do not appear on the bookshelf. PDF is not supported; Obsidian opens PDFs with its own viewer.

What you can do

  • Read comfortably: keep chapters in one continuous scroll, jump from the floating table of contents or chapter rail, and restore your place when you return.
  • Keep your reading notes: highlight text, add bookmarks and comments, then find them in the annotations sidebar.
  • Make the page yours: adjust fonts, spacing, margins, colours, backgrounds, and reusable appearance presets.
  • Read feeds too: subscribe to RSS, Atom, RDF/RSS 1.0, or JSON Feed; import and export OPML; save article snapshots for offline reading; and play or download podcast audio.
  • Use it on desktop or mobile: UNreader follows Obsidian's reading surface and includes touch-friendly navigation and an immersive reading mode.

Updates

The GitHub Releases page lists published versions and their changes. Features described above refer to the public release; work that has not shipped is not included here.

Network and privacy

UNreader does not send telemetry. Reading books and annotations works offline. Feed and podcast features use the network to add or refresh subscriptions, fetch article text, and play or download podcast media. UNreader does not run periodic background feed polling. If enabled in settings, opening the Feeds sidebar can trigger one refresh.

Books, annotations, and cached feed snapshots are stored in your vault. Podcast and image media caches are kept in a local IndexedDB database and are not part of vault sync. UNreader does not bypass paywalls or logins, and video podcasts are not supported.

Compatibility and license

  • Requires Obsidian 1.7.2 or later.
  • The plugin is available on desktop and mobile.
  • Source Available License — commercial use requires permission. See LICENSE.

Development

This repository contains UNreader's source code. To install dependencies and build the plugin:

npm install
npm run build

For a live development build, use npm run dev. Build outputs are generated at the repository root; edit src/styles.css for style changes. The public release repository is UNcore-gh/UNreader.