Metadata-Version: 2.4
Name: kmoe
Version: 0.2.1
Summary: Command-line manga downloader for kxx.moe / kzz.moe / koz.moe
Project-URL: Homepage, https://github.com/holdjun/kmoe
Project-URL: Repository, https://github.com/holdjun/kmoe
Project-URL: Issues, https://github.com/holdjun/kmoe/issues
Author: holdjun
License-Expression: MIT
License-File: LICENSE
Keywords: cli,comic,downloader,manga
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: anyio>=4.7
Requires-Dist: cryptography>=44.0
Requires-Dist: httpx>=0.28
Requires-Dist: platformdirs>=4.0
Requires-Dist: pydantic>=2.10
Requires-Dist: rich>=13.9
Requires-Dist: selectolax>=0.3
Requires-Dist: structlog>=24.4
Requires-Dist: tomli>=2.0; python_version < '3.11'
Requires-Dist: typer>=0.15
Description-Content-Type: text/markdown

# kmoe

[English](README_EN.md)

kxx.moe / kzz.moe / koz.moe 漫画站点的命令行下载工具。

## 功能

- 邮箱登录，Session 加密存储
- 搜索漫画，支持语言筛选
- 查看漫画详情和卷列表
- 下载漫画（MOBI / EPUB），支持并发下载
- 本地库管理：查看、扫描、更新
- 多镜像自动故障转移

## 安装

通过 Skill 安装（AI 代你操作，推荐）：

```bash
npx skills install holdjun/kmoe --skill kmoe
```

手动安装（需要 Python 3.10+）：

```bash
pip install kmoe
```

从源码安装：

```bash
git clone https://github.com/holdjun/kmoe.git
cd kmoe
pip install .
```

开发模式：

```bash
pip install uv
uv sync
```

## 使用

### 登录

```bash
kmoe login -u your@email.com
kmoe status                            # 查看登录状态和配置
```

首次登录会引导配置下载目录、默认格式等参数。

### 搜索

```bash
kmoe search "龍珠"
kmoe search "SAKAMOTO" --lang jp --page 2
```

搜索结果显示每部漫画的 **Comic ID**（`ID` 列），后续操作需要用到。

### 查看详情

```bash
kmoe info 18488
```

显示漫画元数据、每卷的 Vol ID 及文件体积。

### 下载

```bash
kmoe download 18488                    # 下载全部卷
kmoe download 18488 -V 1001,1002      # 指定 Vol ID
kmoe download 18488 -f epub            # 指定格式
```

### 本地库

```bash
kmoe library                           # 查看本地库（含下载和本地扫描来源）
kmoe scan                              # 扫描本地文件，维护 library.json
kmoe update 18488                      # 更新漫画（下载新卷）
kmoe update --all                      # 更新所有已下载漫画
```

`scan` 纯本地运行，不联网。`update` 仅作用于通过 kmoe 下载的漫画。

## 配置

配置文件位于 `~/.config/kmoe/config.toml`，登录时自动创建。

可配置项：下载目录、默认格式、首选镜像、并发数等。


## License

[MIT](LICENSE)
