A useful CLI tool for downloading posts in Kemono.su / .party
Project description
KToolBox
KToolBox is a useful CLI tool for downloading posts content in Kemono.su / Kemono.party
Features
- Supports concurrent downloads
- Automatically retries API calls and downloads after failures
- Allows downloading individual posts or all posts of a specified artist
- Can update downloaded artist directories to the latest state
- Supports customizable file and directory naming formats and directory structures for downloaded posts/artists
- Enables excluding specified file formats or downloading only specified formats
- Allows searching for artists and posts, with options to export results
- Compatible with all platforms, with iOS shortcuts provided
- For support related to Coomer.su / Coomer.party, please refer to the documentation: Coomer
Dev Plan
- GUI
- Discord support
Tutorial
See documentation for more details.
Installation
You can use executables from releases page
Manually install:
-
Recommend
pip3 install pipx pipx 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
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.
Copyright © 2023 by Ljzd-PRO.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file ktoolbox-0.11.0.tar.gz
.
File metadata
- Download URL: ktoolbox-0.11.0.tar.gz
- Upload date:
- Size: 30.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.4 CPython/3.10.12 Linux/6.5.0-1025-azure
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | dced6e408986551cd973a936d311e0d776a1b0ee5571950d5fe92797a4b3c685 |
|
MD5 | d0a33565f5497d12868fdd49bd3382c7 |
|
BLAKE2b-256 | 59d4c0fd6f8d7cae0a887e487667b73173e7e8fc91151301cfcefe93dcd34454 |
File details
Details for the file ktoolbox-0.11.0-py3-none-any.whl
.
File metadata
- Download URL: ktoolbox-0.11.0-py3-none-any.whl
- Upload date:
- Size: 38.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.4 CPython/3.10.12 Linux/6.5.0-1025-azure
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6eba5c1df80251d74dfb226310e07c05d813859cd5d9def7891f1b2005440788 |
|
MD5 | eb35b79756fe114135947626ae608044 |
|
BLAKE2b-256 | bf857da2b684e52079939bc565386fd267c2870d43bfbdc96814f0df2f52c9cc |