+ 🚀 真白萌小说站 https://masiro.me 已经得到支持 🚀
+ 🚩 轻小说文库 https://www.wenku8.net/login.php 已经得到支持 🚩

Crawl light novel from some websites and convert it to epub.

指标分类	指标集
Software Version
Code Style
Code Statistics
Code Activity
Code Quality
CI Status

A picture is worth a thousand words. Talk is cheap, show me the real effect.

This demo uses this screen recorder tool to record.

• flexible has_illustration and divide_volume option for epub output
• support downloading a certain volume of a novel
• built-in http request retry mechanism to improve network fault tolerance
• built-in random browser user_agent through fake_useragent library
• built-in strict integrity check about image download
• built-in mechanism for saving temporary book data by pickle library
• use asyncio/multiprocessing to download images
• support adding custom css styles to epub

在愉快的自动化爬虫之前，有必要进行声明。 网页Web端总会存在请求错误，请求延迟，还需要不断手动来点击【下一页】按钮来浏览阅读，这无疑打断了正常的阅读心流。 此项目的初衷正是为了构造良好流畅、不间断的轻小说本地阅读体验。

但是，这不应该成为加重目标网站运行负载的理由。请正常使用本项目，请勿用于线性探测下载，或无限遍历下载。

免责声明：此项目不能保证它不会遭到滥用，对于有可能引发的不良后果，本项目概不负责。

序号	网站名称	语言	爬虫难度	支持进度	备注	技术难点
1	哔哩轻小说（Mobile）	简 / 繁	中😰		不用登录 一章多页	JS 文本混淆 JS 文件随机 章节链接破损 Cloudflare 保护 限流
2	哔哩轻小说（Web）	简 / 繁	中😰		资源同 Mobile，没必要。	N/A
3	轻之国度	简 / 繁	高🤣		需要登录	轻币门槛 导航混乱
4	无限轻小说	繁	中😰		不用登录 一章多页	N/A
5	轻小说文库	简 / 繁	低😆		不用登录 一章一页	无
6	轻小说百科	简 / 繁	低😆		不用登录 一章一页 插图清晰度低	N/A
7	真白萌	简 / 繁	中😰		一章一页	需要登录 积分购买 等级限制 CF turnstile 限流
8	百合会新站	简 / 繁	中😰	搁置	可选[登录] 一章一页	付费章节需要登录 coin 购买

爬虫友好度有两个重要指标：

1. 访问门槛。是否需要登陆、积分/代币购买，等级限制。
2. 页面结构。一章多页，或者一章一页。

优质的轻小说目标源标准：资源丰富，更新迅速，插图清晰，爬虫门槛合理。可以在 issue 发起补充。

1. clone this repo

git clone https://github.com/lightnovel-center/linovelib2epub.git

2. set up a clean local python venv

See also: creating-virtual-environments

replace py with your real python command if needed. e.g. python or python3.

# Make sure you are under this project root folder: linovelib2epub/
# The following instructions are based on Windows 10.
# If you use a different os, please adjust it according to the actual situation.

# new a venv
py -m venv .venv

# activate venv
.\.venv\Scripts\activate

# install dependencies
py -m pip install -r requirements.txt

# install this package in local
python -m pip install -e .

注意: 由于爬虫程序对时效非常敏感，而 pypi 发布的版本非常缓慢和滞后，因此目前强烈不推荐这种安装方式。

1. Install this package from pypi:

pip install linovelib2epub

2. update to the latest version:

pip install linovelib2epub --upgrade

target site: https://w.linovelib.com

2024-3-19 Update: Now linovelib also has a cloudflare access protection and requests rate limit. In order to decrease the probability of being banned by Linovelib, it is highly recommended to set the delay parameters as follows. You can tune the delay parameters to fit your actual network environment.

LinovelibMobile has two language versions(zh/zh-CN or zh-TW/zh-HK) and two UI version(PC or mobile).

So the target website has 2 x 2 = 4 choices.

❌*: Updates[2024-05-14].Now drission page library can't visit www.bilinovel.com(mobile version) on PC. So it doesn't work. No workaround now.

Create a python file(e.g. usage_demo.py) and edit the content as follows:

Example usages:

• Specify target_site:

The code below takes PC + zh/zh-CN version as an example, adjust as needed if your target version is different.

from linovelib2epub import Linovelib2Epub, TargetSite

if __name__ == '__main__':
    linovelib_epub = Linovelib2Epub(book_id=2356, target_site=TargetSite.LINOVELIB_PC)

    # linovelib_epub = Linovelib2Epub(book_id=2356,target_site=TargetSite.LINOVELIB_PC_TRADITIONAL)

    # linovelib_epub = Linovelib2Epub(book_id=2356)
    # linovelib_epub = Linovelib2Epub(book_id=2356,target_site=TargetSite.LINOVELIB_MOBILE)

    # linovelib_epub = Linovelib2Epub(book_id=2356,target_site=TargetSite.LINOVELIB_MOBILE_TRADITIONAL)
    linovelib_epub.run()

• Tune delay-related parameters[optional but recommend]

from linovelib2epub import Linovelib2Epub

if __name__ == '__main__':
    linovelib_epub = Linovelib2Epub(book_id=2356, target_site=TargetSite.LINOVELIB_PC)
    linovelib_epub.run()

The default value of chapter_crawl_delay is 3(s) and page_crawl_delay is 2(s). You can tune them to other values as needed.

The example code is as follows to increase the value of all delay parameters.

from linovelib2epub import Linovelib2Epub, TargetSite

if __name__ == '__main__':
    linovelib_epub = Linovelib2Epub(book_id=3721, target_site=TargetSite.LINOVELIB_PC,
                                    chapter_crawl_delay=5, page_crawl_delay=3)
    linovelib_epub.run()

• download only selected volume(s)[optional]

from linovelib2epub import Linovelib2Epub, TargetSite

if __name__ == "__main__":
    linovelib_epub = Linovelib2Epub(book_id=2356, target_site=TargetSite.LINOVELIB_PC,
                                    select_volume_mode=True
                                    )
    linovelib_epub.run()

• disable network proxy[optional]

This project will disable any proxy settings when crawling. So you should manually activate it by disable_proxy=False if you want to use your local proxy.

from linovelib2epub import Linovelib2Epub, TargetSite

if __name__ == "__main__":
    linovelib_epub = Linovelib2Epub(book_id=2356, target_site=TargetSite.LINOVELIB_PC,
                                    disable_proxy=False,
                                    )
    linovelib_epub.run()

• view more details about crawling[optional]

Due to time sensitivity or environmental differences, web crawlers are very prone to failure. You can view more of the underlying details if turn on debug mode.

from linovelib2epub import Linovelib2Epub, TargetSite

if __name__ == "__main__":
    linovelib_epub = Linovelib2Epub(book_id=2356, target_site=TargetSite.LINOVELIB_PC,
                                    log_level="DEBUG",
                                    )
    linovelib_epub.run()

The following is a common crawler configuration that can be used as a reference.

from linovelib2epub import Linovelib2Epub, TargetSite

if __name__ == "__main__":
    linovelib_epub = Linovelib2Epub(book_id=2356, target_site=TargetSite.LINOVELIB_PC,
                                    chapter_crawl_delay=5, page_crawl_delay=3,
                                    select_volume_mode=True,
                                    # disable_proxy=False,
                                    # log_level="DEBUG",
                                    )
    linovelib_epub.run()

If it finished without errors, you can see the epub file is under the folder where your python file is located.

target site: https://masiro.me

2024-02-22 Update: Now Masiro has a very strict cloudflare turnstile protection and requests rate limit. The code has been refactored to bypass the cloudflare turnstile using a python library called DrissionPage. DrissionPage will auto-detect and use Chrome browser. If you encounter a path error of Chrome browser, please set the browser_path parameter to Linovelib2Epub().

from linovelib2epub import Linovelib2Epub, TargetSite

if __name__ == '__main__':
    linovelib_epub = Linovelib2Epub(book_id=1039, target_site=TargetSite.MASIRO)
    linovelib_epub.run()

Or specify browser path:

from linovelib2epub import Linovelib2Epub, TargetSite

# Chromium-based browser is ok
browser_path = "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"

if __name__ == '__main__':
    linovelib_epub = Linovelib2Epub(book_id=1039, target_site=TargetSite.MASIRO, browser_path=browser_path)
    linovelib_epub.run()

Masiro is not the default target site, so you MUST specify target_site parameter as above.

And Masiro website need user login credential to view novel. You also MUST to create a config file named .secrets.toml beside your python file usage_demo.py. For better explanation, Here's a reasonable directory organization:

linovelib2epub/
  ......
  .secrets.toml
  usage_demo.py

Then edit your .secrets.toml file:

MASIRO_LOGIN_USERNAME = '<your-masiro-username>'
MASIRO_LOGIN_PASSWORD = '<your-masiro-password>'

🚨 Don't leak your private account info!!! Be careful.

Masiro 某些小说存在用户等级限制，程序执行会发生什么？

程序会给出提示，并直接退出。

Masiro 某些小说的章节需要积分购买才能查看，程序会如何处理？

登陆后，程序会记住你的当前积分余额：

• 如果当前挑选的所有章节都是免费积分，或者你之前已经全部购买过，那么程序会直接往下执行。
• 如果当前挑选的所有章节存在需要积分购买的情况，程序会再次提示，要求做出选择，此时可以选择退出或者选择继续。

target site: https://www.wenku8.net

from linovelib2epub import Linovelib2Epub, TargetSite

if __name__ == '__main__':
    linovelib_epub = Linovelib2Epub(book_id=2961, target_site=TargetSite.WENKU8)
    linovelib_epub.run()

Don't need login, no threshold.

需要重新分析和修订的参数：

下面的参数暂时无效或者不可用，需要重新设计或者删除。

• quality: setup pytest and codecov
• quality: setup more formatter and linter for maintainability
• masiro 繁体 <=> 简体
• add installation alternatives: from pypi to git protocol

Here are some description about internal mechanism of this project.

GokouRuri 🐛 💻	xxxfhy 🐛	lesfox 🐛	Holence 💻	Nikaidou Haruki 🐛 💻	kaho 🐛	Papersman 🐛
inkroom 🐛 💻	Kuan-Lun 🐛	CutyIMoDo 🐛	Neco_arc 🐛

• biliNovel2Epub => 哔哩轻小说参考。
• lightnovel-pydownloader => 真白萌 / 轻之国度 / 百合会旧站参考。
• bili_novel_packer => 哔哩轻小说 /wenku8 参考。