kumono 0.45.5

Media ripper for coomer.su and kemono.su
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139

<h2>kumono - Media ripper for <a href="https://coomer.su">coomer.su</a> and <a href="https://kemono.su">kemono.su</a></h2>

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)
  - [Available Options](#available-options)
  - [Target Selection](#target-selection)
  - [Extension Selection](#extension-selection)
  - [Download Archive](#download-archive)
- [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

<img src="kumono.gif">

### Available 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)
  -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

```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

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

### Extension Selection

```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
```

### 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.

## 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.

<!-- link definitions -->

[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