Kmoe Manga Downloader

Download manga from Kmoe (kxx.moe / mox.moe) as EPUB or MOBI files using the kmdr CLI.

Prerequisite: This skill requires the kmdr command-line tool. Install it with:

pip install kmoe-manga-downloader

Requires Python >= 3.9.

When to Use This Skill

Activate when the user:

• Wants to download manga from Kmoe / kxx.moe / mox.moe
• Asks to batch-download manga volumes
• Needs to manage Kmoe account credentials or credential pools
• Wants to automate post-download actions (e.g., move files, send notifications)

Quick Start

# 1. Log in to Kmoe
kmdr login -u <username> -p <password>

# 2. Download volumes 1-3 of a manga
kmdr download -l https://kxx.moe/c/50076.htm -v 1-3 -d ~/manga

Commands

Authentication

# Log in (password prompted if omitted)
kmdr login -u <username> [-p <password>]

# Check account status and download quota
kmdr status

Download

kmdr download -l <book-url> -v <volumes> [options]

Required flags:

• -l, --book-url — Manga homepage URL on Kmoe
• -v, --volume — Volume selection: 1,2,3 or 1-5,8 or all

Common options:

Configuration

# Set default options
kmdr config --set proxy=http://localhost:7890 dest=~/manga

# List current config
kmdr config -l

# Clear all config
kmdr config -c all

# Switch mirror source
kmdr config -b https://mox.moe

Credential Pool

Manage multiple accounts for failover when one account's quota is exhausted.

# Add account to pool
kmdr pool add -u <username> [-o <priority>] [-n "note"]

# List pool accounts (with optional quota refresh)
kmdr pool list [-r] [--num-workers 3]

# Switch active account
kmdr pool use <username>

# Update account info
kmdr pool update <username> [-n "note"] [-o <priority>]

# Remove account from pool
kmdr pool remove <username>

Examples

Download specific volumes

kmdr download -d ~/manga -l https://kxx.moe/c/50076.htm -v 1-5

Download all extras as MOBI

kmdr download -l https://kxx.moe/c/50076.htm -t extra -v all -f mobi

Download with callback

Post-download callbacks support template variables:

• {v.name} — Volume name
• {v.page} — Page count
• {v.size} — File size
• {b.name} — Book/manga name
• {b.author} — Author name

kmdr download -l https://kxx.moe/c/50076.htm -v 1-3 \
  --callback "echo '{b.name} - {v.name} done!' >> ~/kmdr.log"

Use credential pool for large batch

kmdr pool add -u user1 -o 1 -n "main account"
kmdr pool add -u user2 -o 2 -n "backup"
kmdr download -l https://kxx.moe/c/50076.htm -v all --use-pool

Download via proxy

kmdr download -l https://kxx.moe/c/50076.htm -v 1-10 -p http://localhost:7890

Error Handling

Tips

• Set defaults once: Use kmdr config --set dest=~/manga proxy=http://localhost:7890 to avoid repeating flags
• Credential pool: For large downloads, set up multiple accounts with kmdr pool add to avoid hitting quota limits
• Volume types: Manga on Kmoe may have vol (main volumes), extra (bonus chapters), and seri (serialized chapters) — use -t all to get everything
• Callback automation: Use callbacks to trigger file organization, notifications, or syncing after each volume downloads