## File: README.md [](https://github.com/jiangtian616/JHenTai/releases) [](https://github.com/jiangtian616/JHenTai/releases) [](https://github.com/jiangtian616/JHenTai/issues/new) [-brightgreen)](https://t.me/+PindoE9yvIpmOWI9) # JHenTai English | [简体中文](https://github.com/jiangtian616/JHenTai/blob/master/README_cn.md) | [한국어](https://github.com/jiangtian616/JHenTai/blob/master/README_kr.md) [Q&A](https://github.com/jiangtian616/JHenTai/wiki/Common-Questions) ## 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 [](https://github.com/jiangtian616/JHenTai/releases) [](https://apps.obtainium.imranr.dev/redirect?r=obtainium://app/%7B%22id%22%3A%22top.jtmonster.jhentai%22%2C%22url%22%3A%22https%3A%2F%2Fgithub.com%2Fjiangtian616%2FJHenTai%22%2C%22author%22%3A%22jiangtian616%22%2C%22name%22%3A%22JHenTai%22%2C%22preferredApkIndex%22%3A0%2C%22additionalSettings%22%3A%22%7B%5C%22includePrereleases%5C%22%3Afalse%2C%5C%22fallbackToOlderReleases%5C%22%3Atrue%2C%5C%22filterReleaseTitlesByRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22filterReleaseNotesByRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22verifyLatestTag%5C%22%3Afalse%2C%5C%22sortMethodChoice%5C%22%3A%5C%22date%5C%22%2C%5C%22useLatestAssetDateAsReleaseDate%5C%22%3Afalse%2C%5C%22releaseTitleAsVersion%5C%22%3Afalse%2C%5C%22trackOnly%5C%22%3Afalse%2C%5C%22versionExtractionRegEx%5C%22%3A%5C%22v(.*)%5C%22%2C%5C%22matchGroupToUse%5C%22%3A%5C%22%241%5C%22%2C%5C%22versionDetection%5C%22%3Atrue%2C%5C%22releaseDateAsVersion%5C%22%3Afalse%2C%5C%22useVersionCodeAsOSVersion%5C%22%3Afalse%2C%5C%22apkFilterRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22invertAPKFilter%5C%22%3Afalse%2C%5C%22autoApkFilterByArch%5C%22%3Atrue%2C%5C%22appName%5C%22%3A%5C%22JHenTai%5C%22%2C%5C%22appAuthor%5C%22%3A%5C%22JTMonster%5C%22%2C%5C%22shizukuPretendToBeGooglePlay%5C%22%3Afalse%2C%5C%22allowInsecure%5C%22%3Afalse%2C%5C%22exemptFromBackgroundUpdates%5C%22%3Afalse%2C%5C%22skipUpdateNotifications%5C%22%3Afalse%2C%5C%22about%5C%22%3A%5C%22https%3A%2F%2Fgithub.com%2Fjiangtian616%2FJHenTai%2Fblob%2Fmaster%2FREADME.md%5C%22%2C%5C%22refreshBeforeDownload%5C%22%3Afalse%7D%22%2C%22overrideSource%22%3Anull%7D) [](https://intradeus.github.io/http-protocol-redirector?r=altstore://source?url=https://raw.githubusercontent.com/jiangtian616/JHenTai/refs/heads/master/altsource/AltSource.json) [](https://intradeus.github.io/http-protocol-redirector?r=sidestore://source?url=https://raw.githubusercontent.com/jiangtian616/JHenTai/refs/heads/master/altsource/AltSource.json) [](https://intradeus.github.io/http-protocol-redirector?r=feather://source/https://raw.githubusercontent.com/jiangtian616/JHenTai/refs/heads/master/altsource/AltSource.json) 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](https://altstore.io) or SideLoadly to sign. - You can get easier installation and updates by adding [AltStore Repo](https://intradeus.github.io/http-protocol-redirector?r=altstore://source?url=https://raw.githubusercontent.com/jiangtian616/JHenTai/refs/heads/master/altsource/AltSource.json) 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: ```bash 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](https://altstore.io) 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](https://github.com/jiangtian616/JHenTai#Translation) ## 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](https://github.com/honjow/FEhViewer) : Mainly - [EHPanda](https://github.com/tatsuz0u/EhPanda) - [EHViewer](https://gitlab.com/NekoInverter/EhViewer) Tag translation: - [EhTagTranslation](https://github.com/EhTagTranslation/Database) Tag order optimization: - [e-hentai-db](https://github.com/ccloli/e-hentai-db) - [e-hentai-tag-count](https://github.com/mokurin000/e-hentai-tag-count) - [EhSyringe](https://github.com/EhTagTranslation/EhSyringe) App translation: - [andyching168](https://github.com/andyching168) [kenny03211](https://github.com/kenny03211) [NeKoOuO](https://github.com/NeKoOuO) 繁體中文(台灣) - [lucas-04](https://github.com/lucas-04) Português brasileiro - [qlife1146](https://github.com/qlife1146) 한국어 - [bropines](https://github.com/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 - [x] Mobile, tablet, desktop layout(3 kinds) - [x] Vertical, horizontal, double column read page layout(4 kinds) - [x] GalleryPage, Popular, Favorite, Watched, History, support multiple gallery list style - [x] search, search suggestion, tap tag to search, file search, jump to a certain page - [x] online reading and download, support restore download task, support synchronize updates after the uploader has uploaded a new version - [x] archive download and automatic unpacking and reading - [x] support loading local images and read - [x] support assign priority to download task manually - [x] support assign group to gallery and archive - [x] favorite, rating, torrent, archive, statistics, share - [x] password login, Cookie login, web login - [x] support EX site(domain fronting optional) - [x] vote for Tag, watch and hidden tags - [x] comment, vote for comment - [x] Fingerprint unlock ## Translation > [languageCode](https://github.com/unicode-org/cldr/blob/master/common/validity/language.xml) > > [countryCode](https://github.com/unicode-org/cldr/blob/master/common/validity/region.xml) 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: 4. Enter `/lib/src/l18n/locale_text.dart ` , add a new k-v pair in method `keys` => `{your_languageCode}_{your_countryCode} : {your_className}.keys()` 5. 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. ## Main Dart Dependencies - [get](https://pub.flutter-io.cn/packages/get): dependency management, state management, l18n, NoSQL - [dio](https://pub.flutter-io.cn/packages?q=dio): network - [extendedImage](https://pub.flutter-io.cn/packages/extended_image): image - [drift](https://pub.flutter-io.cn/packages/drift): database --- ## File: ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md # Launch Screen Assets You can customize the launch screen with your own desired assets by replacing the image files in this directory. You can also do it by opening your Flutter project's Xcode project with `open ios/Runner.xcworkspace`, selecting `Runner/Assets.xcassets` in the Project Navigator and dropping in the desired images. --- ## File: lib/src/setting/README.md the user configs some are stored in local, loaded every time launching app can be changed by user these settings may be used by other Logic class, but because there's no logic in these classes, so I use [obx] and [Rxn] rather than [GetController] and [GetBuilder]