@rafsunboss/manga-rafsun

A powerful command-line tool to automate searching, downloading, and extracting text from manga. Converts chapters into high-quality PDFs while preserving the original JPG images and generating OCR-accurate text files.

This is the NPM wrapper for the original python tool.

Features

• Smart Search: Search by manga name or paste a direct URL from supported sites.
• Chapter Selection: Download specific ranges (e.g., 1-10), from a starting point to the end (20-), or the first N chapters (10).
• JPG + PDF Support: Downloads original high-quality images and automatically compiles them into a single PDF per chapter.
• OCR Support: Extract English text from manga bubbles.
• History Tracking: Automatically detects which chapters you've already downloaded and shows "Missing" chapters.

Prerequisites

Because manga-rafsun is a wrapper for a powerful Python ecosystem, your system must have:

• Node.js (v14.0+)
• Python 3.10+ installed and available in your PATH.

The wrapper script will attempt to automatically install the required python packages:

• requests
• beautifulsoup4
• rich
• Pillow
• pytesseract
• opencv-python
• gallery-dl

Optional for OCR: Tesseract OCR engine must be installed on your system (apt install tesseract-ocr, brew install tesseract, etc.).

Installation

npm install -g @rafsunboss/manga-rafsun

Usage

Run the following command anywhere:

manga-rafsun

Downloads will be saved by default to a MANGA directory inside your user's home folder (~/MANGA/).

🛠️ Developer Guide (How to Update)

Updating the tool on GitHub and NPM:

1. Make your code changes in manga_cli.py or bin/manga-rafsun.js.
2. Open package.json and increase the "version" (e.g., 1.0.1 -> 1.0.2).
3. Load your tokens by running:

   source .env

   (Note: Ensure your NPM_TOKEN inside .env is a token with "Publish" permissions for all packages).
4. Push your changes to the private GitHub repository:

   git add .
   git commit -m "Update tool"
   git push

5. Publish the new version to NPM:

   npm publish --access public