FAQ
Is there a way to complete unfinished downloads ?
Do I need a VPN to use the app ?
Will the app include a built-in VPN in the future ?
How come I can only view the first page (cover) when I click on a downloaded book ?
Why does the app fail to recognize my Hentoid folder ?
How do I transfer books from Hentoid to my computer ?
How to move my library to my SD card ?
Is there any way to reorganize/sort/rename Hentoid book folders on my computer ?
How to import ZIP / CBR files into Hentoid ?
How to import non-Hentoid downloads into Hentoid ?
Isn't there a quicker version to access books than launching the Hentoid browser ?
What is the Canary Leaks app ? Is it bad for my phone if I detect a memory leak ?
Is there any plan for a desktop version for PC/Mac ?
Is there any plan for an iOS version ?
I want to take a screenshot / video of the app but the screen remains black. How to solve it ?
The app force closes when choosing the Hentoid folder. How to solve it ?
Can you add my favourite booru source (e.g. rule34) ?
A : When a download is finished and incomplete, it appears on the library with a (!) red symbol on the bottom right corner. By clicking on that symbol and selecting "OK", you can retry downloading the images that weren't downloaded the 1st time. The book will come back in the queue with the remaining images to download.
A : You have to first access the detailed error log to see what kind of errors you're getting.
-
If you're in the queue screen, use the
(i)button that appears on the bottom right corner of the screen when getting errors while downloading -
If you're in the library screen, use the
(!)button that appears on the bottom of a book when it has undownloaded pages and select "View detailed error log"
There are 5 types of errors : Parsing, Networking, I/O, Captcha, Image processing and Undefined
-
Parsing : Hentoid has encountered content that wasn't expected. Contact the Hentoid team on Discord or Subreddit
-
Networking : Something uncool happened between the source website and your phone (e.g.
net::ERR_CONNECTION_CLOSED,Connection Timeout,HTTP 500,HTTP 503...). There's a good chance the error will disappear if you retry downloading -
I/O : There has been an issue when trying to save an image on your phone memory or SD card. Try and re-select your download location by using
Preferences > Select downloads locationand retry downloading -
Captcha (Tsumino-only) : Download has been blocked by a captcha. Open one book from Tsumino, solve the captcha and retry downloading
-
Image processing (Fakku-only) : Post-download image processing has failed. There's a good chance the error will disappear if you retry downloading
-
Unknown : Something really unexpected has happened. Contact the Hentoid team on Discord or Subreddit
A : It depends on who's your internet provider. If you can access the sites with a classic browser without any VPN on, then you don't need one for Hentoid either. If your government or ISP blocks these sites, then you need one.
A : It's definitely not on the roadmap. As of 2021, the current dev team A/ does not have enough manpower to run a VPN service in addition to maintaning the app B/ does not have the appropriate skills in IT security.
Q : Will it be possible for the app to automatically download entire lists of books from one page (e.g. Hitomi welcome page) in one single click ?
A : Unfortunately, that won't be done because :
-
Mass-downloading that will follow has a high chance of triggering a security response on the websites, which will become more difficult to parse
-
That feature requires not only to maintain compatibility with evolving gallery pages, but also with results pages. The Hentoid team doesn't have the manpower to maintain that feature over time
If you're in a hurry to download everything, you can still use quick download (long tap on a book cover -> added to queue immediately without having to visit the gallery page)
Q : How come I can only view the first page (cover) when I click on a downloaded book ? (Hentoid < v1.8 only)
A : If you check with your file manager you'll see that Hentoid is downloading all the pages. If you're using your phone's default image viewer, it only opens the first page and doesn't care about the other images in the same folder.
The solution is to use a different image viewer like Hentoid's, PerfectViewer, Quickpic or ComicScreen. You can switch to Hentoid's image viewer or Perfect Viewer using Preferences > Read Content Action (this option has been renamed Image Viewer in version 1.7)
Q : I'm using (insert image viewer name here) to read the galleries, and the images are displayed in the wrong order. What is going on ?
A : Several gallery viewers order the pictures according to the date the files are saved to your phone. Since Hentoid downloads with multiple threads, that generally means the order of download doesn't follow the actual order of the images in the gallery.
You have two options : either change your reader's settings to order the pictures according to their filenames, or use Perfect Viewer.
Q : I'm not happy with Hentoid's internal image viewer. Is it possible to add the "open with external reader" feature back ?
A : The internal image viewer has been created in response to Android's Q2 2019 new security rules. In short, one of the consequences of these rules prevent any Android app from launching a 3rd party app. Not complying with that rule makes the installation and update of the app much more difficult, and raises security warnings.
Hentoid's image viewer is not frozen and will continue to improve thanks to your feedback. You're welcome to suggest improvements at any time, using the GitHub issue form or contacting us on Discord (#suggestions channel).
If you're dead serious about bringing back the old feature, you're welcome to fork the app and develop your own flavour. The Hentoid dev team will provide information and guidance on Discord.
A : Hentoid's folder should be named Hentoid or .Hentoid. Any other name will make it undetectable by the app.
You can, however, put it in any subfolder of your choice (e.g. <SD card root>/my stuff/pics/.Hentoid)
A : The recommended steps are as follows :
Prepare the transfer
- Make sure your folders are named as you want (Preferences > Storage > Folder Names)
If they are not :
-
Select the naming convention you like with Preferences > Storage > Folder Names
-
Use Preferences > Storage > Refresh library, check Rename all folders [...] and press OK
-
Wait until the progress bar reaches 100%
Transfer your files
5a. Using an USB cable (Android 8+)
Connect your phone to your computer with an USB cable and transfer your files using your computer's file explorer.
You might have to temporarily rename the .Hentoid folder to Hentoid for the computer to be able to detect it.
ADB is also a fast and reliable solution if you're tech-savvy (see https://www.xda-developers.com/install-adb-windows-macos-linux/) - the pull command is what you're looking for
NB : If you get a failed to create file/directory or no such directory issue during transfer, that means the name of your book folders is too long. Go back to step 1 and use the "Truncate folder name" option
or
5b. Using an app (Any version of Android)
Use any file transfer app (such as AirDroid) to transfer the folders from Android to the computer.
Clean your library
If you want to delete the books from your phone :
-
Delete the folders you've just transferred
-
Use Preferences > Storage > Refresh library, uncheck Rename all folders [...] and press OK
-
Wait until the progress bar reaches 100%
Your library is now updated and doesn't list the deleted folders anymore.
A : There is no automated way to move your library to your SD card. The recommended process is as follows :
Create the target folder on the SD card
- Open Hentoid
- Use "Preferences > Select downloads folder"
- Browse to any location on your SD card*
- Select that location using the validation button of your file browser
Hentoid will then create its own folder structure there, which is as follows : .Hentoid/<source>
Manually move your library to the target folder
- Open your favourite file manager
- Go to the Hentoid folder you want to move
- Select all its subfolders
- Copy them
- Go to the newer location that you created on your SD card at step 4*
- Paste all subfolders here
Refresh Hentoid
- Open Hentoid
- Use "Preferences > Select downloads folder"
- Browse to the location that you created on your SD card at step 4*
- Select that location using the validation button of your file browser
- Hentoid should display a dialog saying that an existing library has been detected. Select OK
- Hentoid should display a progress bar and display "OPEN LOG" when import is complete
- Go back to the library screen and check if all your books are there
In case of any issue, repeat steps 11 to 16, tap the OPEN LOG button and send that log to the dev team, using the GitHub issue form or contacting us on Discord (#help channel).
* On Android 4 (Kitkat), you cannnot choose any folder on your SD card. You are restricted to a certain location that is displayed on the dialog.
To access that location, use an advanced file manager or ADB.
A : Get the unofficial Powershell organizer script and tweak it to your very needs ! Just in case, get Powershell here.
You can add doujins that haven't been downloaded with Hentoid using the external library feature.
Supported formats are ZIP, RAR, 7Z, CBZ, CBR, CB7... and plain folders with pictures files inside 😄
To add books to the external library, use Settings > Storage > External library and select a folder that contains your archives or your book folders.
Any book from the external library will appear with a specific icon on the library screen.
A : You have two other choices to reach a book in Hentoid :
1/ Use your regular browser and choose the "Open with Hentoid" option when tapping a book
2/ Reach the book directly by typing its "launch code" (unique ID) in the Hentoid search bar
A : Leaks (LeakCanary) is a companion app for beta releases that helps our development team detecting memory leaks. If you find any, you may upload it to our team, using Discord.
Having a memory leak is not dangerous for your phone at all, it just means that the app will progressively take more and more space into memory as you use features that cause leaks. At the very worst, the app will eventually crash and the memory it had taken up will become free again.
More information here : https://square.github.io/leakcanary/
A : The code of Hentoid relies on the Android framework. It means it depends entirely on your phone's operating system, and cannot run on a desktop JRE. The best chance you have to run it on a computer is to use an Android emulator such as Nox or Bluestacks.
Hentoid isn't a company and cannot hire people / open an "iOS" branch by throwing money at the idea.
As of 2021, the current team members work in their spare time, and are clearly focused on Android (very little skills in Apple SDK). Building an entire iOS app from the ground up is quite a challenge under these conditions 😅
Any seasoned iOS dev is welcome to join the team to build the iOS variant. We'll provide all the support we can to explain how the app works, including magnificient UML diagrams when needed !
Q : Does the app have trackers ? Do you sell my personal info, fetishes and organs while I'm using the app ?
A : Hentoid does not send nor store any information whatsoever outside of your phone, with the exception of Firebase and Crashlytics.
Data collected with Firebase and Crashlytics is processed for the purpose of providing a better service, exclusively for the following use cases :
-
General monitoring of app usage (number of users, adoption of newer versions, screen time of the different parts of the app, users by geographic area / type of phone / OS)
-
Monitoring of critical bugs and app stability (number of crashes per day, details of each crash within the last 90 days)
The data made available by Firebase and Crashlytics does not allow the core Hentoid dev team to identify who you are : no name, IP address, nor any type of personal identifier or device identifier are available for viewing or downloading through Firebase and Crashlytics.
Last but not least, you can opt-out at all times by unchecking the Preferences > Privacy > Analytics option.
A : Screenshots and videos are disabled by default for privacy reasons. You can enable them by checking the "App preview" option in Preferences > Privacy.
A : There may be multiple reasons for that :
1/ Your phone's manufacturer did not include any default app to handle Android's OPEN_DOCUMENT_TREE intent, which is against the Android framework guidelines.
In order to fix that, you should try to find and install the APK called DocumentsUI.apk (that contains the com.google.android.documentsui components) compatible with your version of Android.
2/ You disabled the vanilla file manager yourself. Bad news : many apps still require to use it. Please enable it again.
NB : The vanilla file manager is an app called "Files" with a blue icon. Sometimes, it only appears in the settings and not in home screen or app drawer.
3/ If you are using Samsung Secure Folder on Android 11, the vanilla file manager isn't automatically installed within Samsung's Secure Folder itself.
In order to solve that, you have to uninstall (or disable) Samsung Secure Folder first, then make sure the vanilla file manager ("Files") app is enabled, then reinstall (or enable) the Secure Folder.
TL;DR We can't with the current state of the app - we suggest using a booru reader app such as flexbooru, mbooru or booru nav.
The entire app revolves around the idea that content are books with a set number of pages that are read from page 1 to page X. Now boorus are breaking all of that and feature a ton of pictures, every single one of them tagged with specific metadata. That's quite a switch to make !
Supporting them on Hentoid would require search and reading features to be able to navigate through pictures grouped and filtered by metadata, which is totally feasible, but heavy in terms of development.
