README_zh-CN.md

KToolBox

KToolBox 是一个用于下载 Kemono.su / Kemono.party 中作品内容的实用命令行工具

English | 中文

功能

• 支持并发下载
• API 调用和下载失败后 自动重试
• 支持下载单个作品以及指定的画师的 所有作品
• 可 更新已下载 的画师目录至最新状态
• 支持自定义下载的作品/画师 文件和目录名格式、目录结构
• 支持排除 指定格式 的文件或仅下载指定格式的文件
• 可搜索画师和作品，并导出结果
• 支持全平台，并提供 iOS 快捷指令
• 对于 Coomer.su / Coomer.party 的支持，请查看文档 Coomer

开发计划

• GUI
• Discord 下载支持

使用方法

前往 文档 查看更多详情。

安装

你可以从 releases 页面下载可执行文件使用

手动安装：

• 推荐

  pip3 install pipx
  pipx install ktoolbox

• 对于 iOS a-Shell

  pip3 install ktoolbox-pure-py

命令

使用帮助命令或前往 命令 页面查看更多帮助。

❓ 获取帮助总览

ktoolbox -h

❓ 获取某个命令的帮助信息

ktoolbox download-post -h

⬇️🖼️ 下载指定的作品

ktoolbox download-post https://kemono.su/fanbox/user/49494721/post/6608808

如果部分文件下载失败，你可以尝试重新运行命令，已下载完成的文件会被 跳过。

⬇️🖌️ 下载作者的所有作品

# 下载作者/画师的所有作品
ktoolbox sync-creator https://kemono.su/fanbox/user/9016

# 下载作者/画师最新的 10 个作品
ktoolbox sync-creator https://kemono.su/fanbox/user/9016 --length=10

# 下载作者/画师最新的第 11 至 15 个作品
ktoolbox sync-creator https://kemono.su/fanbox/user/9016 --offset=10 --length=5

# 下载作者/画师从 2024-1-1 到 2024-3-1 的作品
ktoolbox sync-creator https://kemono.su/fanbox/user/9016 --start-time=2024-1-1 --end-time=2024-3-1

iOS 快捷指令

前往 iOS 快捷指令 页面查看更多详情。

配置

• 同时下载10个文件
• 按照数字顺序重命名附件, 例如 1.png, 2.png, ...
• 将发布日期作为作品目录名的开头，例如 [2024-1-1]HelloWorld
• ...

前往 配置-向导 页面查看更多详情。

其他分支

• 纯 Python 分支：🔗pure-py
  • 使用 pydantic v1 因此安装时不需要 cargo
  • 例如你可以在 iOS 的终端 App a-Shell 运行
  • 🔗PyPI
• 开发版分支：🔗devel

代码覆盖率

许可证

KToolBox 使用 BSD 3-Clause 许可证.

Copyright © 2023 by Ljzd-PRO.