README
¶
get-sauce
Is a hentai scraper that is not using official APIs if they are restrictive. This also means that for some sites it might take longer to download content, because the download speed might be limited. Some sites only provide single downloads, downloads to lesser qualities or no downloads at all, but this scraper will always give you the opportunity to download the best available quality from each site. It's also possible to input links to a category and get-sauce will download all media under said category.
Installation
The following dependencies are required and must be installed separately.
Note: FFmpeg does not affect the download, only affects the final file merge.
If you don't want to build the app yourself checkout the releases page.
Otherwise you can use Golang to install or update it:
go install github.com/gan-of-culture/get-sauce@latest
Or if you got Golang already installed you can download the source code and run the program from the source code this:
go run main.go ...
Getting started
Usage:
get-sauce [OPTIONS] URL [URLs...]
Download example
get-sauce https://hentaimama.io/episodes/torokase-orgasm-animation-episode-1/
Note: wrap the URL(s) in quotation marks if it contains special characters.
get-sauce "https://..."
The -i option displays all available quality of video without downloading.
get-sauce -i https://hentaimama.io/episodes/torokase-orgasm-animation-episode-1/
Site: https://hentaimama.io/
Title: Torokase Orgasm The Animation Episode 1
Type: video
Streams: # All available qualities
[0] -------------------
Type: video
Info: Mirror 1
Quality: 1280x720
Parts: 562
Size: ~427.59 MB (427589832 Bytes)
# download with: get-sauce -s 0 ...
[1] -------------------
Type: video
Info: Mirror 1
Quality: 842x480
Parts: 562
Size: ~123.83 MB (123828832 Bytes)
# download with: get-sauce -s 1 ...
[2] -------------------
Type: video
Info: Mirror 1
Quality: 640x360
Parts: 562
Size: ~120.66 MB (120659152 Bytes)
# download with: get-sauce -s 2 ...
[3] -------------------
Type: video
Info: Mirror 2
Quality: unknown
Size: 186.26 MB (186261816 Bytes)
# download with: get-sauce -s 3 ...
[4] -------------------
Type: video
Info: Mirror 3
Quality: unknown
Size: 186.26 MB (186261816 Bytes)
# download with: get-sauce -s 4 ...
The default stream is 0 and it also offers the best available quality. If you want to download a different quality or from a mirrored server you can manually choose a stream with -s.
Multiple inputs
You can also download multiple URLs at once:
get-sauce -i https://nhentai.net/g/364616/ https://nhentai.net/g/364591/
Site: https://nhentai.net
Title: Matsuri tte Ii na
Type: image
Streams: # All available qualities
[0] -------------------
Type: image
Quality: unknown
Parts: 31
Size: 0.00 MB (0 Bytes)
# download with: get-sauce -s 0 ...
Site: https://nhentai.net
Title: ASSTROLOGIC
Type: image
Streams: # All available qualities
[0] -------------------
Type: image
Quality: unknown
Parts: 36
Size: 0.00 MB (0 Bytes)
# download with: get-sauce -s 0 ...
The URLs will be downloaded one by one.
Captions
For most of the sites the captions (CC, OC or Subtitles) are hard encoded into the video file and can't be downloaded separately. If it is not encoded into the video and a caption file was found, then you can download it using the option -c.
To see if the captions can be downloaded separately use the option -i. There will be extra information displayed if the option -c can be used.
get-sauce -i https://hentai-moon.com/videos/285/isekai-harem-monogatari-ep-1/
Site: https://hentai-moon.com
Title: Isekai Harem Monogatari - Ep.1
Type: video
Captions: # All available languages
[0] -------------------
Language: English
# download with: get-sauce -c 0 ...
Streams: # All available qualities
[0] -------------------
Type: video
Quality: unknown
Size: 78.44 MB (78441598 Bytes)
# download with: get-sauce -s 0 ...
Options
-a Amount of files (image boards only)
get-sauce -a 5000 http...
--------------------------------------------------------------------------------
-c Download caption if separate to a extra file
get-sauce -c 0 http...
--------------------------------------------------------------------------------
-i Show info for the provided URL
get-sauce -i http...
--------------------------------------------------------------------------------
-j Show extracted data as json
get-sauce -j http...
--------------------------------------------------------------------------------
-k Keep video, audio and subtitles. Don't merge using ffmpeg
get-sauce -k http...
--------------------------------------------------------------------------------
-o Output name of the file
get-sauce -o myfilename http...
--------------------------------------------------------------------------------
-O Output path of the files
get-sauce -O C://Users//User//Downloads// http...
--------------------------------------------------------------------------------
-p Enter pages like 1,2,3-4,6,7,8-9 for doujins
get-sauce -p 1,2,3-4 http...
--------------------------------------------------------------------------------
-q Quiet mode - show minimal information
get-sauce -q http...
--------------------------------------------------------------------------------
-s Select a specific stream | 0 is default and has the best quality
get-sauce -s 0 http...
--------------------------------------------------------------------------------
-t Truncate file if it already exists
get-sauce -t http...
--------------------------------------------------------------------------------
-w Number of download workers
get-sauce -w 4 http...
Supported sites
The following links will direct you to adult content. Please keep that in mind!
*you need a login for this site. You can supply it via the parameters -un and -up
You can still try to use the universal downloader, if your site is not listed.
Credit
- Thanks to lux for the great template
Donate
You won't gain extra benefits from it. Although it's very much appriciated.
XMR 4AFThbPDiig6tEZdRL4NnvDfqPETiuewDgpCJKkSs11BGCVqoydRUHkZr5cotGMx395V7c2swDxi5Xjhbztiqyod7P31szF
Licencse
Pretty sure MIT is the way to go
Documentation
¶
There is no documentation for this package.
Source Files
Directories