kumono 0.56.3

Media ripper for coomer and kemono
kumono-0.56.3 is not a library.

[!IMPORTANT]

Since I'm currently very occupied with university, active development is on halt for the time being.

I can still make time here and there to apply small patches, for example bug fixes from pull requests - but the implementation of new features is out of my hands right now.

Hopefully you can forgive me for temporarily neglecting private projects for the purpose of pursuing education.

[!WARNING]

This is beta software. Please be aware that functionality might change or break at any time before the 1.0.0 release.

For a comparison with other tools, see features.

Support is provided in the discussions section.

Installation

Binaries

Packages

You need an AUR helper like paru to install one of these packages.

Cargo

# 1. build dependencies
sudo apt-get install git rustup

# 2. Rust toolchain
rustup default stable

# 3a. latest release (via crates.io)
cargo install kumono

# 3b. latest commit (via GitHub)
cargo install --git https://github.com/APT37/kumono

Make sure the cargo binary location (usually ~/.cargo/bin) is in your $PATH.

Windows users may use the WSL.

Command Line

Available Options

Downloads for https://coomer.st/onlyfans/user/belledelphine will go into {output-path}/onlyfans/belledelphine (the default value for {output-path} is kumono).

Media ripper for coomer and kemono

Usage: kumono [OPTIONS] [URLS]...

Arguments:
  [URLS]...  Creator page or post / Discord server or channel

Options:
  -p, --proxy <PROXY>                            Proxy URL (scheme://host:port[/path])
  -t, --threads <THREADS>                        Simultaneous downloads (1-512) [default: 256]
  -o, --output-path <OUTPUT_PATH>                Base directory for downloads [default: kumono]
  -l, --list-extensions                          List of available file extensions (per target)
  -i, --include <INCLUDE>                        File extensions to include (comma separated)
  -e, --exclude <EXCLUDE>                        File extensions to exclude (comma separated)
  -d, --download-archive                         Log hashes, skip moved/deleted file download
  -m, --max-retries <MAX_RETRIES>                [default: 5]
  -r, --retry-delay <RETRY_DELAY>                [default: 1]
      --connect-timeout <CONNECT_TIMEOUT>        [default: 1]
      --read-timeout <READ_TIMEOUT>              [default: 180]
      --rate-limit-backoff <RATE_LIMIT_BACKOFF>  [default: 15]
      --server-error-delay <SERVER_ERROR_DELAY>  [default: 5]
  -s, --show-config                              Print configuration
  -h, --help                                     Print help
  -V, --version                                  Print version

Target Selection

# whole creator + linked profiles
kumono https://coomer.st/onlyfans/user/belledelphine/links

# whole creator
kumono https://coomer.st/onlyfans/user/belledelphine

# single page
kumono https://coomer.st/onlyfans/user/belledelphine?o=50

# single post
kumono https://coomer.st/onlyfans/user/belledelphine/post/1099631527

# whole server
kumono https://kemono.cr/discord/server/1196504962411282491

# single channel
kumono https://kemono.cr/discord/server/1196504962411282491/1196521501059469463

# multiple targets
kumono https://coomer.st/onlyfans/user/belledelphine https://kemono.cr/discord/server/1196504962411282491

Extension Selection

# list available file types for a target
kumono https://coomer.st/onlyfans/user/belledelphine --list-extensions

jpg,m4v,mp4

# download only video files via inclusion
kumono https://coomer.st/onlyfans/user/belledelphine --include m4v,mp4

# download only video files via exclusion
kumono https://coomer.st/onlyfans/user/belledelphine --exclude jpg

Download Archive

When using the --download-archive option, kumono will create log files for each target in {output-path}/db to save hashes of previously downloaded files.

Using this option will also add the hashes of existing files from previous runs for the same target to the respective log file.

Legal Disclaimer

This project does not condone or support piracy in any form. We respect the intellectual property rights of creators and encourage users to access content through legal and authorized channels. The project aims to promote creativity, innovation, and the responsible use of digital resources. Any content shared or discussed within the scope of this project is intended for educational and informational purposes only. Users are urged to respect copyright laws and support creators by purchasing or accessing their work legally.