Metadata-Version: 2.4
Name: web-novel-scraper
Version: 2.4.0
Summary: Python tool that allows you to scrape web novels from various sources and save them to more readable formats like EPUB.
Project-URL: Homepage, https://github.com/ImagineBrkr/web-novel-scraper
Project-URL: Documentation, https://web-novel-scraper.readthedocs.io
Project-URL: Repository, https://github.com/ImagineBrkr/web-novel-scraper.git
Author-email: ImagineBrkr <salvattore_25@hotmail.com>
Keywords: Novel Downloader,Scraper,Web Novel,Web Novel Downloader,Web Novel Scraper
Requires-Python: >=3.10
Requires-Dist: bs4>=0.0.2
Requires-Dist: click<9,>=8.0
Requires-Dist: dataclasses-json<1,>=0.6.7
Requires-Dist: ebooklib<1,>=0.18
Requires-Dist: ftfy<7,>=6.3.1
Requires-Dist: platformdirs
Requires-Dist: python-dotenv
Requires-Dist: requests
Description-Content-Type: text/markdown

# 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
``` bash
pip install web-novel-scraper
```
### 2. Download Your First Novel

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

- **Add metadata**:
``` bash
web-novel-scraper set-metadata -t "My First Novel" --author "Author" --language "en"
```
- **Add cover image**:
``` bash
web-novel-scraper set-cover-image -t "My First Novel" --cover "path/to/image.jpg"
```
- **View novel information**:
``` bash
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/](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.
