kumono

kumono - Media ripper for coomer and kemono

For a comparison with other tools, see features.

Support is provided in the discussions section.

• Installation
  • Binaries
  • Packages
  • Cargo
• Command Line
  • Available Options
  • Target Selection
  • Extension Selection
  • Download Archive
  • Favorite Download
• Legal Disclaimer

Installation

Binaries

Check here for information on how to install a binary on your platform.

Packages

You may use 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 install stable --profile minimal

# 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, possibly via MobaXterm.

Command Line

CLI output is subject to change, so the below animation might not always be up to date.

Results may vary based on the hardware used.

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). Downloads are automatically resumed.

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]
  -f, --input-file <INPUT_FILES>   File with URLs, can be used multiple times
  -o, --output-path <OUTPUT_PATH>  Base directory for downloads [default: kumono]
  -d, --download-archive           Log hashes, skip moved/deleted file downloads
  -s, --show-config                Print configuration values
  -h, --help                       Print help
  -V, --version                    Print version

Filtering:
  -l, --list-extensions    List available file extensions (per URL)
  -i, --include <INCLUDE>  File extensions to include (comma separated)
  -e, --exclude <EXCLUDE>  File extensions to exclude (comma separated)

Connection:
  -m, --max-retries <MAX_RETRIES>                [default: 4]
  -r, --retry-delay <RETRY_DELAY>                [default: 1]
      --connect-timeout <CONNECT_TIMEOUT>        [default: 5]
      --read-timeout <READ_TIMEOUT>              [default: 180]
      --rate-limit-backoff <RATE_LIMIT_BACKOFF>  [default: 15]
      --server-error-delay <SERVER_ERROR_DELAY>  [default: 5]

Login:
  -C, --coomer-user <COOMER_USER>  
  -c, --coomer-pass <COOMER_PASS>  
  -K, --kemono-user <KEMONO_USER>  
  -k, --kemono-pass <KEMONO_PASS>

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

# from file(s)
kumono -f targets1.txt -f targets2.txt -f targets3.txt

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.

Favorite Download

Favorites will be downloaded automatically when you provide credentials via the login options.

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.