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:

| Flag | Description | Default | |---|---|---| | -d, --dest | Download directory | config or current dir | | -t, --vol-type | Volume type: vol, extra, seri, all | vol | | -f, --format | Output format: epub or mobi | epub | | -r, --retry | Retry attempts on failure | 3 | | -m, --method | Download method: 1 or 2 | 1 | | --num-workers | Concurrent download workers | 8 | | -P, --use-pool | Use credential pool with failover | off | | -p, --proxy | Proxy server address | none | | -c, --callback | Post-download callback script | none |

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

| Problem | Solution | |---|---| | Not logged in | Run kmdr login -u <username> first | | Download quota exhausted | Use --use-pool with multiple accounts, or wait for quota reset | | Network timeout | Increase --retry count, or set a proxy with -p | | Volumes not found | Check -t flag — the volume may be under extra or seri type | | Mirror unavailable | Switch mirror with kmdr config -b https://mox.moe |

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