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

kmoe-manga-download

Install via CLI (Recommended)