Skip to main content

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

Project description

KToolBox

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

Version GPLv3 Last Commit codecov 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

For more information, use the help command.

Warning This project is still in development.

Warning The return text here are only demo, some of them may be outdated.

  • Install KToolBox:

    pip3 install ktoolbox
    
  • Get general help:

    python -m ktoolbox -h
    
    Return
          
    INFO: Showing help with the command '__main__.py -- --help'.
    
    NAME __main__.py
    SYNOPSIS __main__.py COMMAND | -
    COMMANDS COMMAND is one of the following:
    download_post Download a specific post
    ...
    sync_creator Sync all posts from a creator
    version Show KToolBox version

    To get more information, see KToolBoxCli in ktoolbox/cli.py.

  • Get help of a command:

    python -m ktoolbox download-post -h
    
    Return
          
    NAME
        __main__.py sync-creator - Sync all posts from a creator
    
    SYNOPSIS __main__.py sync-creator <flags>
    DESCRIPTION You can update the directory anytime after download finished, such as to update after creator published new posts. * If `update_from` was provided, it should be located **inside the creator directory**.
    FLAGS -u, --url=URL Type: Optional[str] Default: None The post URL ...
  • Download a specific post:

    python -m 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:

    python -m 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:

    python -m 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.

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

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

Uploaded Source

Built Distribution

ktoolbox-0.1.0-py3-none-any.whl (39.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ktoolbox-0.1.0.tar.gz
  • Upload date:
  • Size: 32.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.0 CPython/3.10.12 Linux/6.2.0-1015-azure

File hashes

Hashes for ktoolbox-0.1.0.tar.gz
Algorithm Hash digest
SHA256 08dc9aafc3b16a1b36d1c2d5259ed7f3dabe8a9a73f335635dd0e4ef6c2ad9fb
MD5 902869de9f88603f4c07d135eec92f29
BLAKE2b-256 8bac55ac6511e10e19ee334f2b4f35176a48f3f4dd311d888e3ef0ceb66eff5d

See more details on using hashes here.

Provenance

File details

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

File metadata

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

File hashes

Hashes for ktoolbox-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 777c2f107bf4cf71e35cbafb8b204e81aaeaccf842158ed9d46f870d47f78a25
MD5 0ba5c2a95aa3735977bcc34fc5e90947
BLAKE2b-256 95ce2305de373a397a1e3c2b7edfd895d42c094b007306fe12a7dcbdd542444b

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