noveltui

Crates.ionoveltui
lib.rsnoveltui
version0.1.1
created_at2026-01-15 02:52:25.455609+00
updated_at2026-01-15 07:09:31.293132+00
descriptionA terminal-based novel reader (TUI)
homepage
repositoryhttps://github.com/minxuanz/noveltui
max_upload_size
id2044408
size3,513,375
Min (minxuanz)

documentation

README

English | δΈ­ζ–‡

Noveltui

A tui novel reader, Powered by ratatui

Features

  • Lightweight & Efficient: Small binary size, low memory usage
  • Chapter Parsing: Automatically detects and navigates chapters by regex and generate toc
  • Bookmarks: Add, remove, and manage bookmarks for easy navigation
  • Auto-Read Mode: Hands-free reading with automatic scrolling
  • Read from website: dzstui can read from website (WIP)

Installation

cargo install noveltui
# only install noveltui
cargo install noveltui --bin noveltui
# only install dzstui
cargo insatll noveltui --bin dzstui

Build from Source

git clone https://github.com/minxuanz/noveltui.git
cd noveltui
cargo build --release

target/release/noveltui read from local txt
target/release/dzstui read from website

Usage

./noveltui path/to/your/novel.txt
./dzstui --url website
#e.g.
./dzstui --url https://ixdzs8.com/read/508569/p1.html

Tips: dzstui only supoort https://ixdzs8.com/ now, and need install chrome

Supported

os

  • windows
  • linux
  • macos (not test)

format & encoding

  • txt (UTF-8, GBK, GB2312, etc.)

Chapter Detection(noveltui)

You can pass --regex <YOUR CUSTOM REGEX> to parse title.

./noveltui --regex="^(\d+)([\u4e00-\u9fff0-9]+)$" path/to/your/novel.txt

Keybindings(noveltui)

Key Action
q Add bookmark then Quit
Q Quit
j / ↓ Scroll down
k / ↑ Scroll up
n Next Charpter
p Prev Charpter
m Toggle bookmark
M Delete all bookmarks
Space Toggle auto-read mode
b Toggle bookmark menu
t Toggle toc
ctrl + z Suspend (unix)

content Content

toc toc

bookmark bookmark

toc in tmux

dzstui (online read) (WIP)

dzstui dzstui

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

Commit count: 0

cargo fmt