kumono - Media ripper for coomer and kemono

For a comparison with other tools, see features.

Support is provided in the discussions section.

• Installation
  • AUR Packages
  • Pre-built Binaries
  • Source Code
• Command Line
  • Available Options
  • Target Selection
  • Extension Selection
  • Download Archive

Installation

AUR Packages

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

Pre-built Binaries

Binaries are built for every release.

Source Code

# 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

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: 5]
      --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.st/discord/server/1196504962411282491

# single channel
kumono https://kemono.st/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.