hdown — A simple tool to download images from your favorite doujinshi sites.
WARNING : This program can only download JPG or PNG images.
hdown [OPTIONS]
This is a small bash script. Nothing extraordinary.
hdown is a downloading tool that uses wget to download images from a doujinshi site. This tool can also download images from any website that uses a certain pattern to store their images. It does not take any arguments since it reads all the required information via the standard input with prompts. (Providing a URL is easier that way and it does not get stored in the history.)
If a site stores their images as : https://www.some-site.com/images/img001.jpg, and there are 25 images at the site, all you need to provide the program is the PATTERN, PADDING and PAGES. Some examples of sites that store images in such format would be hentai2read.com, nhentai.net and pururin.io.
PATTERN — The url till just where the number starts. In the above example, it would be https://www.some-site.com/images/img. If there is a slash before the number, you must include it in the pattern.
PADDING — The number of digits in the url of the images. In the above example it would be 3, since the index of the images is stored as 001, 002, 011 and similar. If the number of digits is not fixed, like if the numbers are 1, 2, 11 and similar, you need to provide 0.
PAGES — The number of pages to download starting from the beginning page. Without the -p, -l or -e options, the images are downloaded from page 1. So if you provide 10 for PAGES, the images will be downloaded till page 10.
You will have to download (give links to the images for) each chapter manually.
WARNING : This program will not work if the website has the cloudflare DDoS protection turned on.
This program does not support long options.
-h
Show summary of manual.
-p
Start downloading from a custom page number. The PAGE-NUMBER is also taken via the standard input. If -l or -e is provided, this will have no effect other than the name of downloaded files changing. So use this option with -l or -e if you want to start naming the files from a certain number. Note that if you give 10 for PAGE-NUMBER and then 10 for PAGES, the images will be downloaded till page 19. The last page is calculated as : PAGE-NUMBER + PAGES - 1
-n
Save the files with a custom name. The NAME is also taken via the standard input. The files will be saved as "NAME PAGE.jpg" (or png, depending on the extension). So, if you provide Test for the NAME, the first image will be saved as Test 1.jpg, the second image will be saved as Test 2.jpg and so on.
-l
Download images from luscious.net. If this option is provided, the program, instead of the usual PATTERN and PADDING, asks for the URL to the first page (the page from where you want the download to start from). So, if you want to download pages 8-10, you need to provide the URL to the 8th page and 3 for PAGES (8,9,10 — 3 pages). If you want the files named from 8 onwards as well, you need to provide the -p option.
Note that the URL is the actual URL to the page and not the URL to the image.
-e
Download images from e-hentai.org. If this option is provided, the program, instead of the usual PATTERN and PADDING, asks for the URL to the first page (the page from where you want the download to start from). So, if you want to download pages 8-10, you need to provide the URL to the 8th page and 3 for PAGES (8,9,10 — 3 pages). If you want the files named from 8 onwards as well, you need to provide the -p option.
Note that the URL is the actual URL to the page and not the URL to the image.
-f
Read the required data from a file. If this option is provided, the program simply asks for the path to the file which has data stored in the following form (FILE is also taken via standard input with prompt) :
; Comment
OPTIONS ; Another Comment
DATA
BLANK LINE
OPTIONS
DATA
The only problem would be to maintain the order of data. First, custom file name (if using -n), then custom page number (if using -p) and then everything else, i.e, the usual order in which the program requests the data. So a perfect example of FILE would be :
; Comment
-np
Test
10
https://www.some-site.com/images/img
4
11
https://www.some-other-site.com/img
3
20
-e
https://e-hentai.org/proceeding-long-url
20
-
This would run the program first for :
NAME =Test
PAGE-NUMBER =10
PATTERN =https://www.some-site.com/images/img
PADDING =4
PAGES =11 -
Then after completion of first download, the program would run with :
PATTERN =https://www.some-other-site.com/img
PADDING =3
PAGES =20 -
Then after completion of second download, the program would run with option -e, with :
URL =https://e-hentai.org/proceeding-long-url
PAGES =20.
So, you can simply give data without any options like usual, even from a file. The data for -l and -e can also be given in the usual way. This makes downloading multiple chapters easier.
The images from first data-set will be saved in a directory named as RUN-1, the images from second data-set in a directory named as RUN-2 and so on.
But make sure you add the - before the options even in the file.
Anything after a semi-colon will be ignored.
WARNING : -l and -e cannot be used together. The first one provided will be considered.
The various options can be combined, except for -l and -e together.
EXAMPLE 1
Suppose you want to download 25 images starting from https://www.some-site.com/123456/img0003.jpg (this would mean downloading pages 3-27) and you want the files named as Test.
You invoke hdown as :
$ hdown -np
Now you will be asked to (due to the -n option provided) :
Enter custom file name :
Here, enter the NAME with which you want to save files (explained in the -n option section). Test for this example.
Now you will be asked to (due to the -p option provided) :
Enter page no. to start from :
Here, enter the PAGE-NUMBER from which you want the download to start from (explained in the -p option section). 3 for this example.
Now you will be asked to :
Enter url pattern :
Here, enter the PATTERN as explained in the DESCRIPTION section. https://www.some-site.com/123456/img for this example.
Now you will be asked to :
Enter padding of index :
Here, enter the PADDING as explained in the DESCRIPTION section. 4 for this example.
Now you will be asked to :
Enter number of pages :
Here, enter the PAGES as explained in the DESCRIPTION section. 25 for this example.
That is it. Now the images will be downloaded to the current directory.
EXAMPLE 2
Suppose you want to download first 10 images of a particular doujinshi from luscious.net.
You invoke hdown as :
$ hdown -l
Now you will be asked to :
Enter url to the beginning page :
Here, enter the URL with which you want to save files (explained in the -l option section).
Now you will be asked to :
Enter number of pages :
Here, enter the PAGES as explained in the DESCRIPTION section. 10 for this example.
That is it. Now the images will be downloaded to the current directory.
To install, clone or download this repository and run the following command from the directory :
$ sudo ./install
If you want to uninstall, use :
$ sudo ./uninstall
- The program still creates empty files even if the download failed (this is a problem in wget actually).
- The program gets stuck if the server does not respond. This is often encountered when downloading from
e-hentai.org.
This is a small list of sites that hdown can download images from :
| SITE | SUPPORT |
|---|---|
| nhentai.net | pattern-wise download |
| hentai2read.com | pattern-wise download |
| pururin.io | pattern-wise download |
| hentaihere.com | pattern-wise download |
| luscious.net | option support |
| e-hentai.org | option support |
Suppose you want to download all of a doujinshi from hentai2read.com
- Right-click on the image of the first page and click
View Image - Copy the url to just before where the index starts.
- Invoke hdown as :
hdown - Give the copied url when asked for
Enter url pattern : - Give the padding of index when asked for
Enter padding of index : - Give the number of pages when asked for
Enter number of pages : - Wait for the download to complete and enjoy.
- wget
- coreutils