cosplay

A gallery downloader for hentai-cosplay-xxx.com with both a web UI and CLI interface. Downloads full-size images from galleries, supports parallel/sequential downloads, search, and ZIP archiving.

Features

• Web UI — browse, search, and download galleries from your browser
• CLI mode — run as a local server with configurable host/port
• Search — keyword search with pagination
• Popular — load trending galleries from the homepage
• Parallel/Sequential — download multiple galleries at once or one at a time
• ZIP archives — optionally package downloaded galleries into .zip files
• Auto-skip — 404 and "not found" pages are detected and skipped automatically
• Resume — tracks previously downloaded URLs to avoid re-downloading

Requirements

• Python 3.7+
• requests
• Flask
• Flask-CORS
• beautifulsoup4
• urllib3

Install dependencies:

pip install -r requirements.txt

Usage

python cosplay.py [--port PORT] [--host HOST]

Opens the web UI at http://127.0.0.1:5000 by default.

Options

Flag	Default	Description
--port	5000	Web UI port
--host	127.0.0.1	Web UI bind address

Project structure

cosplay/
├── cosplay.py        # Main application (CLI + Web UI)
├── downloads/        # Downloaded galleries (created on first run)
└── downloaded_urls.json  # Tracks completed downloads

Notes

• TLS verification is disabled by default.
• Up to 10 galleries can download in parallel (configurable via the semaphore in code).
• Each gallery uses up to 10 worker threads for image downloads.
• Gallery folders are numbered sequentially in the downloads/ directory.