KToolBox

KToolBox is a useful CLI tool for downloading posts content in Kemono.party / Kemono.su

English | 中文

Features

Support for multi-thread downloads (technically, coroutine)
Retry after download failed
Ability to download individual post as well as all post by a specified creator/artist
Update downloaded creator/artist directories to the latest status
Customize the structure of downloaded post/creator directories
Search for creators/artists and posts, and export the results
Cross-platform support & iOS shortcuts available
For Coomer.su / Coomer.party support, check document Coomer for more.

Dev Plan

GUI
Add uvloop support for Unix platform

Tutorial

See documentation for more details.

Installation

Normal
```
pip3 install ktoolbox
```
For a-Shell
```
pip3 install ktoolbox-pure-py
```

Command

For more information, use the help command or goto Command page.

❓ Get general help

ktoolbox -h

❓ Get help of a command

ktoolbox download-post -h

⬇️🖼️ Download a specific post

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

If some files failed to download, you can try to execute the command line again, the downloaded files will be skipped.

⬇️🖌️ Download posts from a creator

# Download all posts of the creator/artist
ktoolbox sync-creator https://kemono.su/fanbox/user/9016

# Download latest 10 posts of the creator/artist
ktoolbox sync-creator https://kemono.su/fanbox/user/9016 --length=10

# Download latest No.11-No.15 posts of the creator/artist
ktoolbox sync-creator https://kemono.su/fanbox/user/9016 --offset=10 --length=5

# Download posts from the creator/artist from 2024-1-1 to 2024-3-1
ktoolbox sync-creator https://kemono.su/fanbox/user/9016 --start-time=2024-1-1 --end-time=2024-3-1

iOS Shortcuts

Goto Shortcuts for iOS page for more details.

Configuration

Download 10 files at the same time
Rename attachments in numerical order
Prefix the post directory name with its release/publish date
...

Goto Configuration-Guide page for more details.

Other Branches

Pure Python branch: 🔗pure-py
- Use pydantic v1 so that cargo is not needed for installation
- For example, you can use it on iOS terminal App a-Shell
- 🔗PyPI
Development branch: 🔗devel

About Kemono

Description from https://kemono.su :

Kemono is a public archiver for:

Patreon

Pixiv Fanbox

Discord

Fantia

Afdian

Boosty

DLsite

Gumroad

SubscribeStar

Contributors here upload content and share it here for easy searching and organization.
To get started viewing content, either search for creators on the artists page, or search for content on the posts page.

Code Coverage

License

KToolBox is licensed under BSD 3-Clause.

tanuki33 / ktoolbox Goto Github PK

ktoolbox's Introduction