hect0x7/jmcomic-crawler-python

★ 5,764PythonAudience · developerComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((repo))
    Download
      Album by ID
      CLI command
      GitHub Actions
    Config
      Image format
      Thread count
      Proxy settings
    Client Modes
      Mobile app mode
      Browser mode
    Plugins
      PDF converter
      Zip output
      Email alerts
      Skip downloaded
    API
      Python interface
      Encryption support

mindmap root((repo)) Download Album by ID CLI command GitHub Actions Config Image format Thread count Proxy settings Client Modes Mobile app mode Browser mode Plugins PDF converter Zip output Email alerts Skip downloaded API Python interface Encryption support

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Download an entire comic album by entering its numeric ID in one terminal command

USE CASE 2

Automate batch comic downloads via a Python script with custom thread and proxy settings

USE CASE 3

Convert downloaded images to PDF or a single tall image using built-in plugins

USE CASE 4

Trigger downloads through GitHub Actions without installing Python locally

Tech stack

PythonPyPIGitHub ActionsReadTheDocs

Getting it running

Difficulty · easy Time to first run · 5min

Requires Python 3.9+, Python 3.12+ recommended. Install with pip install jmcomic. Run immediately via CLI: jmcomic <id>. Full docs on ReadTheDocs.

License not mentioned in the explanation.

In plain English

JMComic-Crawler-Python is a Python library and command-line tool for downloading content from a specific adult comics website. The README is written primarily in Chinese. The project wraps the website's API into a Python interface so that users can download entire comic albums with a few lines of code or a single terminal command. The basic usage requires knowing the numeric ID of a comic on the site. A user can then either run a command like jmcomic 123 in the terminal, call the Python function jmcomic.download_album('123') in a script, or trigger a download directly through GitHub Actions by entering the ID into a web form, with no local Python installation needed for that last option. The library supports a configuration file where users can set options such as which image format to save files in, how many threads to use for parallel downloading, whether to use a proxy, and which client mode to use. There are two client modes: one that mimics the website's mobile app (works from more locations) and one that mimics the web browser (faster but restricted by region). The tool handles the site's anti-bot measures and implements the encryption and decryption used by the mobile app's API. A plugin system lets users extend the tool's behavior. Built-in plugins cover things like converting downloaded images to PDF or a single tall image, sending an email notification when a download completes, skipping chapters already downloaded, compressing output into a zip file, and logging hardware usage during a run. Users can also write their own plugins. The project requires Python 3.9 or later, with Python 3.12 or newer recommended. It is installable from PyPI with pip install jmcomic and has fuller documentation hosted on ReadTheDocs.

Copy-paste prompts

Prompt 1

I have the jmcomic Python library installed. Write a Python script that reads a list of comic IDs from a text file and downloads each one using jmcomic.download_album(), skipping any that have already been downloaded.

Prompt 2

Using the jmcomic library, write a config file that sets parallel threads to 8, enables a proxy at 127.0.0.1:7890, saves images as jpg, and activates the PDF conversion plugin after each download.

Prompt 3

Show me how to write a custom jmcomic plugin that sends a Slack webhook notification when a download finishes, following the project's plugin interface conventions.

Open on GitHub → Explain another repo

← hect0x7 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.