Skip to main content

A useful tool for Kemono.party

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

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.dev0.tar.gz (31.8 kB view hashes)

Uploaded Source

Built Distribution

ktoolbox-0.1.0.dev0-py3-none-any.whl (39.5 kB view hashes)

Uploaded Python 3

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