GitHub Store
ying-ck

fanqienovel-downloader

ying-ck

Fanqienovel-downloader is an open-source Python tool that downloads novels from the Fanqie Novel website, with local CLI, web UI, Docker and mobile Termux run modes.

v1.3.1
Published at
Aug 15, 2026
2,365
Stars
39,906
Download
Synced at
Oct 4, 2026

Latest release

v1.3.1Aug 15, 2026, 02:45 AM
Downloads slow? Switch the source anytime above

README

Project Overview

Fanqienovel-downloader is an open-source tool implemented in Python for downloading novels from Fanqie Novel. It offers several ways to run, including a local command-line program, a web interface, Docker and mobile Termux.

Key Features

  • Download novels via a catalog page link or an id
  • Update previously downloaded novels using ids in record.json
  • Search novels by name
  • Batch download with queue management
  • Configurable leading placeholders, delays, storage location and save mode
  • Back up downloaded novels along with format and leading spaces
  • The web version offers a progress bar, a clean UI and online reading
  • Docker deployment with data stored in docker volumes

Target Audience

  • Users who want to read Fanqie novels offline
  • Users who want to batch back up novels
  • Technical users familiar with Python or Docker
  • Users who need to run it on a phone or server

Quick Start

  1. Local program: run it and enter the full catalog page link or id to download
  2. Interactive menu: enter 1 to update, 2 to search, 3 to batch download, 4 for settings, 5 to back up, 6 to exit
  3. Web version: enter the src folder, run server.py, and open http://localhost:12930 in a browser
  4. Docker version: run docker compose up in the project folder and visit http://localhost:12930
  5. Mobile: install Termux, set up dependencies as described in the README, then run ref_main.py

Core Advantages

  • Multiple run modes covering desktop, server, container and phone
  • The web version has a clean UI with a progress bar and online reading
  • Supports updating and batch downloading for long-term use
  • Open source and actively maintained

System Requirements

  • OS: Windows, macOS, Linux, Android (Termux)
  • Architecture: any
  • Additional dependencies: running needs Python 3.8+ with requests, ebooklib, tqdm, beautifulsoup4 and others

Notes

  • Do not abuse this tool
  • It is for educational and research purposes only; comply with laws and the website usage policy
  • Changing any setting overwrites existing data; to restore defaults, delete config.json
  • If a network proxy error appears, check your connection and try disabling the proxy or using an accelerator

Release history

Sort