Skip to main content

A useful CLI tool for downloading posts in Kemono.su / .party (Pure Python version)

Project description

logo

KToolBox

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

Version PyPI Downloads GitHub Release Downloads BSD 3-Clause Last Commit codecov Documentation Status Platform Win | Linux | macOS

English | 中文

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.

KToolBox Configuration Editor KToolBox Configuration Editor

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_pure_py-0.11.0.tar.gz (25.8 kB view details)

Uploaded Source

Built Distribution

ktoolbox_pure_py-0.11.0-py3-none-any.whl (34.3 kB view details)

Uploaded Python 3

File details

Details for the file ktoolbox_pure_py-0.11.0.tar.gz.

File metadata

  • Download URL: ktoolbox_pure_py-0.11.0.tar.gz
  • Upload date:
  • Size: 25.8 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

Hashes for ktoolbox_pure_py-0.11.0.tar.gz
Algorithm Hash digest
SHA256 21cecdbbba3015e87faa4b9e3d0c100c3dcf3459f0d5978a445b43157f06ef5a
MD5 3eb607e6cd1c93dc59865de1acddec73
BLAKE2b-256 33338fcef457d275e6279dbf0f5594f3b102893cc0d4bf259194bc47f0cddb8e

See more details on using hashes here.

File details

Details for the file ktoolbox_pure_py-0.11.0-py3-none-any.whl.

File metadata

  • Download URL: ktoolbox_pure_py-0.11.0-py3-none-any.whl
  • Upload date:
  • Size: 34.3 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

Hashes for ktoolbox_pure_py-0.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c6d55cb2d7ea0c1150ea6e1ffe469c320facb2deffc02032305f61f8595d9d85
MD5 585b130e370d778601930a0da439959e
BLAKE2b-256 3a2e6492aaf4ab1226eff30b980c5250f345450825bba4d17ac79e3f58d918f9

See more details on using hashes here.

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