modbender 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
kmdrcommand-line tool. Install it with:pip install kmoe-manga-downloaderRequires 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,3or1-5,8orall
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:7890to avoid repeating flags - Credential pool: For large downloads, set up multiple accounts with
kmdr pool addto avoid hitting quota limits - Volume types: Manga on Kmoe may have
vol(main volumes),extra(bonus chapters), andseri(serialized chapters) — use-t allto get everything - Callback automation: Use callbacks to trigger file organization, notifications, or syncing after each volume downloads