Troubleshooting problems

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

Common error messages

This is just a list of some errors. Go through Diagnosis even if your problem isn't on the list.

• HTTP Error 4xx
• HTTP Error 5xx
• Unexpected URL
• Page List is empty
• Unable to resolve host
• Failed to bypass Cloudflare
• java.security.cert.CertPathValidatorException
• Attempt to invoke virtual method 'java.lang.String org.jsoup.nodes.Node.attr(java.lang.String)' on a null object reference

Diagnosis

• Verify your extensions are up to date. (
  explore
  Browse → Extensions, make sure no extensions have an update button)
• Check if Tachiyomi has an update (
  more_horiz
  More →
  info
  About then click Check for updates)
• Try opening the manga in
  public
  WebView . If there is 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 Tachiyomi and reopen it.

Your issue may have been fixed in the Preview version already, just wait for a new Stable release.

If any of these 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 help, try asking in our Discord Server (opens new window). State app version, source, manga and chapter with the problem.

It only happens to me

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

Workarounds that can lower chance of it happening again:

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

All of the above are very imprecise and fuzzy rules, because each site has their own, non-public limits and triggers.

Everyone is having this problem

If the site is reachable and fully functional then 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 extensions (opens new window).
2. It may have been fixed already, but not released yet, so look at closed issues (app (opens new window) / 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 having issues then all you can do is wait for the site to become functional again.

What are some common errors?

Java.lang Exception: Challenge not found

Often this will be resolved by force-quitting and reopening Tachiyomi.

Loader not implemented

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

Value Manga is licensed at data of type java.lang.String cannot be converted to JSONObject

This means that the manga has been licensed and can no longer be read on that source. Try a different source to read the manga.

HTTP error 403

The source you selected may have Cloudflare protection on and is enforcing CAPTCHA. Please complete the CAPTCHA to fix it.

HTTP error 429 (Too Many Requests)

The source banned your IP address (in most cases it's temporary). We suggest to migrate part of your manga to another source.

HTTP error 5xx

Most probably 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

That means that something prevents your connection with the site. Possible reasons: your internet connection is bad, the app doesn't have access to internet, your ISP have 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

That means there is a problem with validating source's sertificate.

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

App not installed

You may encounter this 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...

This error can be caused by a variety of reasons, all 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 Tachiyomi 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

This 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 Tachiyomi downloads folder off of the SD Card.

Solving a CAPTCHA

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

You must solve the CAPTCHA in WebView.

How to open WebView

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

   

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

WebView not working?

If WebView doesn't work for you, please update the Android System WebView (opens new window) app.

When you've updated go to Developer Options (opens new window) in your phone's settings and set WebView Implementation to Android System WebView.

If Android System WebView doesn't work, try setting Google Chrome as the default WebView Implementation instead.