lightnovel crawler

by nntin


Lightnovel Crawler

Build Status Build status Python version PyPI version Downloads License

Downloads lightnovels from various online sources and generates ebooks in many formats.



Table of contents

(A) Installation

This application uses Calibre to convert ebooks.
Install it from
Without it, you will only get output in epub, text, and web formats.

Also, you have to install node.js to access cloudflare enabled sites (e.g. Download and install node.js from here:

A1. Standalone Bundle (Windows, Linux)

Windows: lightnovel-crawler v2.16.2 ~ 21MB

In Windows 8, 10 or later versions, it might say that lncrawl.exe is not safe to dowload or execute. You should bypass/ignore this security check to execute this program. Actually, I am too lazy to add proper configuration files to solve this issue. Excuse me please 😇.

Linux: lightnovel-crawler v2.16.0 ~ 27MB

Copy it to /usr/bin or ~/.local/bin to make it accessible in terminal. Or, you can create a launcher to easily access the app.

A2. PIP (Windows, Mac, and Linux)

📦 A python package named lightnovel-crawler is available at pypi.

Make sure you have installed Python v3.5 or higher and have pip enabled. Visit these links to install python with pip in Windows, Linux and MacOS. Feel free to ask on the Discord server if you are stuck.

To install this app or to update installed one via pip, just run:

$ pip install --user -U lightnovel-crawler

Remember, in some cases you have to use python3 -m pip or pip3 or python -m pip. And you do not need --user option, if you are running from root.

Next, open your terminal and enter:

$ lightnovel-crawler

# Or, a shortcut:
$ lncrawl

To view extra logs, use: lncrawl -lll

A3. Termux (Android)

📱 Using Termux, you can run this app in your android phones too. Follow this instructions:

  • Install Termux from playstore.
  • Open the app and run these commands one by one:
    • apt update && apt upgrade
    • termux-setup-storage
    • pkg install ndk-sysroot make python zlib clang
    • pkg install libxml2 libxslt libiconv libcrypt libffi zlib libjpeg-turbo
    • pkg install nodejs-lts
    • pip install -U lightnovel-crawler to install the latest version of this app.
  • Now exit the console and relaunch it.
  • Type cd ~/storage/downloads to store novels there.
  • Type lncrawl to start.
  • You navigate up using Volume UP + W and down using Volume UP + S.
  • Run pip install -U lightnovel-crawler again to install the latest updates.

A4. Pydroid 3 (Android)

📱 Alternative to easy Termux is Pydroid3. It is a bit faster but harder to use and no run-in-backgroud support.

  • Install Pydriod 3 from playstore.
  • Open the app and navigate to Pip from the drawer menu.
  • Type lightnovel-crawler in place of Library name and press the Install button.
  • To reinstall or remove the installed package:
    • Go to Libraries tab inside Pip page (left of Install tab).
    • Find lightnovel-crawler and press the Uninstall button.
    • Then go over to Install tab again to install the latest version.
  • To use the app, select Terminal from the drawer menu. A console will appear.
  • Type lncrawl to start.
  • You navigate up using Volume UP + W and down using Volume UP + S.

Here is a video that might help:

A5. Chatbots

A5.1 Telegram

Visit this link to get started with the telegram bot:

A5.2 Discord

Join our server:

Or, visit this link to install discord bot to your own server:

Send !help to open the bot help message.

A6. Run from source

  • First clone the repository:
$ git clone
  • Open command prompt inside of the project folder and install requirements:
$ pip install --user -r requirements.txt
  • Run the program (use python v3.5 or higher):
$ python

# Or, in short,
$ python .

A7. Heroku Deployment

Simply fill out the environment variables and you get a running instance.


(B) General Usage

B1. Available options

To view list of available options:

$ lncrawl -h
                           📒 Lightnovel Crawler 🍀2.16.0
usage: lncrawl [options...]
       lightnovel-crawler [options...]

optional arguments:
  -h, --help            show this help message and exit

  -v, --version         show program's version number and exit
  -l                    Set log levels. (-l = warn, -ll = info, -lll = debug).
  --list-sources        Display a list of available sources.
  -s URL, --source URL  Profile page url of the novel.
  -f, --force           Force replace any existing folder.
  -i, --ignore          Ignore any existing folder (do not replace).
  --login USER PASSWD.  User name/email address and password for login.
  --all                 Download all chapters.
  --first [COUNT]       Download first few chapters (default: 10).
  --last [COUNT]        Download last few chapters (default: 10).
  --page START STOP.    The start and final chapter urls.
  --range FROM TO.      The start and final chapter indexes.
  --volumes [N [N ...]]
                        The list of volume numbers to download.
  --chapters [URL [URL ...]]
                        A list of specific chapter urls.
  --bot {console,telegram,discord,test}
                        Select a bot. Default: console.
  --suppress            Suppress all input prompts and use defaults.
  ENV                   [chatbots only] Pass query string at the end of all
                        options. It will be use instead of .env file. Sample:


B2. Running the bot

There are two chatbots available at this moment: Telegram and Discord. To run your own bot server, follow these instructions:

# Clone this repository
$ git clone
# Install requirements
$ pip3 install --user -r requirements.txt
$ pip3 install --user -r bot_requirements.txt
# Edit the environment variables
# You should give your API keys and log info here
# Also specify which bot server you want to run
$ cp .env.example .env
$ vim .env
# Run the server using:
$ python3 .

There is a script to run a bot in ubuntu servers. It will basically execute the python and send the task to run in background. I use it to run my discord bot in the server.

(C) Development

You are very welcome to contribute in this project. You can:

  • create new issues pointing out the bugs.
  • solve existing issues.
  • add your own sources.
  • add new output formats.
  • create new bots.

C1. Adding new source

C2. Adding new Bot

C3. Supported sources

Request new one by creating a new issue.

The list of currently available sources are given below:

Available Sources Search Enable http://novelfull.com https://babelnovel.comhttps://bestlightnovel.com https://boxnovel.com https://id.mtlnovel.comhttps://kisslightnovels.infohttps://light-novel.onlinehttps://litnet.com https://m.wuxiaworld.co https://mtled-novels.com https://novelonlinefull.comhttps://novelplanet.com https://wuxiaworld.online https://www.machine-translation.orghttps://www.mtlnovel.comhttps://www.novelall.com https://www.readnovelfull.com https://www.royalroad.comhttps://www.scribblehub.com https://www.webnovel.comhttps://www.worldnovel.onlinehttps://www.wuxiaworld.co

C4. Rejected sources

Rejected Sources Reason 403 - Forbidden: Access is denied Does not follow uniform format Domain expired Removed Does not like to be crawled Does not like to be crawled Removed Site is down Does not host any novels Site is down Removed

C5. Supported output formats

When download is done, the following files can be generated:

  • JSON (default)
  • TEXT
  • WEB
  • EPUB
  • DOCX
  • MOBI
  • PDF
  • RTF
  • TXT
  • AZW3
  • FB2
  • LIT
  • LRF
  • OEB
  • PDB
  • PML
  • RB
  • SNB
  • TCR
  • HTML

C6. Supported bots

  • Console Bot
  • Telegram Bot
  • Discord Bot

(D) The project structure

Click here to view details.