https://github.com/ljzd-pro/ktoolbox
Downloader for Kemono.su / .party with High Customizability | 高度可自定义性的 Kemono 下载器
https://github.com/ljzd-pro/ktoolbox
a-shell cli-app coomer coomer-party downloader fanbox fantia gallery ios ios-shortcut ios-shortcuts kemono kemono-downloader kemono-party os-independent patreon pixiv-fanbox python shortcut
Last synced: 24 days ago
JSON representation
Downloader for Kemono.su / .party with High Customizability | 高度可自定义性的 Kemono 下载器
- Host: GitHub
- URL: https://github.com/ljzd-pro/ktoolbox
- Owner: Ljzd-PRO
- License: bsd-3-clause
- Created: 2023-11-06T15:24:12.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-05-12T21:06:49.000Z (27 days ago)
- Last Synced: 2025-05-14T10:39:38.648Z (26 days ago)
- Topics: a-shell, cli-app, coomer, coomer-party, downloader, fanbox, fantia, gallery, ios, ios-shortcut, ios-shortcuts, kemono, kemono-downloader, kemono-party, os-independent, patreon, pixiv-fanbox, python, shortcut
- Language: Python
- Homepage: https://ktoolbox.readthedocs.io
- Size: 4.39 MB
- Stars: 373
- Watchers: 4
- Forks: 14
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
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](https://ktoolbox.readthedocs.io/latest/coomer/)
## Dev Plan
- [ ] GUI
- [ ] Discord support
## Tutorial
See [documentation](https://ktoolbox.readthedocs.io/) for more details.
### Installation
You can use executables from [releases](https://github.com/Ljzd-PRO/KToolBox/releases) page
Manually install:
- Recommend
```bash
pip3 install pipx
pipx install ktoolbox
```
- For [a-Shell](https://github.com/holzschu/a-shell)
```bash
pip3 install ktoolbox-pure-py
```
### Command
For more information, use the help command or goto [Command](https://ktoolbox.readthedocs.io/latest/commands/guide) page.
#### ❓ Get general help
```bash
ktoolbox -h
```
#### ❓ Get help of a command
```bash
ktoolbox download-post -h
```
#### ⬇️🖼️ Download a specific post
```bash
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
```bash
# 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](https://ktoolbox.readthedocs.io/latest/shortcut/) 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](https://ktoolbox.readthedocs.io/latest/configuration/guide/) page for more details.
## Other Branches
- Pure Python branch: [🔗pure-py](https://github.com/Ljzd-PRO/KToolBox/tree/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](https://github.com/holzschu/a-shell)
- 🔗[PyPI](https://pypi.org/project/ktoolbox-pure-py/)
- Development branch: [🔗devel](https://github.com/Ljzd-PRO/KToolBox/tree/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.
Copyright © 2023 by Ljzd-PRO.