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 MIT Last Commit codecov Documentation Status Platform Win | Linux | macOS

English | 中文

Preview

Features

  • You can download all files from a specific post from Kemono
  • Or download all post from a specific creator / artist from Kemono
  • Sync the downloaded creator / artist directory to latest,
    download the posts that recently updated or published only
  • Search creator and post, then dump the results
  • Concurrently download the files
  • Support all platform

Dev Plan

  • Add a Fluent Design style 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 all posts from a creator

ktoolbox sync-creator https://kemono.su/fanbox/user/9016

By default, you will get a creator-indices.ktoolbox file in the creator directory, you can use it to update the directory anytime.

🔄️ Update a downloaded creator directory

ktoolbox sync-creator https://kemono.su/fanbox/user/641955 --update-with=./xxx/creator-indices.ktoolbox

The creator-indices.ktoolbox file contains the information and filepath of posts inside the directory.

iOS Shortcuts

Goto Shortcuts for iOS page for more details.

Configuration

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 MIT.

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.2.3.tar.gz (21.3 kB view details)

Uploaded Source

Built Distribution

ktoolbox-0.2.3-py3-none-any.whl (29.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ktoolbox-0.2.3.tar.gz
  • Upload date:
  • Size: 21.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.10.12 Linux/6.2.0-1016-azure

File hashes

Hashes for ktoolbox-0.2.3.tar.gz
Algorithm Hash digest
SHA256 a38a0a6a0f9cfe3d442db58413338913ec9209b6e51148adf0fd0dec25dc875b
MD5 dccc9f83f217fef9ed477625fa5d4ef2
BLAKE2b-256 f5d646e4db5862f4c3a166b3355415196a53cdc13d31284d81fea81132971791

See more details on using hashes here.

Provenance

File details

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

File metadata

  • Download URL: ktoolbox-0.2.3-py3-none-any.whl
  • Upload date:
  • Size: 29.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.10.12 Linux/6.2.0-1016-azure

File hashes

Hashes for ktoolbox-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b2181b8d26045d9f6c4d324a41f419fd34b5ba6d3c6b4cbe866da62fc0c5d0ec
MD5 f1543b8c0372371f2f37176e2949c850
BLAKE2b-256 8a8da5f5f5eca811768aaff95a5cdf1b9ef77129f185263821ced52d7b79d49e

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