https://github.com/apt37/kumono
Media ripper for coomer.su and kemono.su
https://github.com/apt37/kumono
afdian boosty candfans coomer coomer-downloader coomer-party coomer-su discord dlsite fanbox fansly fantia gumroad kemono kemono-downloader kemono-party kemono-su onlyfans patreon subscribestar
Last synced: 3 months ago
JSON representation
Media ripper for coomer.su and kemono.su
- Host: GitHub
- URL: https://github.com/apt37/kumono
- Owner: APT37
- License: mit-0
- Created: 2025-06-07T12:54:44.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2025-06-26T10:57:58.000Z (3 months ago)
- Last Synced: 2025-06-26T12:01:45.217Z (3 months ago)
- Topics: afdian, boosty, candfans, coomer, coomer-downloader, coomer-party, coomer-su, discord, dlsite, fanbox, fansly, fantia, gumroad, kemono, kemono-downloader, kemono-party, kemono-su, onlyfans, patreon, subscribestar
- Language: Rust
- Homepage:
- Size: 400 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
kumono - Media ripper for coomer.su and kemono.su
For a comparison with other tools, see [features](FEATURES.md).
Support is provided in the [discussions][discussions] section.
- [Installation](#installation)
- [AUR](#aur)
- [Binaries](#binaries)
- [From Source (with cargo)](#from-source-with-cargo)
- [Command Line](#command-line)
- [Options](#options)
- [Target Selection](#target-selection)
- [Filtering by File Extension](#filtering-by-file-extension)
- [Related Userscripts](#related-userscripts)
- [Contribution](#contribution)
## Installation
### AUR
Arch users may install one of our [AUR packages](AUR.md).
### Binaries
Pre-built binaries for Windows and Linux are available for every [release][releases].
### From Source (with cargo)
```fish
# 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 URL (scheme://host:port[/path])
-t, --threads Simultaneous downloads (1-4096) [default: 256]
-o, --output-path Base directory for downloads [default: kumono]
-l, --list-extensions List of available file extensions (per target)
-i, --include File extensions to include (comma separated)
-e, --exclude File extensions to exclude (comma separated)
-s, --show-config Print configuration before execution
--connect-timeout [default: 1]
--read-timeout [default: 5]
--rate-limit-backoff [default: 15]
--server-error-delay [default: 5]
-h, --help Print help
-V, --version Print version
```
### Target Selection
```bash
# 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
```
### Filtering by File Extension
```bash
# 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
```
## Related Userscripts
- [Kemono Browser][us1]: Adds a button at the bottom right of all kemono, coomer & nekohouse supported creator websites that redirects to the corresponding page.
- [Kemono FIX+Download][us2]: Embeds a "Download" button before each file element and starts downloading and saving it to your computer.
- [Kemer Downloader][us3]: One-click download of images (compressed download/single image download), create page data for json download, one-click open all current posts.
## 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.
[discussions]: https://github.com/APT37/kumono/discussions
[releases]: https://github.com/APT37/kumono/releases
[us1]: https://sleazyfork.org/en/scripts/483259-kemono-browser
[us2]: https://sleazyfork.org/en/scripts/519690-kemono-fix-download
[us3]: https://sleazyfork.org/en/scripts/472282-kemer-%E4%B8%8B%E8%BC%89%E5%99%A8