Skip to content

A command line program to download Hentai videos and images from multiple websites

License

Notifications You must be signed in to change notification settings

gan-of-culture/get-sauce

Repository files navigation

get-sauce

Build Go Report Card

Is a command line program to download Hentai videos and images from multiple websites. Most sites have very intrusive advertisements, disable downloading of content, limit download speeds or only provide lesser video resolutions, but this tool will always give you the opportunity to download the best available quality from each site. It's also possible to input URLs to a category or multiple URLs and get-sauce will download it all.

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.6 MB
     # download with: get-sauce -s 0 ...


     [1]  -------------------
     Type:            video
     Info:            Mirror 1
     Quality:         842x480
     Parts:           562
     Size:            ~ 123.8 MB
     # download with: get-sauce -s 1 ...


     [2]  -------------------
     Type:            video
     Info:            Mirror 1
     Quality:         640x360
     Parts:           562
     Size:            ~ 120.7 MB
     # download with: get-sauce -s 2 ...


     [3]  -------------------
     Type:            video
     Info:            Mirror 2
     Quality:         unknown
     Size:            186.3 MB
     # download with: get-sauce -s 3 ...


     [4]  -------------------
     Type:            video
     Info:            Mirror 3
     Quality:         unknown
     Size:            186.3 MB
     # 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 B
     # 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 B
     # 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:            75.6 MB
     # 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...

------------------------------------------------------------------------------------------------

 -h             UserHeaders for the http requests. To bypass Cloudflare or DDOS-GUARD protection

 get-sauce -h "cf_clearance=..." 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...

------------------------------------------------------------------------------------------------

 -T             Set a custom timeout (in minutes) for the http.client

 get-sauce -T 15 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!

Site Images Videos Requirements
9hentai.to/ru ✔️ ?
animeidhentai.com (1080p, 720p, 480p, 360p) ? ✔️
booruproject (ex. rule34, gelbooru) ✔️ ✔️
booru.io ✔️ ?
comicporn.xxx ✔️ ?
danbooru.donmai.us ✔️ ?
doujin.sexy ✔️ ?
e-hentai.org ✔️ ?
haho.moe (1080p, 720p, 480p, 360p) ? ✔️
hanime.tv (720p, 480p, 360p) ? ✔️
hentai.tv (1080p, 720p, 480p, 360p) ? ✔️
hentai-moon.com (720p, 480p) ? ✔️
hentai2read.com ✔️ ?
hentai2w.com(720p, 480p, 360p) ? ✔️
hentaicloud.com(720p) ✔️
hentaidude.com(720p, 480, 360p) ? ✔️
hentaiera.com ✔️ ?
hentaienvy.com ✔️ ?
www.hentai-foundry.com ✔️ ?
hentaifox.com ✔️ ?
hentaihaven.co (1080p, 720p, 480p, 360p) ? ✔️
hentaihaven.com (1080p, 720p, 480p, 360p) ? ✔️
hentaihaven.red (1080p, 720p, 480p, 360p) ? ✔️
hentaihaven.xxx (1080p, 720p, 480p, 360p) ? ✔️
hentaimama.io(1080p, 720p) ? ✔️
hentaipulse.com(720p, 420p) ? ✔️
hentairox.com ✔️ ?
hentaistream.moe (2160p, 1080p, 480p) ? ✔️
hentaivideos.net (1080p, 720p, 480p, 360p) ? ✔️
hentaiworld.tv (1080p, 720p, 480p) ? ✔️
hentaiyes.com (1080p, 720p, 480p, 360p) ? ✔️
hentaizap.com ✔️ ?
hitomi.la ✔️ ?
imhentai.com ✔️ ?
iwara.tv ✔️ ✔️
koharu.to ✔️ ?
konachan.com ✔️ ?
latesthentai.com (1080p, 720p, 480p, 360p) ? ✔️
miohentai.com (1080p, 720p, 480p) ✔️ ?
nhentai.net ✔️ ? 🍪
ohentai.org (1080p, 720p, 480p) ? ✔️
oppai.stream (2160p, 1080p, 720p) ? ✔️
rule34.paheal.net ✔️ ✔️
rule34video.com (2160p, 1080p, 720p, 480p, 360p) ✔️ ✔️
simply-hentai.com ✔️ ?
thehentaiworld.com ✔️ ✔️
uncensoredhentai.xxx (1080p, 720p, 480p, 360p) ? ✔️
yandere.re ✔️ ?

You can still try to use the universal downloader, if your site is not listed.

Site requirements

🍪 --> you need to supply cookies for this extractor to work. Most likely it is used to bypass some kind of Cloudflare or DDOS-Guard protection

Note: separate the different header values using a newline

get-sauce -h "cookie: cf_clearance=k2TGEnkzhz_PtHs09vMryROlD4O3UZhrDFrU4svgjdM-1665105987-0-150; csrftoken=bLiwSENr0mqSZZ27wan1xdjLazVFoXnnABJu7DtrhbNRUacpbEZhV0Eggc5lD8m5
user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.0.0 Safari/537.36" http...

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