Troubleshooting problems

This page is for when you encounter a problem with a source extension.

It can be accompanied by these error messages:

• HTTP Error 5xx

• HTTP Error 4xx

• java.security.cert.CertPathValidatorException

• Page List is empty

• Unable to resolve host

• unexpected url

• Attempt to invoke virtual method 'java.lang.String org.jsoup.nodes.Node.attr(java.lang.String)' on a null object reference

• Failed to bypass Cloudflare

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
• If your downloads are getting stuck, try deleting the queue and trying again.
• Force close Tachiyomi and reopen it.

Bonus step

Try the latest Preview version, your issue may have been fixed.

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

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.

TIP

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 and/or extensions.
2. It may have been fixed already, but not released yet, so look at closed issues (app / extensions) 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.

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 app.

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

Still not working?

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