Skip to content

Troubleshooting

Facing source or app issues? Here's how to troubleshoot.

Be sure to check the Frequently Asked Questions for how to address common issues too.

WebView

Accessing websites via WebView

  1. Open Browse from the bottom navbar.
  2. Tap the desired source.
  3. Tap the WebView icon in the top toolbar.
  4. Complete a CAPTCHA if one is shown.
  5. Close by tapping X at the top-left.

Repeat if needed. Alternatively, try opening the website in your browser using the Overflow icon in the WebView screen and solve any CAPTCHA there.

Open WebView
Open WebView

Clearing cookies and WebView data

This resets your WebView to a clean state, including any login states.

  1. Navigate to More -> Settings -> Advanced.
  2. Tap Clear cookies.
  3. Tap Clear WebView data.

WebView update

To update WebView, you need to find what WebView implementation is used on your device.

Typical default implementation depends on the Android version as follows:

Android 7 and above

Newer Android users can check/change WebView in Developer Options.

Caution with Non-Standard WebView

Using non-standard WebView (like Firefox) might cause Tachiyomi to malfunction or crash.

It's best to use the standard Android System WebView or Google Chrome.

Cloudflare

Cloudflare, an anti-bot mechanism, is used by some sources. Some sources intentionally have higher Cloudflare protection to deter apps like Tachiyomi.

Dealing with Cloudflare looping

Certain sources may employ more advanced Cloudflare protection, leading to WebView continuously reloading when bypassing using the above solution. If this occurs, try Accessing the Website via WebView.

Changing your user agent

A user agent string shares requester information with websites, potentially affecting Cloudflare's bot detection. While some sources have specific user agent strings, most rely on the app's default.

Changing your user agent

  1. Navigate to More -> Settings -> Advanced.
  2. Modify Default user agent string to another value. You may need to experiment to find one that works.

Here's a reference.

  1. Restart the app and retry source access.

Did these methods not work?

Wait for the source to lower its protection or switch to different sources.

General

Obtaining crash/error logs

For crash investigations, navigate to More -> Settings -> Advanced and tap Dump crash logs.

Dump crashlogs
Dump crashlogs

Obtaining more logs

To diagnose abnormal app behavior, record device logs using a Logcat Reader.

App or extension installation issues

Encountering problems while trying to install app or extension .apk files? Follow these steps:

  1. Install Split APK Installer from the Google Play Store.
  2. Try installing your .apk from Split APK Installer.

Split APK Installer helps show better error messages or may even successfully install your .apk without issue. Common errors include:

INSTALL_FAILED_UPDATE_INCOMPATIBLE: Package eu.kanade.tachiyomi signatures do not match the previously installed version; ignoring!

Seeing this error while installing the .apk over an existing F-Droid build indicates a mismatch in signatures. Data backup, uninstall, and fresh installation are required.

DISPLAY_NAME column is null

Seeing this error points to a corrupted .apk. Try redownloading the .apk.

INSTALL_FAILED_NO_MATCHING_ABIS

Seeing this error suggests the .apk is incompatible with your CPU architecture. Obtain the appropriate version or a universal .apk (i.e. the option with largest file size on GitHub).