Troubleshooting

This page is for when you encounter a problem with a source or the app.

What are some common errors?

If error-specific instructions didn't help or your error isn't on the list, go through Diagnosis.

Java.lang Exception: Challenge not found

Often Java.lang Exception: Challenge not found will be resolved by force-quitting and reopening Aniyomi.

Java.lang Exception: Failed to bypass Cloudflare

Java.lang Exception: Failed to bypass Cloudflare means that the source you selected has Cloudflare protection on, refer to the Cloudflare guide to fix it.

Loader not implemented

Loader not implemented means that the respective extension for the manga is not installed. To fix this, install the extension for the manga. If it still doesn't work, uninstall, then reinstall the extension again.

HTTP error 403

Possible reasons for HTTP error 403:

• The source you selected has Cloudflare protection on, refer to the Cloudflare guide to fix it.
• The source is down, removed the manga, or banned your IP. Open
  public
  WebView to check if this is the case.

HTTP error 404

HTTP error 404 probably means that the source is down or removed the manga. Open

public

WebView to check if this is the case.

HTTP error 429 (Too Many Requests)

HTTP error 429 or Too Many Requests means that the source banned your IP address (in most cases, it's temporary). We suggest migrating part of your manga to another source to reduce the number of requests to the source.

HTTP error 5xx

HTTP error 5xx like 500, 502 and others are server errors, and the source you are trying to access has problems on their side. Open the source in

public

WebView and check if the site is down.

Unable to resolve host / Connection failed

Errors like Unable to resolve host or Connection failed mean that something prevents your connection to the site.

Possible reasons include:

• Your internet connection is not good enough to connect.
• The app does not have access to the internet.
• Your ISP has blocked the site.
• The site is down. Try using different internet connection (switch to Wi-Fi, mobile data or a VPN). Try to enable
  more_horiz
  More →
  settings
  Settings →
  code
  Advanced → DNS over HTTPS.

java.security.cert.CertPathValidatorException / Chain validation failed

java.security.cert.CertPathValidatorException or Chain validation failed means there is a problem with validating source's sertificate.

• Check if the site's certificate has expired. Use an online service for checking SSL certificates. If the certificate has expired, wait while the site owner to renew it.
• Ensure that you have the right date and time set on your phone.
• Try
  more_horiz
  More →
  settings
  Settings →
  code
  Advanced → Clear cache and Clear cookies.
• Try using a different internet connection (switch to Wi-Fi, mobile data or a VPN).
• Try restarting the device.

App not installed

You may encounter App not installed if you're installing an official build over an existing F-Droid build due to differing signatures. Backup your data, uninstall the app, then restore the data in the fresh install.

Attempt to invoke virtual method 'com.hippo.unifile...

The Attempt to invoke virtual method' com.hippo.unifile... error can be caused by various reasons, but they all have to do with storage.

• Most commonly, it is caused by full storage. Check to see if your device or SD Card is full.
• Check if Aniyomi has access to the SD card. You can enable it in the android settings for app permissions.
• If you're downloading and this error pops up, that means the app might not be able to access the folder you're trying to download to. This may be because the folder is corrupted or does not exist. Use a file manager to check that the folder(s) exist and every folder in the sequence is available and accessible.
• The drive you're writing to is corrupted. Check using a file manager to see if it is accessible.

Cannot Access SD Card

Cannot Access SD Card error is typically caused by having a file or folder name that is too long. Android's file manager does not support filenames longer than 255 characters. If you know the file or folder name that is the culprit, you can connect your SD card to your computer and shorten it. Otherwise, delete the Aniyomi downloads folder off of the SD Card.

Storage issues with Android 11

Following the introduction of Scoped Storage (opens new window) in Android 11, your library could load slowly, or the app is unable to delete chapters automatically.

One way to fix this is by executing an ADB (opens new window) command on a computer to opt-out the app for the new storage changes.

How to run ADB

ADB is a small tool bundled in the Android SDK as part of the "Platform Tools."

1. Download the SDK Platform Tools (opens new window) for Windows, Mac, or Linux
2. Extract the ZIP file somewhere easily accessible (like C:\platform-tools)

You will need to enable "USB Debugging/Android Debugging" on your phone next:

• If you use a custom ROM or aren't able to enable Developer options, try googling how to enable Developer options on your specific device

1. Open Settings
2. (Only on Android 8.X) Scroll down/Select to System
3. Select About phone
4. Quickly tap Build number 7 times
5. You will see a message appear that says, "You are now a developer."
6. Now go back, and you'll see Developer options listed
7. Scroll until you find USB debugging/Android debugging
8. Toggle the switch to enable it

With platform-tools downloaded and USB debugging enabled, you can now follow the following steps:

1. Connect your Android device to the computer with a USB cable
2. Make sure to allow "USB debugging/Android debugging" when a pop-up appears
3. Open the platform-tools folder on your computer
4. Shift+Right click and select Open command prompt here or Open PowerShell window here
5. Type .\adb devices and hit Enter
6. You should see an entry with your device(s)
7. Now, enter the following ADB command:

ADB command

.\adb shell cmd appops set eu.kanade.tachiyomi android:legacy_storage allow

If you're using Preview, or a Fork, replace eu.kanade.tachiyomi with the other app's ID.

• Aniyomi Preview → eu.kanade.tachiyomi.debug

Please note that the command will not show any output if it is successful.

Diagnosis

• Verify your extensions are up to date (
  explore
  Browse → Anime Extensions/Manga Extensions, make sure no extensions have an Update button).
• Check if Aniyomi has an update (
  more_horiz
  More →
  info
  About then tap Check for updates).
• Verify that WebView is updated.
• Try opening the manga in
  public
  WebView . If there is a Cloudflare protection, wait for it to load. If there is a CAPTCHA, solve it and see if it helped.
• Change your internet connection (switch to Wi-Fi, mobile data or a VPN, use a "What's my IP" site to confirm your IP has changed), then try again.
• Ask other users to try the action that gives you the error.
• Check if the source is either down, or is having issues in a browser.
• Press the retry button in the middle of your manga page if one exists.
• Try the following at
  more_horiz
  More →
  settings
  Settings →
  code
  Advanced
  • Clear Cache
  • Clear Cookies
  • Clear Database
  • DNS over HTTPS
• If your downloads are getting stuck, try deleting the queue and trying again.
• Force close Aniyomi and reopen it.

The Preview version may have already fixed your issue. Just wait for a new Stable release.

If any of these solutions help, go to it only happens to me. If it's not just you, go to everyone is having this problem.

If none of these solutions help, try asking in our Discord Server (opens new window). State your app version and the source, manga, and chapter with the problem.

It only happens to me

You may be getting a Cloudflare protection, may have been IP-banned, or encountered some other counter-measure that website owners deploy against programs like Aniyomi. If that is the case, there is probably nothing that Aniyomi can do to solve it. Some of them (like Cloudflare) have to be manually solved, and some are temporary (IP bans).

Workarounds that can the lower chance of an issue happening again:

• Don't use downloads with the source.
• Have less manga in your library from the source.

The above are very imprecise and fuzzy rules because each site has its non-public limits and triggers.

Everyone is having this problem

If the site is reachable and fully functional, there may be an issue with the extension or app.

1. Have a look at open issues for the app (opens new window) and/or Aniyomi extensions (opens new window) for anime exetnsion and check Tachiyomi extensions (opens new window)for manga extension.
2. It may have been fixed already but not released yet, so look at closed issues (app (opens new window) / Aniyomi extensions (opens new window) / Tachiyomi extensions (opens new window)) issues as well.
3. If you can't find the issue there, open a new one.

If the site is not reachable or has issues, all you can do is wait for the site to become functional again.

Solving the Cloudflare issue

Please note that WebView is not the same as using your browser.

You must solve the Cloudflare issue in WebView.

How to open WebView

1. Go to
   explore
   Browse in the bottom navbar.
2. Press the source you would like to access.
3. Press the
   public
   WebView icon.

   

4. Complete the CAPTCHA if one is present.
5. Once done, press the X at the top left to return.

Bypassing Cloudflare looping

Some sources may have more advanced Cloudflare protection, that results in infinite loading in WebView when trying to bypass Cloudflare using the solution above. If you are facing this issue, try the following steps:

GUIDE

1. Go to
   explore
   Browse in the bottom navbar.
2. Press the source you would like to access.
3. Press the
   public
   WebView icon. Refer to the previous picture.
4. Press the
   more_vert
   Overflow icon and then press Open in Browser.
5. Once done, press the X at the top left and return to the source.
6. Press the
   public
   WebView icon again.
7. Complete the CAPTCHA if one is present.

Update WebView

To update WebView, you need to find what WebView implementation is used on your device. In general, default implementation depends on the Android version as follows:

• Android 10.0 and higher - Android System WebView (opens new window).
• Android from 7.0 to 9.0 - Google Chrome (opens new window).
• Android 6.0.1 and lower - Android System WebView (opens new window).

Users on Android 7.0 and up can also see and change WebView implementation in Developer Options (opens new window).

Non-standard implementations like Firefox can lead to Aniyomi not working correctly or, in the worst-case crash. We recommend to set WebView implementation to Android System WebView (opens new window) or Google Chrome (opens new window).

Unable to install the app or extensions

Try installing Split APK Installer (opens new window) from the Google Play Store, then use it to try and install the affected APK. Split APK Installer will tell you why the APK is uninstallable, or it will install the APK for you.

Getting Logcats and Crash Logs

To dump crash logs following an app crash, go to

more_horiz

More →

code

Advanced → Dump Crash Logs

To get device logs if the app is not behaving as expected, record the device logs using a Logcat Reader (opens new window).