wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About

© 2026 winget.ragerworks.com

Loading...
Install truyenazz-crawler using Winget - wingetCollections
  1. Go back
  2. Packages
  3. truyenazz-crawler
truyenazz-crawler logo

truyenazz-crawler Kurokeita

Use this command to install truyenazz-crawler:
winget install --id=Kurokeita.TruyenazzCrawler -e

truyenazz-crawler is a Rust command-line crawler designed to download chapters from truyenazz.me novels as clean local HTML files and build them into an EPUB format with metadata, cover images, and embedded font support.

Key Features:

  • Crawl individual chapters or entire ranges from a truyenazz novel URL.
  • Automatically detect the latest available chapter when --end is omitted.
  • Save chapters in a per-novel output directory as clean HTML files.
  • Build an EPUB from crawled chapters or existing chapter folders.
  • Support for sequential or parallel downloading with multiple workers.
  • Customize behavior for handling existing chapter files (ask, skip, overwrite).
  • Interactive TUI wizard for streamlined crawling and EPUB building.
  • Cross-platform support through GitHub Actions, including Linux, Windows, macOS Intel, and macOS ARM.

Audience & Benefit: Ideal for Rust developers and users familiar with command-line tools who want to organize, preserve, and read their favorite truyenazz novels offline in a reader-friendly format without ads or external dependencies. The EPUB output ensures compatibility with most e-book readers and devices while maintaining high-quality formatting with optional embedded fonts.

The tool can be installed via winget for ease of use on supported platforms.

README

truyenazz-crawler

Rust command-line crawler for truyenazz novels. It downloads chapter ranges as clean local HTML files and can package those saved chapters into an EPUB with metadata, cover image, and embedded font support.

Features

  • Crawl one chapter or a chapter range from a truyenazz novel URL.
  • Automatically discover the latest available chapter when --end is omitted.
  • Save chapters under a per-novel output directory as chapter_NNNN.html.
  • Build an EPUB from newly crawled chapters or from an existing chapter folder.
  • Run sequentially or with multiple download workers.
  • Choose how to handle existing chapter files: ask, skip, or overwrite.
  • Use an interactive TUI wizard with live download and EPUB build screens.
  • Build release binaries for Linux, Windows, macOS Intel, and macOS ARM through GitHub Actions.

Requirements

  • Rust stable toolchain
  • Network access to fetch novel pages and cover images

Quick Start

cargo build --release

Run the binary from Cargo:

cargo run -- "https://truyenazz.me/your-novel" --start 1 --end 10

Or run the compiled binary:

./target/release/truyenazz-crawl "https://truyenazz.me/your-novel" --start 1 --end 10

Output is written to output//chapter_NNNN.html by default.

Common Commands

Start the interactive wizard:

cargo run -- --interactive

Crawl chapters and build an EPUB:

cargo run -- "https://truyenazz.me/your-novel" --start 1 --end 50 --epub

Let the crawler discover the latest chapter:

cargo run -- "https://truyenazz.me/your-novel" --start 1 --epub

Use four parallel workers and skip files that already exist:

cargo run -- "https://truyenazz.me/your-novel" --start 1 --end 100 --workers 4 --if-exists skip

Build an EPUB from an existing chapter directory:

cargo run -- "https://truyenazz.me/your-novel" --epub-only --chapter-dir output/your_novel

Embed a custom font in the EPUB:

cargo run -- "https://truyenazz.me/your-novel" --epub --font-path /path/to/font.ttf
Versions
1.0.1
Website
github.com
License
Last updated
5/6/2026
Download latest version

CLI Options

truyenazz-crawl [OPTIONS] [BASE_URL]

Options:
  --start               Start chapter number, inclusive
  --end                 End chapter number, inclusive
  --output-root       Root output directory [default: output]
  --delay         Delay between sequential requests [default: 0.5]
  --workers             Number of concurrent download workers [default: 1]
  --epub                   Build an EPUB after crawling
  --epub-only              Build an EPUB from existing saved chapter files
  --chapter-dir       Existing chapter directory for --epub-only
  --font-path        Font file to embed instead of the bundled font
  --if-exists      ask, skip, or overwrite [default: ask]
  --fast-skip              Skip remote checks when the destination file already exists
  -i, --interactive        Launch the interactive TUI
  -h, --help               Show help
  -V, --version            Show version

--workers > 1 requires --if-exists skip or --if-exists overwrite, because interactive per-file prompts are only safe in the sequential path.

How It Works

flowchart TD
    A["User runs truyenazz-crawl"] --> B["cli parses arguments"]
    B --> C{"interactive or missing URL?"}
    C -->|yes| D["ui wizard collects plan"]
    C -->|no| E["build non-interactive plan"]
    E --> F["fetch main page"]
    F --> G["discover title and latest chapter"]
    D --> H["InteractivePlan"]
    G --> H
    H --> I{"mode"}
    I -->|crawl| J["runner downloads chapter range"]
    I -->|crawl + epub| J
    I -->|epub only| N["use existing chapter directory"]
    J --> K{"workers"}
    K -->|1| L["sequential crawler"]
    K -->|many| M["parallel crawler"]
    L --> O["crawler fetches chapter HTML"]
    M --> O
    O --> P["parse title and chapter paragraphs"]
    P --> Q["write chapter_NNNN.html"]
    Q --> R{"build EPUB?"}
    N --> R
    R -->|no| S["finish"]
    R -->|yes| T["epub reads saved chapters"]
    T --> U["fetch metadata and cover"]
    U --> V["package EPUB zip"]
    V --> S

Code Layout

  • src/cli.rs: argument parsing and option validation.
  • src/bin/truyenazz-crawl.rs: process entry point and top-level orchestration.
  • src/crawler/: chapter HTML fetching, parsing, latest-chapter discovery, and file writes.
  • src/runner.rs: sequential and parallel chapter runners with progress events.
  • src/epub/: metadata extraction, saved-chapter reading, EPUB XML/XHTML generation, and archive writing.
  • src/ui/: interactive TUI widgets, screens, wizard state, and plan summary.
  • src/utils.rs: shared URL, filesystem, text-cleaning, and slug helpers.
  • src/font.rs: embedded font metadata extraction.

Testing

Run the full test suite:

cargo test

Run a focused test target:

cargo test --test epub

CI and Releases

GitHub Actions are configured for:

  • PR and main branch CI: run tests and build all supported platforms.
  • Tag releases: when a v* tag is pushed, build and upload release artifacts for:
    • Linux x86_64
    • Windows x86_64
    • macOS Intel
    • macOS ARM

Create a release by pushing a version tag:

git tag v0.1.0
git push origin v0.1.0