norkz/comic-downloader repository overview

Fast, reliable, and easy-to-use CLI tool for downloading comics (manga, manhwa, and more) from popular websites.

⁠ ⁠ ⁠ ⁠ ⁠

⁠📚 Table of Contents

⁠🌐 Supported Websites

⁠🚀 Installation

⁠Linux & macOS

1. Download the latest binary from the Releases page⁠.
2. Extract the downloaded archive.
3. Move the binary into a directory within your system's PATH:

sudo mv comic-downloader /usr/local/bin/

Or create Symbolic Link. This way, if you rebuild the binary, the link will still point to the updated file.

sudo ln -s comic-downloader /usr/local/bin/comic-downloader

⁠macOS Users

To bypass the Gatekeeper security prompt, run:

sudo spctl --master-disable

⁠🖥️ Windows

1. Download the latest .exe from Releases⁠.
2. Place the .exe in a directory in your system's PATH (e.g., C:\Windows\System32).

Run via Command Prompt:

comic-downloader [URL] [range]

⁠🐳 Docker

Before running comic‑downloader (whether you use the local CLI or the Docker image), you must start your Browserless & Tenshi containers:

make up

⁠comic-downloader Container

Rrun comic-downloader via Docker Compose with:

docker compose -f docker/containers/comic-downloader/docker-compose.yml up -d --force-recreate

⁠🔧 Environment Setup

1. Copy the example file:

   cp .env.example .env
   

   Copy

2. Open .env and fill in each value (the example is below). At minimum you need:

   # Enable compose bake (optional)
   COMPOSE_BAKE=true
   
   # Tenshi (FastAPI) container credentials
   TENSHI_PASSWORD='tenshi'
   TENSHI_VNC_PASSWORD='xxx'
   
   # Browserless (Chromium) settings
   BROWSERLESS_HOST_IP='xxx.xxx.xxx.xx'
   BROWSERLESS_TOKEN='your_token_here'
   REMOTE_DEBUG_URL='http://localhost:6082'
   FASTAPI_BASE_URL='http://localhost:6081'
   
   # Toggle Docker mode and debug logs
   DOCKER=false
   DEBUG=false
   

   Copy

3. Make sure those containers are up:

   make up
   

   Copy

If you're running locally, the application will connect to:

ws://${BROWSERLESS_HOST_IP}:8454?token=${BROWSERLESS_TOKEN}

If you're running under Docker (i.e. DOCKER=true), it will connect to:

ws://comic-downloader-browserless:3000?token=${BROWSERLESS_TOKEN}

⁠💻 Usage

⁠Basic Usage

Interactive download of all chapters:

comic-downloader [URL]

The URL must be the series' main page.

⁠Chapter Range

Specify specific chapters or ranges:

comic-downloader [URL] 1-50

⁠Language Selection

Explicitly select a language:

comic-downloader [URL] 1-10 --language en

⁠Bundling Chapters

Combine chapters into a single .cbz file:

comic-downloader [URL] 1-2 --bundle

⁠Help

View all commands and options:

comic-downloader help

⁠🛠️ Troubleshooting

• "Command not recognized": Verify the binary is in a PATH-accessible location.
• macOS unsigned binary error: Run sudo spctl --master-disable.

⁠🤝 Contribution

Contributions, issues, and pull requests are welcome! See CONTRIBUTING.md⁠ for guidelines.

⁠📈 Star History

⁠