Skip to main content

A useful CLI tool for downloading posts in Kemono.party / .su

Project description

logo

KToolBox

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

Version BSD 3-Clause Last Commit codecov Documentation Status Platform Win | Linux | macOS

English | 中文

Preview

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

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

  • 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

codecov.io

License

KToolBox is licensed under BSD 3-Clause.

Copyright © 2023 by Ljzd-PRO.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ktoolbox-0.8.0.tar.gz (25.3 kB view details)

Uploaded Source

Built Distribution

ktoolbox-0.8.0-py3-none-any.whl (33.9 kB view details)

Uploaded Python 3

File details

Details for the file ktoolbox-0.8.0.tar.gz.

File metadata

  • Download URL: ktoolbox-0.8.0.tar.gz
  • Upload date:
  • Size: 25.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.12.3 Linux/6.8.0-1014-azure

File hashes

Hashes for ktoolbox-0.8.0.tar.gz
Algorithm Hash digest
SHA256 a237cc475e68a89825e905d0856c099e7553aa52d5cf20bf5f076ab0a67214c3
MD5 c2af9e8a4022207a2871f15ce5f83b77
BLAKE2b-256 224c064069ffe6ef3ba98f2a38737e5b471781ddd8f638e8fecda05035df0828

See more details on using hashes here.

Provenance

File details

Details for the file ktoolbox-0.8.0-py3-none-any.whl.

File metadata

  • Download URL: ktoolbox-0.8.0-py3-none-any.whl
  • Upload date:
  • Size: 33.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.12.3 Linux/6.8.0-1014-azure

File hashes

Hashes for ktoolbox-0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9094f8b3d24c35ce697c0a55d0a590c18181e16da83d32e74c7f02045d4f1bbd
MD5 095df1ac635076bfc1827db48201f03c
BLAKE2b-256 feada2ed0d593bc6c233e4a1895a37a3cac5920d8f2c44979f7522be30d690ea

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page