LViewer

A desktop reader for comics and novels, built as a sister project to Xplay.

中文 · English

中文

简介

LViewer 是一个本地桌面漫画与小说阅读器，基于 Electron、React、TypeScript 和 Vite 构建。它延续 Xplay 的产品逻辑：顶部工具栏、中央阅读舞台、右侧可隐藏 inspector 面板，并支持多本书自动分屏阅读。

功能

• 导入漫画文件夹，自动按文件名自然排序编排图片。
• 导入 .zip / .cbz 压缩包，自动读取其中图片作为漫画。
• 导入 .txt 小说，按常见中文/英文章节标题自动切分章节。
• 漫画和小说都支持分页阅读与滚动阅读。
• 漫画分页模式会将单张图片完整适配到当前窗口，适合多分屏阅读。
• 支持多本漫画/小说同时打开，阅读舞台自动分屏。
• 支持把文件夹、压缩包、TXT 或图片拖入窗口中自动导入。
• 支持书签、阅读历史和阅读进度持久化。

截图与使用

1. 启动后导入书籍

可以从顶部工具栏选择漫画文件夹、压缩包或 TXT，也可以直接把文件拖到中央阅读舞台。

2. 自动分屏阅读

导入多本书后，LViewer 会自动分屏。右侧面板用于管理书库、筛选类型、查看当前书签和历史记录。

3. 分页 / 滚动模式

每个阅读窗口都有模式切换按钮。漫画分页模式会完整显示当前单页；滚动模式会连续显示多页。小说也可以在章节分页和连续滚动之间切换。

4. 书签与历史

点击阅读窗口中的书签按钮即可保存当前位置。右侧面板会显示当前书签和阅读历史，方便继续阅读。

开发

npm install
npm run dev

npm run dev 会启动 Vite 并打开 Electron 桌面窗口。

只调试前端页面时可以运行：

npm run dev:web

构建

npm run build

打包 Windows 可执行文件

npm run dist

便携版产物会输出到 release/。如果需要安装包：

npm run dist:installer

拖拽说明

Windows 下不要以管理员权限运行 LViewer，否则普通资源管理器拖拽文件到窗口时可能会被系统拦截。普通权限运行即可正常拖入文件夹、压缩包和 TXT。

English

Overview

LViewer is a local desktop reader for comics and novels, built with Electron, React, TypeScript, and Vite. It follows the same product language as Xplay: a top toolbar, a central reading stage, and a collapsible inspector panel on the right.

Features

• Import a comic folder and automatically arrange image files by natural filename order.
• Import .zip / .cbz archives and read image files inside them as a comic.
• Import .txt novels and split them into chapters using common Chinese and English chapter heading patterns.
• Supports both paged reading and scrolling reading for comics and novels.
• Comic paged mode always fits the current image fully inside the reader pane, which is especially important in split-screen mode.
• Open multiple comics or novels at once with automatic split-screen layout.
• Drag folders, archives, TXT files, or images into the reading stage to import them.
• Persist bookmarks, reading history, and reading progress locally.

Screenshots & Usage

1. Import Books

Use the top toolbar to import a comic folder, archive, or TXT file. You can also drag files directly into the central reading stage.

2. Automatic Split Screen

When multiple books are opened, LViewer automatically splits the reading stage. The right inspector panel manages the library, filters, bookmarks, and reading history.

3. Paged / Scroll Reading

Each reader pane has a mode toggle. Comic paged mode shows the current page fully fitted in the pane, while scroll mode displays continuous pages. Novels can also switch between chapter-based paged reading and continuous scrolling.

4. Bookmarks & History

Click the bookmark button in a reader pane to save the current position. The right inspector shows current bookmarks and recent reading history.

Development

npm install
npm run dev

npm run dev starts Vite and opens the Electron desktop window.

For browser-only frontend debugging:

npm run dev:web

Build

npm run build

Package for Windows

npm run dist

The portable executable is written to release/. To build an installer:

npm run dist:installer

Drag-and-Drop Note

On Windows, do not run LViewer as administrator. If the app is elevated but File Explorer is not, Windows may block drag-and-drop. Running LViewer normally allows folders, archives, and TXT files to be dragged into the window.