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: bash 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