FreePEP

Project Overview

FreePEP is an automated parsing, bulk crawling, and high-resolution PDF merging tool built for the People's Education Press (PEP) primary and secondary school e-textbook platform. It offers both a WebUI and an interactive command line, with a full catalog, an automatic decryption engine, and a captcha cracking mechanism.

Key Features

• Two operation modes: a modern WebUI and an interactive CLI
• High-resolution page download and PDF merging: auto-detects total pages, downloads original JPGs, and merges them into PDF with Pillow
• Built-in automatic decryption engine for a catalog of over 780 textbooks
• Automatic Alibaba Cloud WAF slider captcha cracking
• Filter by stage, subject, and grade, with global keyword search
• download_all.py supports multi-threaded downloads, stage/grade directory archiving, resumable transfer, and automatic slice cleanup
• One-click packaging into a standalone Windows EXE with a bundled portable Chromium

Target Audience

• Teachers, students, and parents who need to obtain PEP e-textbooks in bulk
• Hobbyists learning web crawling and reverse engineering
• Users who want to save high-resolution textbook PDFs offline

Quick Start

1. Download the release package, unzip it, and run FreePEP.exe to use the web page; or clone the repo to run from source
2. From source, run pip install -r requirements.txt and playwright install chromium
3. Run python webui.py to start the WebUI and visit http://127.0.0.1:8000
4. Or use python cli.py for interactive download, or pass arguments directly such as python cli.py --xd 高中 --xk 数学 -y

Core Advantages

• Provides both WebUI and CLI, balancing ease of use and automation
• Built-in decryption engine and full catalog, supporting high-res and normal quality
• Multi-threaded download, resumable transfer, and auto cleanup for high efficiency
• Can be packaged into a standalone EXE that needs no Python environment

System Requirements

• OS: Windows, macOS (running from source)
• Architecture: depends on the system
• Additional dependencies: a Python environment, the requirements.txt packages, and the Playwright Chromium engine

Notes

• The project is for technical exchange and personal study only; commercial use is strictly prohibited
• Textbook copyright belongs to the People's Education Press and related rights holders
• Please control request frequency, delete downloads within 24 hours, and buy genuine copies for long-term use
• On macOS, if the Playwright engine is missing when running from source, downloads fail due to a missing executable