Troubleshooting

Sites behind Cloudflare and similar checks fail with Failed to bypass Cloudflare or an HTTP error such as 403.

1. Open the title, or the source's error screen, and select WebView (or Open in WebView). A title that fails to refresh offers WebView with the error, and so does a chapter the book reader couldn't get.
2. Complete the check in the page that opens, then go back. Select Retry on the source's error screen, or refresh the title: pull it down, or press F5.
3. Still failing? Under Settings › Advanced, select Clear cookies, or Clear WebView data, and try again.
4. Some sites block Katari's browser signature. Changing Default user agent string on the same screen, then restarting Katari, can help.

• HTTP 429: the site is limiting how often you ask. Wait a while, and check fewer titles at once.
• Other HTTP codes: open the site in WebView to see what it says.
• No Internet connection or Couldn't reach the site: check the connection, or try DNS over HTTPS (DoH) under Settings › Advanced.
• Source not found: its extension is missing. Select the source's name on the title's page to install it from a store that lists it, or to migrate the title.
• The source stopped responding, ran out of memory on this page or couldn't be loaded: an LNReader plugin failed. Try again later; if it keeps failing, the plugin may need an update.
• LinuxThis source needs …, which Katari doesn't have on desktop yet: the source uses a part of Android the Linux app doesn't have yet. Use it on Android for now.
• A source still fails after you changed its settings or logged in: open the extension under Browse › Extensions and choose ⋮ › Clear data. It deletes the extension's settings, logins and saved data in the profile you're using.

Under Browse › Extensions, extensions that can't be used are listed under Not loaded, labelled with why. Extension compatibility explains each label and lists the extension versions Katari loads.

An installed extension marked Orphaned still works, but no store you've added lists it any more, so it gets no updates. Uninstall it, or add its store again.

When two extensions provide the same source, only one of them is used. The other's page lists the source under Provided by other extensions, with Use this one to switch.

The player's error says what went wrong, and its buttons offer what can help.

• If the source or its server refuses, tap Open in WebView, pass the site's check, and tap Retry.
• If the video still won't play, try another server or quality, or on Android the other player.
• AndroidIf the mpv add-on is missing or out of date, its row under Settings › Players › Anime player says so and offers the fix.

Waiting for a non-metered network means the download was approved for Wi-Fi only. Connect to Wi-Fi, or start it again and tick Allow download on metered networks. Not enough storage needs space freed first. See Translation.

• AndroidThis update is signed with a different key than the installed app: the Katari you have was built by someone else, and Android won't replace it. Back up, uninstall it, install Katari from the download page, and restore the backup.
• GitHub is limiting update checks from this network: try again later.
• AndroidThere isn't enough free storage to install the update: free some space and try again.
• LinuxKatari can't replace its AppImage at …: move the AppImage to a folder you can write to, or download the new version from the download page.

1. Under Settings › Advanced, select Share crash logs. On Android, save or send the file from the share sheet; on Linux, choose where to save it.
2. In Settings › About, select Version to copy the version details.
3. Open an issue on GitHub with both, and the steps that lead to the problem.