Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Xwilarg/NHentaiDownloader

A browser extension to download doujinshi from NHentai
https://github.com/Xwilarg/NHentaiDownloader

chrome-extension doujinshi downloader firefox-addon hentai nhentai nhentai-downloader

Last synced: 3 months ago
JSON representation

A browser extension to download doujinshi from NHentai

Awesome Lists containing this project

README

        

# NHentaiDownloader
An extension to download doujinshi from NHentai

NHentai only allow to download doujinshi in .torrent format so I created this extension allowing to download them either in ZIP, CBZ or raw format.

You can either go on a doujinshi page to download it, or go to a page containing many of them to download them all at once.


[![CI](https://github.com/Xwilarg/NHentaiDownloader/workflows/CI/badge.svg)](https://github.com/Xwilarg/NHentaiDownloader/actions)

## 403 errors

403 errors are related to the fact that NHentai added Cloudflare over their API, which basically is a tool that stop traffic that seems to come from bots or scripts (which is the case for this extension) \
There is not much I can do for that, it indeed probably mean that bulk download will fail at random moments, or that any download may fail at any time

My advices on that:
- Try to download again while being logged-in
- Try to download again using a VPN

## How to install the extension from Release page

### Chrome
- Get the latest version of the extension on the [release page](https://github.com/Xwilarg/NHentaiDownloader/releases) **You only need NHentaiDownloader.zip**, unzip it somewhere in your computer
- Write `chrome://extensions/` in your address bar
- Enable the developer mode (top right corner of the page)
- Press the `Load Unpacked` button (top left corner of the page)
- Go inside the folder of the extension and press `Select a folder`

### Firefox
- Get the latest version of the extension on the [release page](https://github.com/Xwilarg/NHentaiDownloader/releases) **You only need NHentaiDownloader.xpi**
- Write `about:addons` in your address bar
- Click on the small gear at the top right and select `Install Add-on From File...`
- Select NHentaiDownloader.xpi

## A quick note about the Chrome store

This extension was removed the 04/12/2020 from the Chrome Store because it doesn't comply with terms of service (since it contains mature content)

While there is nothing I can do against that, I still want to thanks you for using it, over 2 years it got a note of 4.3/5 and 12 858 users.

![Chrome](Preview/Chrome.png)

## Build locally
```
npm install
npm run build
```

### Start unit tests
```
npm test
```

## Single download

![Overview](Preview/Overview.png)

![Folder](Preview/Folder.png)

## Download many doujinshi at a time

![Overview](Preview/Overview-many.png)

![Folder](Preview/Folder-many.png)

## Download many pages at a time

![Overview](Preview/Overview-pages.png)

![Folder](Preview/Folder-pages.png)