JHenTai

English | 简体中文 | 한국어

Q&A

Description

A manga app for E-Hentai, supporting Android & iOS & Windows & MacOS & Linux.

Still in development stage, welcome to submit issues or feature requests.

Download & Install

Install for Android: download .apk according to your device architecture and install.

• arm64-v8a：Suitable for Android phones with 8th generation ARM processor(common choice)
• armeabiv-v7a：Suitable for Android phones with 7th generation ARM processor
• x86_64：rare

Install for iOS: download .ipa, then use AltStore or SideLoadly to sign.

• You can get easier installation and updates by adding AltStore Repo

Install for Windows: download Windows_xxx.zip, then unpack it.

• If you use a proxy server, set proxy address at network setting page.
• If you're using Windows 11 and can't launch app, try to run jhentai.exe in compatibility mode.
• If it's blocked by Windows Defender, Please trust it.

Install for MacOS(No maintenance): download .dmg.

• Trust it in system setting.
• If you use a proxy server, set proxy address at network setting page.

Install for Linux(No maintenance): download Linux-amd64.deb or Linux-x86_64.AppImage due to your platform, then install or execute it (You may need to install webkit2gtk-4.1).

Fedora-based dnf linux distro:

sudo rpm --import https://meeks233.github.io/Jhentai-rpm/fedora/RPM-GPG-KEY-jhentai
sudo curl -fsSL -o /etc/yum.repos.d/jhentai.repo https://meeks233.github.io/Jhentai-rpm/fedora/jhentai.repo
sudo dnf install -y jhentai

• If you use a proxy server, set proxy address at network setting page.

Update

Update for Android: download .apk according to your device architecture and install.

Update for iOS: download .ipa, then use AltStore or SideLoadly to sign.

Update for Windows: Delete old unpacked directory directly, then download latest Windows_xxx.zip, unpack it.

Update for MacOS(No maintenance): download .dmg.

Update for Linux(No maintenance): Delete old and download the latest product.

Help With Translation

Please submit a PR if you want to help with translation.

steps

Develop Motivation

My first project With Flutter. I aim at getting familiar with Flutter during development. Devices I use include Android phone, Ipad and Windows computer. E-hentai apps I used before have several bugs, and I don't understand source code because I have no development experience with Android or ios, so I choose JHenTai to become my first Flutter Project.

2022.08.20 After five months of development, JHenTai has gradually become more and more strong, and I have completely refactored some codes for gallery page, reading page, download, etc. which are written at the beginning stage. I tried my best to extract the commonality between different page and style to reduce coupling, in order to benefit the development of new features. I would be very grateful if any kind of you could give me some advice on coding style, design patterns and anything related to Flutter development or participate in the development of JHenTai.

2022.10.29 I have been more familiar with basic Flutter development, and I'll focus on another area from now on. So updates for JHenTai will be less than previous, but I'll still handle bugs or issues in time。

References & Thanks

Layout and style references:

• FEhviewer : Mainly
• EHPanda
• EHViewer

Tag translation:

• EhTagTranslation

Tag order optimization:

• e-hentai-db
• e-hentai-tag-count
• EhSyringe

App translation：

• andyching168 kenny03211 NeKoOuO 繁體中文(台灣)
• lucas-04 Português brasileiro
• qlife1146 한국어
• bropines Russian

mush thanks to these projects and people🙇‍

Screenshots

Mobile Layout

Tablet Layout

Desktop Layout

Gallery & Search

Gallery Detail

Setting & Download

Read

Main Features

• Mobile, tablet, desktop layout(3 kinds)
• Vertical, horizontal, double column read page layout(4 kinds)
• GalleryPage, Popular, Favorite, Watched, History, support multiple gallery list style
• search, search suggestion, tap tag to search, file search, jump to a certain page
• online reading and download, support restore download task, support synchronize updates after the uploader has uploaded a new version
• archive download and automatic unpacking and reading
• support loading local images and read
• support assign priority to download task manually
• support assign group to gallery and archive
• favorite, rating, torrent, archive, statistics, share
• password login, Cookie login, web login
• support EX site(domain fronting optional)
• vote for Tag, watch and hidden tags
• comment, vote for comment
• Fingerprint unlock

Translation

languageCode

countryCode

1. Copy /lib/src/l18n/en_US.dart and rename to {your_languageCode}_{your_countryCode}.dart
2. Rename classname in new file(optional)
3. Modify k-v pairs in method keys ,translate values to your language

Now you can submit your PR, I'll do the remaining things. Or you can go on with:

1. Enter /lib/src/l18n/locale_text.dart , add a new k-v pair in method keys => {your_languageCode}_{your_countryCode} : {your_className}.keys()
2. Enter /lib/src/consts/locale_consts.dart, add a new k-v pair in property localeCode2Description: {your_languageCode}_{your_countryCode} : {languageDescription} to describe your language.

About compiling

1. You need to manage your Android signing by yourself, check https://docs.flutter.dev/deployment/android#signing-the-app
2. Just run this project via IDEA or VSCode simply.

About code contribution

1. There is no fixed requirement for branch names. You can make changes on your local master branch and submit a PR.
2. For changes that are large in scope or involve interactions between multiple modules, code submitted via Vibe Coding by developers without code review capability will not be accepted. Such code often fails to follow the project's existing coding conventions, is harmful to code extensibility, and its correctness cannot be guaranteed.
3. A single PR should focus on the minimal feature scope. If multiple features are involved, please submit separate PRs.

Developer Documentation

On desktop platforms(Windows/MacOS/Linux), you can pass a gallery url via command line argument, so that external software can use JHenTai as a reader and open a gallery directly:

# open a gallery on launch
JHenTai.exe -g "https://e-hentai.org/g/1234567/abcdef1234/"
JHenTai.exe --gallery="https://exhentai.org/g/1234567/abcdef1234/"

# single image page url is also supported
JHenTai.exe -g "https://e-hentai.org/s/abcdef1234/123456-0"

• -g / --gallery <url>: open the gallery (or image page) on launch, other arguments are ignored. If no valid url is provided, the app starts normally.
• If a password/biometric lock is enabled, the gallery opens after unlocking.
• On MacOS, launch the executable inside the app bundle to pass arguments, e.g. /Applications/JHenTai.app/Contents/MacOS/JHenTai -g <url> (double-clicking in Finder doesn't pass arguments).

Main Dart Dependencies

• get: dependency management, state management, l18n, NoSQL
• dio: network
• extendedImage: image
• drift: database