Skip to main content

Python tool that allows you to scrape web novels from various sources and save them to more readable formats like EPUB.

Project description

Web Novel Scraper CLI

🔑 Why Use Web Novel Scraper?

  • Read Offline: Download your favorite novels and read them anywhere, even without internet
  • Device Friendly: EPUB format optimized for e-readers and mobile devices
  • Resource Efficient: Smart caching system prevents unnecessary downloads
  • Server Friendly: Prevents accidental server overloads
  • Simple Interface: Basic and direct commands for a hassle-free experience
  • Automatic Organization: Keep your novels organized and easy to find

🌟 Main Features

  • Downloads and converts web novels to EPUB format
  • Smart caching: downloads chapters only once
  • Simple and straightforward command-line interface
  • Support for multiple web novel sites

🚀 Quick Tutorial

1. Installation

pip install web-novel-scraper

2. Download Your First Novel

  1. Create a new novel:
web-novel-scraper create-novel -t "My First Novel" --toc-main-url "https://novelbin.me/novel/my-novel/toc"
  1. Convert to EPUB:
web-novel-scraper save-novel-to-epub -t "My First Novel" --sync-toc
  1. Find your files:
web-novel-scraper show-novel-dir -t "My First Novel"

3. Additional Options

  • Add metadata:
web-novel-scraper set-metadata -t "My First Novel" --author "Author" --language "en"
  • Add cover image:
web-novel-scraper set-cover-image -t "My First Novel" --cover "path/to/image.jpg"
  • View novel information:
web-novel-scraper show-novel-info -t "My First Novel"

📱 Supported Sites

  • Novelbin
  • Novelhi
  • Novellive
  • Royalroad
  • GenesisStudio
  • HostedNovel
  • ScribbleHub
  • NovelCool
  • FreeWebNovel
  • Foxaholic
  • Fanmtl
  • Pandamtl
  • MtlNovels

📖 Full Documentation

For a detailed guide, advanced use cases, and complete command reference, visit: https://web-novel-scraper.readthedocs.io/stable/

📝 Responsible Usage Note

Please use this tool responsibly and respect the terms of service and rate limits of the web novel sites.

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

web_novel_scraper-2.9.1.tar.gz (79.1 kB view details)

Uploaded Source

Built Distribution

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

web_novel_scraper-2.9.1-py3-none-any.whl (61.1 kB view details)

Uploaded Python 3

File details

Details for the file web_novel_scraper-2.9.1.tar.gz.

File metadata

  • Download URL: web_novel_scraper-2.9.1.tar.gz
  • Upload date:
  • Size: 79.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for web_novel_scraper-2.9.1.tar.gz
Algorithm Hash digest
SHA256 01998b339a15e368b4a9b90d76a7d450d27df2bcc7a9aba28612480c0e6420cd
MD5 7c78b51652e0e290a8db379695083780
BLAKE2b-256 dc398565d75f7044e130fe13f25e3eae2dab561306e75c0ea3da3d7c0f8faa2b

See more details on using hashes here.

Provenance

The following attestation bundles were made for web_novel_scraper-2.9.1.tar.gz:

Publisher: publish.yaml on ImagineBrkr/web-novel-scraper

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file web_novel_scraper-2.9.1-py3-none-any.whl.

File metadata

File hashes

Hashes for web_novel_scraper-2.9.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8fdf8a38de0e1ed4831faebc2a787051c82c25f5fabd8a95afd890a4c3a192c2
MD5 c6c821aa248cbe8f23342aff5145b169
BLAKE2b-256 e30daecb8f22e4d82db02cb41de16bc3d10020fefc0afef29e3ecd4934601939

See more details on using hashes here.

Provenance

The following attestation bundles were made for web_novel_scraper-2.9.1-py3-none-any.whl:

Publisher: publish.yaml on ImagineBrkr/web-novel-scraper

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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