Kmoe Manga Download
by @inphinitiz
Download manga from Kmoe (kxx.moe / mox.moe) with concurrent downloads, credential management, and automation callbacks.
clawhub install kmoe-manga-downloadπ About This Skill
name: kmoe-manga-download description: Download manga from Kmoe (kxx.moe / mox.moe) with concurrent downloads, credential management, and automation callbacks. metadata: openclaw: emoji: "\U0001F4DA" requires: bins: - kmdr install: - id: pip-kmdr kind: pip package: kmoe-manga-downloader bins: - kmdr label: "Install kmoe-manga-downloader via pip (requires Python >= 3.9)"
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:
Quick Start
# 1. Log in to Kmoe
kmdr login -u -p 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 [-p ]Check account status and download quota
kmdr status
Download
kmdr download -l -v [options]
Required flags:
-l, --book-url β Manga homepage URL on Kmoe-v, --volume β Volume selection: 1,2,3 or 1-5,8 or allCommon 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=~/mangaList current config
kmdr config -lClear all config
kmdr config -c allSwitch 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 [-o ] [-n "note"]List pool accounts (with optional quota refresh)
kmdr pool list [-r] [--num-workers 3]Switch active account
kmdr pool use Update account info
kmdr pool update [-n "note"] [-o ]Remove account from pool
kmdr pool remove
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 namekmdr 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 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
kmdr config --set dest=~/manga proxy=http://localhost:7890 to avoid repeating flagskmdr pool add to avoid hitting quota limitsvol (main volumes), extra (bonus chapters), and seri (serialized chapters) β use -t all to get everythingπ‘ 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 namekmdr 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
βοΈ Configuration
# Set default options
kmdr config --set proxy=http://localhost:7890 dest=~/mangaList current config
kmdr config -lClear all config
kmdr config -c allSwitch 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 [-o ] [-n "note"]List pool accounts (with optional quota refresh)
kmdr pool list [-r] [--num-workers 3]Switch active account
kmdr pool use Update account info
kmdr pool update [-n "note"] [-o ]Remove account from pool
kmdr pool remove
π Tips & Best Practices
kmdr config --set dest=~/manga proxy=http://localhost:7890 to avoid repeating flagskmdr pool add to avoid hitting quota limitsvol (main volumes), extra (bonus chapters), and seri (serialized chapters) β use -t all to get everything