Skip to main content

Offline web novel scraper and library manager

Project description

novel-cli

A CLI tool for scraping and managing web novels offline, with an optional web viewer.

Install

git clone https://github.com/YOUR_USERNAME/novel-cli.git
cd novel-cli
pip install -e .

Usage

# Add a novel to your reading list
novel add https://www.royalroad.com/fiction/12345/some-novel

# Scrape all novels (downloads chapters)
novel scrape

# Scrape a single novel
novel scrape "Novel Title"

# Update stats only (no chapter download)
novel update-stats

# List your library
novel list

# Show novel details
novel show "Novel Title"

# Remove a novel
novel remove "Novel Title"

# Export library
novel export json
novel export csv

# Show stats
novel stats

# Clean orphaned data
novel clean

Web Viewer (optional)

cd viewer && pnpm install
novel read
# Opens at http://localhost:4173

Data is stored in ~/.novel-library/.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

novel_cli-0.1.0.tar.gz (30.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

novel_cli-0.1.0-py3-none-any.whl (33.4 kB view details)

Uploaded Python 3

File details

Details for the file novel_cli-0.1.0.tar.gz.

File metadata

  • Download URL: novel_cli-0.1.0.tar.gz
  • Upload date:
  • Size: 30.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for novel_cli-0.1.0.tar.gz
Algorithm Hash digest
SHA256 c6acc71ea994aaa6fac20187fabbbcc0ac34d06524ab0945aa888940c18ec5e2
MD5 2aa9a49a52c32455b4d46100789abed8
BLAKE2b-256 9ddb32cefe58d33c08a216b7ff3a9ea69369abb867e6f3bc20f643cd13ab6381

See more details on using hashes here.

File details

Details for the file novel_cli-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: novel_cli-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 33.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for novel_cli-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9fc7b203c6eaf73ac42df9a5d0d022a9d67aeb7ff6a63faf729cd3e6beef36e0
MD5 9c925cb3634a1effbd0bd75a94a218a9
BLAKE2b-256 a329c5879da1c9a2bfdead4a3cc42ff16b37eea54cfeea745ea9f1136cd6696f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page