Lib.rs

kumono - Media ripper for coomer.su and kemono.su

For a comparison with other tools, see features.

Support is provided in the discussions section.

• Installation
  • AUR
  • Binaries
  • From Source (with cargo)
• Command Line
  • Options
  • Target Selection
  • Filtering by File Extension
• Contribution

Installation

AUR

Arch users may install one of our AUR packages.

Binaries

Pre-built binaries for Windows and Linux are available for every release.

From Source (with 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 is in your $PATH. This is usually ~/.cargo/bin.

Windows users may use the WSL.

Command Line

Options

Downloads for https://coomer.su/onlyfans/user/belledelphine will go into {output-path}/onlyfans/belledelphine

Media ripper for coomer.su and kemono.su

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-4096) [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)
  -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: 5]
      --rate-limit-backoff <RATE_LIMIT_BACKOFF>  [default: 15]
      --server-error-delay <SERVER_ERROR_DELAY>  [default: 5]
  -s, --show-config                              Print configuration before execution
  -h, --help                                     Print help
  -V, --version                                  Print version

Target Selection

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

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

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

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

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

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

Filtering by File Extension

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

jpg,m4v,mp4

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

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

Contribution

Feel free to open an issue if you have a bug to report or want to request a feature.

Please use proper code formatting when creating a pull request.