Mirrors/tachiyomi-website
2
0
Fork 0
mirror of https://github.com/tachiyomiorg/website.git synced 2024-12-21 07:31:58 +01:00
Code Issues Packages Projects Releases Wiki Activity

Cleaned up outdated info, grammar, punctuation, phrasing and removed contractions (#644)

Browse Source 
* replaced all occurences of click with tap.

* removed mangabox due to split

* remove all contractions from faq

informal language tm

* remove outdated entries

* grammar and style

* rephrase what is tachi preview

* google play store wording

* remove mangarock specific error

this is literally almost 2 years old now

* rephrase sections as questions, added backup sync

* Revert "rephrase sections as questions, added backup sync"

This reverts commit e87372d879e1dcda6b829052a955f8c274e833ec.

* rephrase sections as questions, removed mangadex line

* rephrase sections as questions

* cleaned up some grammar and punctuation

* changed incorrect info

* more little things

* removed contraction in local manga

* accidentally bolded the title

* removed extra space

* remove extra collapse semicolons

* punctuation and forgot words in tracking

* added troubleshooting suggestion

Co-authored-by: Soitora <simon.mattila@protonmail.com>

* Added backup suggestion

Co-authored-by: Soitora <simon.mattila@protonmail.com>

Co-authored-by: Soitora <simon.mattila@protonmail.com>
This commit is contained in:
loocool2 2021-05-11 17:19:03 -07:00 committed by GitHub
parent a0eff0a099
commit b6f85fc9a7
5 changed files with 110 additions and 113 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

116
src/help/faq/README.md
View File

@ -19,10 +19,10 @@ Enable it by going to <Navigation item="library"/> → <Navigation item="filter"
:::
#### How do I ignore duplicate chapters?
Every now and then you find a manga that is translated by more than one group. Because of this, you get multiple releases for each chapter in the manga. There are several ways to skip the duplicate chapters:
Sometimes, you find a manga that is translated by more than one group. Because of this, you get multiple releases for each chapter in the manga. There are several ways to skip the duplicate chapters:
* On the manga page, click on <Navigation item="filter"/> → **Sort** and choose **By chapter number**. This will cause the reader to skip duplicates as you read.
* Bookmark or mark as read the unwanted chapters, then click on <Navigation item="filter"/> → **Filter** and double-tap **Bookmarked** or single-tap **Unread**, respectively. This will hide any bookmarked or read chapters and skip them as you read along, as long as you have **Skip filtered chapters** enabled under <Navigation item="more"/> → <Navigation item="settings"/> → <Navigation item="settings_reader"/> → **Reading**.
* On the manga page, tap on <Navigation item="filter"/> → **Sort** and choose **By chapter number**. Doing this will cause the reader to skip duplicates as you read.
* Bookmark or mark as read the unwanted chapters, then tap on <Navigation item="filter"/> → **Filter** and double-tap **Bookmarked** or single-tap **Unread**, respectively. This will hide any bookmarked or read chapters and skip them as you read along, as long as you have **Skip filtered chapters** enabled under <Navigation item="more"/> → <Navigation item="settings"/> → <Navigation item="settings_reader"/> → **Reading**.
* Migrate to another source that does not have duplicates. For more information on how to migrate a manga, see the [migration guide](/help/guides/source-migration/).
#### Why are some cover thumbnails corrupted, white, or showing a broken page?
@ -37,38 +37,38 @@ The URLs of the manga chapters have changed, so Tachiyomi detects the chapter(s)
### Browse
#### Why can't I find a certain manga?
Sometimes you can struggle to find a source that has the manga you're looking for. Here are some tips to help you find it:
#### Why can I not find a certain manga?
Sometimes you can struggle to find a source that has the manga you are looking to read. Here are some tips to help you find it:
::: guide Tips to find your manga
1. Look up the manga on [Google](https://google.com/) or a manga database such as [MangaUpdates](https://www.mangaupdates.com/).
1. See if the manga has any alternate spellings or other title variations. Try searching again in your sources with the alternate titles you found.
1. If you still can't find the manga in any of your sources, then try to search for an extension for the website you've found in step 1 in the [extensions](/extensions/) list.
1. If you still cannot find the manga in any of your sources, then try to search for an extension for the website you've found in step 1 in the [extensions](/extensions/) list.
#### If you find the manga on a specific scanlator/aggregator and they do have an extension
Download the corresponding extension, click on it under <Navigation item="browse"/> → **Sources**, and then search for the manga there.
#### If you find the manga on a specific scanlator/aggregator and they don't have an extension
Download the corresponding extension, tap on it under <Navigation item="browse"/> → **Sources**, and then search for the manga there.
#### If you find the manga on a specific scanlator/aggregator and they do not have an extension
Check if adding the site as an extension has [already been requested](https://github.com/tachiyomiorg/tachiyomi-extensions/issues). If it hasn't been, you can [request it yourself](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/new/choose).
If the scanlator or aggregator doesn't have an online manga reader, you can download the manga from their website and set up the series as a [local manga](/help/guides/local-manga/).
If the scanlator or aggregator does not have an online manga reader, you can download the manga from their website and set up the series as a [local manga](/help/guides/local-manga/).
:::
### Reader
#### Why are some images not displayed?
Aside from network issues, it could be because the images are too big or that the decoder doesn't support that image type.
Aside from network issues, it could be because the images are too big or that the decoder does not support that image type.
### Downloads
#### How do I download several chapters or manga simultaneously?
The app doesn't allow parallel downloads from one source to prevent IP bans caused by too many requests. We know that speed is being sacrificed but it's better than not being able to access a source at all.
The app does not allow parallel downloads from one source to prevent IP bans caused by too many requests. We know that speed is being sacrificed, but it is better than an overall inaccessible source.
However, if you're downloading several manga from different sources, the app will start downloading simultaneously from up to 5 different sources.
However, if you download several manga from different sources, the app will start downloading simultaneously from up to 5 different sources.
#### Why do my downloads sometimes stop midway through?
Be aware that it could be a network issue on your device or on the website you are trying to download from.
It is likely an issue to do with your connection to your network or the source. Tachiyomi will notify you of what error it has encountered trying to download.
#### Can you make it possible to store manga on both internal storage and external SD-card?
At the moment, no. You could try using symlinks but that requires having your device rooted.
At the moment, no. You could try using symlinks, but that requires having your device rooted.
::: note
Read more about rooting your device [here](https://www.xda-developers.com/root/)
:::
@ -76,10 +76,10 @@ Read more about rooting your device [here](https://www.xda-developers.com/root/)
### Tracking
#### How do I log in with Kitsu?
To log in with Kitsu you need to use your email address as your username.
To log in with Kitsu, you need to use your email address as your username.
#### Why can't I find manga in MAL's search results?
If you can't find a manga by name, you can look it up on MAL and then search for it in Tachiyomi using the following format: `id:<id from manga URL>`. You can also search for a manga on your MAL profile list by searching in the following format: `my:<manga name>`.
#### Why am I unable to find a manga in MAL's search results?
If you cannot find a manga by name, you can look it up on MAL and then search for it in Tachiyomi using the following format: `id:<id from manga URL>`. You can also search for a manga on your MAL profile list by searching in the following format: `my:<manga name>`.
::: note
Related GitHub issue: [#65](https://github.com/tachiyomiorg/tachiyomi/issues/65)
:::
@ -89,8 +89,8 @@ Related GitHub issue: [#65](https://github.com/tachiyomiorg/tachiyomi/issues/65)
#### How do I import my manga into Tachiyomi?
We recommend you to read [this](/help/guides/local-manga) guide on how to do so.
#### What do I do if I can't find the Tachiyomi folder?
If you don't see the **Tachiyomi** folder on your device, try setting the download location to default and downloading a chapter of any manga so that the folder can be created.
#### What do I do if I cannot find the Tachiyomi folder?
If you do not see the **Tachiyomi** folder on your device, try setting the download location to default and downloading a chapter of any manga so that Tachiyomi creates a folder. If needed, you may manually create a Tachiyomi folder as well.
::: guide
Set download location to default by going to <Navigation item="more"/> → <Navigation item="settings"/> → <Navigation item="settings_downloads"/> → **Download location** and selecting first option. Restart the app after changing download location.
@ -101,7 +101,7 @@ Sometimes some covers for local manga aren't displayed. Follow these steps to fi
::: guide
1. Make sure you've created the right folder structure. To check it, open the manga with the missing cover and check if you can read chapters in the app. If not, follow [this](/help/guides/local-manga) guide first.
1. Take a screenshot of which chapters you've read and then remove manga from the library.
1. Take a screenshot of which chapters you've read, and then remove manga from the library.
1. Go to <Navigation item="more"/> → <Navigation item="settings"/> → <Navigation item="settings_advanced"/> and tap **Clear database**. This only affects manga that aren't in your library.
1. Go to <Navigation item="browse"/> → **Local source** and find the manga. The cover should be fixed now. Add the manga back to your library, mark your read chapters, and re-add tracking if needed.
:::
@ -113,13 +113,13 @@ Related GitHub issue: [#932](https://github.com/tachiyomiorg/tachiyomi/issues/93
### Application Updates
#### How do I enable automatic updates?
From version **0.9.0** and onwards, Tachiyomi has automatic updates for the app enabled by default. The **Preview** version also has automatic updates enabled by default.
From version **0.9.0** and onwards, Tachiyomi has had automatic updates for the app enabled by default. The **Preview** version also has automatic updates enabled by default.
However, if you think you are on an outdated version, go to <Navigation item="more"/> → <Navigation item="about"/> and click on **Check for updates**.
However, if you think you are on an outdated version, go to <Navigation item="more"/> → <Navigation item="about"/> and tap on **Check for updates**.
#### Why are automatic updates not working?
Certain devices such as MIUI have very aggressive battery saving, which can kill the app in the background. To whitelist Tachiyomi from your battery saver, go to <Navigation item="more"/> → <Navigation item="settings"/> → <Navigation item="settings_advanced"/> and click on **Disable battery optimization**. If that does not work, you can also visit [DontKillMyApp](https://dontkillmyapp.com/) to see what battery saving options your device has and how to disable or circumvent them.
Certain Android skins like MIUI have very aggressive battery saving, which can kill the app in the background. To whitelist Tachiyomi from your battery saver, go to <Navigation item="more"/> → <Navigation item="settings"/> → <Navigation item="settings_advanced"/> and tap on **Disable battery optimization**. If that does not work, you can also visit [DontKillMyApp](https://dontkillmyapp.com/) to see what battery saving options your device has and how to disable or circumvent them.
### User Interface
@ -133,34 +133,34 @@ You can change language by going to <Navigation item="more"/> → <Navigation it
### Miscellaneous
#### What is Tachiyomi Preview?
It's a weekly-updated, beta version of the app. It contains features that may be added to Tachiyomi in the future but also is more prone to bugs and crashes. Tachiyomi Preview is used by developers and contributors to test the app and find bugs.
It is a weekly updated, beta version of the app. It contains features that may be added to Tachiyomi in the future and is more prone to bugs and crashes. It is intended for users who would like the bleeding edge of Tachiyomi as soon as it comes out.
If you are willing to use Tachiyomi Preview, be sure to [turn on auto-backup](/help/guides/backups/#turning-on-auto-backups) to prevent losing your library due to potential bugs or crashes.
#### Why can't I uninstall Tachiyomi?
#### Why am I unable to uninstall Tachiyomi?
On **Android 10**, a bug was introduced which prevented users from uninstalling the app if the device had a MicroSD card. To fix the issue, please remove the MicroSD card from the device first, then uninstall Tachiyomi.
On **Android 10**, a bug was introduced that prevented users from uninstalling the app if the device had a MicroSD card. To fix the issue, please remove the MicroSD card from the device first, then uninstall Tachiyomi.
#### Will there be an iOS version?
There is no iOS version and there are no plans for one. Since iOS and Android apps don't share code, it's hard to port.
There is no iOS version, and there are no plans for one. Since iOS and Android apps do not share code, it is hard to port.
#### Will Tachiyomi ever be on the Google Play Store?
Due to Google Play's content policy, almost certainly not, as they do not allow the APK system to work. The content on some websites will lead to Google taking it down at some point, and Inorichi does not want to have to deal with it as they have stated [before](https://github.com/tachiyomiorg/tachiyomi/issues/1745#issuecomment-441208074).
Google Play's content policy does not allow the APK based extension system to work. The content on some websites will lead to Google taking it down at some point, and Inorichi does not want to have to deal with it as they have stated [before](https://github.com/tachiyomiorg/tachiyomi/issues/1745#issuecomment-441208074).
#### How can I report Tachiyomi copycats on the Google Play Store?
If you're on desktop, fill out [this](https://support.google.com/googleplay/android-developer/contact/takedown) form following [these](https://pastebin.com/08eeuJxH) steps.
If you are on desktop, fill out [this](https://support.google.com/googleplay/android-developer/contact/takedown) form following [these](https://pastebin.com/08eeuJxH) steps.
#### Can Tachiyomi read Light Novels?
No. Tachiyomi is an image parser, meaning it can't parse text.
No. Tachiyomi is an image parser, meaning it cannot parse text.
#### Can I revert back from the Material Design 2 update of Tachiyomi?
#### Can I revert from the Material Design 2 update of Tachiyomi?
While there will never be a toggle between the two UI versions, you can continue to use the old UI version by using [TachiyomiAZ](https://tachiyomi.org/forks/TachiyomiAZ/).
#### Will there ever be a dual-page reader option?
The logic required to make a dual-page reader automatically work along with scanlator page inconsistencies and other issues means it is unlikely to be added at this time.
#### Why can I see manga pages in my device's photo gallery?
Tachiyomi adds a `.nomedia` file to the downloads folder by default to prevent this from happening, but sometimes it doesn't work or something went wrong. To fix this, all you need to do is create the file yourself. Name it `.nomedia` and place it in your downloads folder. If you are having the same problem with your local manga, place the `.nomedia` file in the local folder.
Tachiyomi adds a `.nomedia` file to the Downloads folder by default to prevent this from happening, but sometimes it does not work, or something goes wrong. To fix this, all you need to do is create the file yourself. Name it `.nomedia` and place it in your downloads folder. If you have the same problem with your local manga, place the `.nomedia` file in the local folder.
#### I lost everything, what now?
To avoid data loss in the future, you can use the automatic backup feature.
@ -177,18 +177,15 @@ See the [guide](/help/guides/backups/#restoring) on restoring from a backup.
### General
#### What are some recommended extensions?
Tachiyomi does not endorse or recommend any manga source, and there is no best extension. Rather, we encourage users to spend some time trying out a few sources themselves, and discover what sources work best for them. What works well for somebody else might not work well for you.
Tachiyomi does not endorse or recommend any manga source, and there is no best extension. Instead, we encourage users to spend some time trying out a few sources themselves and discover what sources work best for them. What works well for somebody else might not work well for you.
<ElAlert type="info" title="Disclaimer" description="Tachiyomi is not hosting any content, we are not affiliated with or responsible for any source that is; slow, down, missing chapters, or has subpar image quality." show-icon :closable="false"></ElAlert>
#### What are scanlator sources?
Manga that are not officially licensed are translated by scanlators, who either publish on their own website or on **MangaDex**. This is in contrast to official sources like **MANGA Plus By SHUEISHA** or **VIZ Shonen Jump**, which host officially licensed and translated manga.
Manga that are not officially licensed are translated by scanlators, who either publish on their websites or **MangaDex**. This practice contrasts with official sources like **MANGA Plus By SHUEISHA** or **VIZ Shonen Jump**, which host officially licensed and translated manga.
Learn more about scanlation in this **Wikipedia** [**article**](https://en.wikipedia.org/wiki/Scanlation).
#### Which sources are in the multi-source extensions?
Some extensions contain multiple sources. Consult the [extension list](/extensions/) to find out which extension to install for the specific source that you want.
#### How do I request a new extension?
Open an issue on [GitHub](https://github.com/tachiyomiorg/tachiyomi-extensions/issues) if one does not already exist.
@ -196,8 +193,8 @@ Open an issue on [GitHub](https://github.com/tachiyomiorg/tachiyomi-extensions/i
You can find the list of extensions to download [here](/extensions/)
:::
#### I'm having problems installing an extension, what can I do?
In some cases, your device might have some issues downloading and automatically installing an extension. In those cases, you can manually download and install the extension yourself. Go to the [extension list](extensions/), find the extension you want, and click **Download**. Once the .apk file has been downloaded, use your file manager to find it and open it. A prompt to install it as an app should pop up. Once it is done installing, it will be automatically added to Tachiyomi as a source.
#### I am having problems installing an extension; what can I do?
In some cases, your device might have some issues downloading and automatically installing an extension. In those cases, you can manually download and install the extension yourself. Go to the [extension list](extensions/), find the extension you want, and tap **Download**. Once the .apk file has been downloaded, use your file manager to find it and open it. A prompt to install it as an app should pop up. Once it is done installing, it will be automatically added to Tachiyomi as a source.
#### How do I allow third-party installations?
::::: el-tabs
@ -205,7 +202,7 @@ In some cases, your device might have some issues downloading and automatically
::: videolink
[<MaterialIcon icon="videocam"/> Click for Android 8.0 and newer video guide](/assets/faq_unknown-sources-a10.webm)
:::
When installing your first extension and are prompted that your device *isn't allowed* to install unknown apps from that source, simply follow the prompt to allow it.
When installing your first extension and you are prompted that your device *isn't allowed* to install unknown apps from that source, follow the prompt to allow it.
In *newer* versions of **Android**, you need to enable **Install unknown apps** on a per-app basis.
::::
@ -213,7 +210,7 @@ In *newer* versions of **Android**, you need to enable **Install unknown apps**
::: videolink
[<MaterialIcon icon="videocam"/> Click for Android 7.1 and older video guide](/assets/faq_unknown-sources-a7.webm)
:::
When installing your first extension and are prompted that your device *isn't allowed* to install unknown apps from that source, simply follow the prompt to allow it.
When installing your first extension and you are prompted that your device *isn't allowed* to install unknown apps from that source, follow the prompt to allow it.
In *older* versions of **Android**, you only need to enable **Unknown sources** globally.
::::
@ -224,7 +221,7 @@ If you need more help regarding this, read [this](https://www.theandroidsoul.com
:::
#### How do I uninstall an extension?
Extensions for **Tachiyomi** are technically installed the same as normal apps. Either you uninstall them through the app section on your device's settings or do it in the app.
Extensions for **Tachiyomi** are technically installed the same as standard apps. Either you uninstall them through the app section on your device's settings or do it in **Tachiyomi**.
::: guide
To uninstall an extension from within **Tachiyomi**, go to <Navigation item="browse"/> → **Extensions** then tap **Uninstall** on the extension you want to remove.
@ -235,15 +232,15 @@ To uninstall an extension from within **Tachiyomi**, go to <Navigation item="bro
You do this by following the steps below:
1. Go to <Navigation item="browse"/> → **Sources**.
1. Click on <Navigation item="filter"/> on the top right corner.
1. Tap on <Navigation item="filter"/> on the top right corner.
1. Scroll down until you find the language of your source and enable it.
### MangaDex
#### Version 5 API Rewrite
##### Do I need to login to search?
You do not need to login to MangaDex to read manga anymore.
##### Do I need to log in to search?
You do not need to log in to MangaDex to read manga anymore.
##### Why are all the covers placeholders?
Covers do not work right now due to it not being in the API yet.
@ -252,16 +249,16 @@ Covers do not work right now due to it not being in the API yet.
Reading and downloading works fine.
##### Why aren't there any new manga updates?
There are no new uploads as the frontend is not up yet, so scanlators cannot upload anything new.
There are no new uploads as the frontend is not up yet, so the scanlators cannot upload anything new.
##### Why are all my manga saying "Manga ID format has changed, migrate from MangaDex to MangaDex to continue reading"?
You need to [migrate](./source-migration.md) all your MangaDex manga from MangaDex to MangaDex as MangaDex has changed their manga ID system from normal IDs to UUIDs.
You need to [migrate](./source-migration.md) all your MangaDex manga from MangaDex to MangaDex as MangaDex has changed their manga ID system from IDs to UUIDs.
##### Will I lose my downloads?
##### Will I lose my downloads if I migrate?
Downloads from before will not be removed or lost by the app.
##### Why can't I restore from a JSON backup?
JSON backups are now unusable due to the ID change, you'll have to manually readd your manga.
##### Why can I not restore from a JSON backup?
JSON backups are now unusable due to the ID change. You will have to manually re-add your manga.
### Mangakakalot, Manganelo, Mangabat and Mangairo
@ -269,7 +266,7 @@ JSON backups are now unusable due to the ID change, you'll have to manually read
The former **Mangabox** extensions have created new entries for many of the manga on their websites. The old entries are obsolete and will not work. To resolve this, [migrate](/help/guides/source-migration/) the manga from the source to itself to get the new entry, or better yet, to a different source entirely to avoid similar errors in the future.
#### How do I fix the `Image could not be decoded` error?
Open the manga in <Navigation item="webview"/>, open a chapter, and wait for the images to load. If they don't load, you will need to look elsewhere to read that particular manga, as some of the former **Mangabox** sources, such as **Mangakakalot**, are now blocking entire regions.
Open the manga in <Navigation item="webview"/>, open a chapter, and wait for the images to load. If they do not load, you will need to look elsewhere to read that particular manga, as some of the former **Mangabox** sources, such as **Mangakakalot**, are now blocking entire regions.
### MangaPark
@ -281,29 +278,24 @@ To solve this issue, follow the below steps.
1. Choose an option like **Smart list** or **Prioritize source**.
1. Go back to **MangaPark**'s chapter list and refresh it.
### Webtoons
#### How do I fix the `Page list is empty` error?
You will have to open the manga entry in WebView and verify your age, as Webtoons has added age verifications on their website.
### Toonily
#### Why can't I access Toonily?
The Toonily source may have issues loading due to the the Cloudflare bypass in WebView timing out.
#### Why am I unable to access Toonily?
The Toonily source may have issues loading due to the Cloudflare bypass in WebView timing out.
### Removed Extensions
#### Why can't I download an extension that used to exist?
#### Why am I unable to download an extension that used to exist?
Extensions tend to be removed for a variety of reasons:
- They become too much of a cat and mouse game to maintain due to the website owners changing the site frequently to deter scrapers.
- The site scrambles images in more than one way, making it impossible to make every image unscrambleable.
- A scanlator team requests removal of their site from Tachiyomi.
- A scanlator team requests the removal of their site from Tachiyomi.
- The site is paywalled.
- Require reverse engineering another app.
- The site has been shut down.
A list of extensions that have been removed is available [here](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/3475), it does not include sites that have gone offline.
A list of extensions that have been removed is available [here](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/3475), but it does not include sites that have gone offline.
### Split Extensions
Extensions have been split due to the sheer number of extensions in a single extension, with Madara reaching over 200 extensions at one point, making it unreasonable for both devs and users to filter through extensions. For a deeper explanation of the issue, [this](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/4287) GitHub issue explains in more detail.
@ -335,7 +327,7 @@ The introduction of Scoped Storage means that many storage-related functions tha
You can try the command below if you know how to use ADB, a guide on installing it is also outlined on the site [here](/help/guides/troubleshooting/#what-are-some-common-errors).
```
adb shell cmd appops set eu.kanade.tachiyomi android:legacy_storage allow
adb shell cmd appops set eu.kanade.tachiyomi Android:legacy_storage allow
```
This command enables general storage access for the app, allowing Tachiyomi to use the old general storage access interface.

9
src/help/guides/backups.md
View File

@ -31,10 +31,10 @@ Legacy Backups can hold the following information:
You can do this by going to <Navigation item="more"/> → <Navigation item="settings"/> → <Navigation item="settings_backup"/> and then selecting **Create legacy backup** and select a location to save it.
:::
Legacy Backups are intended for versions of Tachiyomi, or forks based on versions, older than 0.10.7.
Legacy Backups are intended for versions of **Tachiyomi** or forks based on versions older than `0.10.7`.
## Restoring
## How do I restore a backup?
Restoring is done from the <Navigation item="settings_backup"/> settings.
@ -46,11 +46,10 @@ To restore a legacy backup without issues be sure to:
* Install all the <Navigation item="tab_extensions"/> that were installed at the time of the backup.
* Log into the <Navigation item="settings_tracking"/> services that you previously used.
* If you use MangaDex, login to it using **WebView** [as explained here](/help/faq/#no-results-when-searching).
* You're able to access all the sources through the **WebView**.
* Be on a consistent internet connection.
## Transferring downloads
## How can I make my new install of Tachiyomi detect my old downloads?
You can transfer downloaded manga chapters from one version of **Tachiyomi** to another.
@ -58,7 +57,7 @@ You can transfer downloaded manga chapters from one version of **Tachiyomi** to
You can do this by going to <Navigation item="more"/> → <Navigation item="settings"/> → <Navigation item="settings_downloads"/> and then set the download directory to that of the download folder of your old **Tachiyomi**, then restore the backup.
:::
## Turning on auto-backups
## How do I make Tachiyomi automatically backup?
It is highly recommended you turn on auto backups, this will ensure you can recover if need be.

2
src/help/guides/local-manga.md
View File

@ -10,7 +10,7 @@ Follow the steps below to create local manga.
1. Create a folder named `local` in the `/Tachiyomi/` folder.
<ul>
<li> The `/Tachiyomi/` folder is located in the root of phone's **internal storage** or **external SD card** and it's **not related** to the `eu.kanade.tachiyomi/` folder or the download location in the settings.</li>
<li> The `/Tachiyomi/` folder is located in the root of phone's **internal storage** or **external SD card** and it is **not related** to the `eu.kanade.tachiyomi/` folder or the download location in the settings.</li>
</ul>
1. Place correctly structured manga inside `/Tachiyomi/local/`.
<ul>

18
src/help/guides/tracking.md
View File

@ -5,17 +5,19 @@ lang: en-US
---
# Tracking
## What is tracking?
**Tracking** helps you automatically send read manga chapters to supported trackers, so you can keep track of what and when you read it online.
Tracking is currently supported on [MyAnimeList](https://myanimelist.net), [Anilist](https://anilist.co), [Kitsu](https://kitsu.io), [Shikimori](https://shikimori.one), and [Bangumi](https://bangumi.tv/)
- Tracking done **manually** for every manga.
- The last page of the chapter must be reached to have it mark the chapter as read and track it.
- You can manually set the chapter by tapping on the number and then either entering the number in or dragging the ticker up or down.
- After being offline, the tracker will not sync the last read chapter, even after going back online
- Tracking is one-way. Meaning updating status in Tachiyomi will update the tracker, but updating status in the tracker will not update Tachiyomi
- Tracking must be done **manually** for every manga.
- You must read the last page of a chapter to mark the chapter as read and track it.
- You can manually set the chapter by tapping on the number and then entering the number in or dragging the ticker up or down.
- After being offline, the tracker will not sync the last read chapter, even after going back online.
- Tracking is one-way. Meaning updating status in Tachiyomi will update the tracker, but updating status in the tracker will not update Tachiyomi.
# Setting up Tracking <MaterialIcon icon="sync" />
## How do I login into trackers? <MaterialIcon icon="sync" />
:::: guide Guide
::: videolink
@ -23,10 +25,10 @@ Tracking is currently supported on [MyAnimeList](https://myanimelist.net), [Anil
:::
1. Goto More → Settings → Tracking to Login
2. Tap the tracker you would like to login to, it will automatically open the browser and lead you through the login process.
2. Tap the tracker you would like to login to. It will automatically open the browser and lead you through the login process.
::::
## Setting up tracking for each entry
### How do I set up tracking for each manga?
:::: guide Guide

78
src/help/guides/troubleshooting.md
View File

@ -22,46 +22,50 @@ Often **Java.lang Exception: Challenge not found** will be resolved by force-qui
**Java.lang Exception: Failed to bypass Cloudflare** means that the source you selected has [Cloudflare](#solving-the-cloudflare-issue) protection on, refer to the [Cloudflare](#solving-the-cloudflare-issue) guide to fix it.
:::
::: el-collapse-item title="Loader not implemented"
**Loader not implemented** 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.
:::
::: el-collapse-item title="Value Manga is licensed at data of type java.lang.String cannot be converted to JSONObject"
**Value Manga is licensed...** means that the manga has been licensed and can no longer be read on that source. Try a different source to read the manga.
**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.
:::
::: el-collapse-item title="HTTP error 403"
Possible reasons for **HTTP error 403**:
- The source you selected has [Cloudflare](#solving-the-cloudflare-issue) protection on, refer to the [Cloudflare](#solving-the-cloudflare-issue) guide to fix it.
- The source is down, removed the manga or banned your IP. Open <Navigation item="webview"/> to check if this is the case.
- The source is down, removed the manga, or banned your IP. Open <Navigation item="webview"/> to check if this is the case.
:::
::: el-collapse-item title="HTTP error 404"
**HTTP error 404** probably means that the source is down or removed the manga. Open <Navigation item="webview"/> to check if this is the case.
:::
::: el-collapse-item title="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 to [migrate](./source-migration.md) part of your manga to another source to reduce number of requests to the source.
**HTTP error 429** or **Too Many Requests** means that the source banned your IP address (in most cases, it's temporary). We suggest [migrating](./source-migration.md) part of your manga to another source to reduce the number of requests to the source.
:::
::: el-collapse-item title="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 <Navigation item="webview"/> and check if the site is down.
**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 <Navigation item="webview"/> and check if the site is down.
:::
::: el-collapse-item title="Unable to resolve host / Connection failed"
Errors like **Unable to resolve host** or **Connection failed** mean that something prevents your connection with the site. Possible reasons: your internet connection is bad, the app doesn't have access to the 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 <Navigation item="more"/> → <Navigation item="settings"/> → <Navigation item="settings_advanced"/> → **DNS over HTTPS**.
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 <Navigation item="more"/> → <Navigation item="settings"/> → <Navigation item="settings_advanced"/> → **DNS over HTTPS**.
:::
::: el-collapse-item title="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 have expired. Use an online service for checking SSL certificates. If the certificate have expired, then wait while the site owner will renew it.
- 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 <Navigation item="more"/> → <Navigation item="settings"/> → <Navigation item="settings_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.
- Try using a different internet connection (switch to Wi-Fi, mobile data or a VPN).
- Try restarting the device.
:::
::: el-collapse-item title="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.
:::
::: el-collapse-item title="Attempt to invoke virtual method 'com.hippo.unifile..."
**Attempt to invoke virtual method 'com.hippo.unifile...** error can be caused by a variety of reasons, all to do with storage.
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.
- 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.
@ -70,40 +74,40 @@ Backup your data, uninstall the app, then restore the data in the fresh install.
**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 Tachiyomi downloads folder off of the SD Card.
:::
::: el-collapse-item title="Storage issues with Android 11"
After the introduction of [Scoped Storage](https://www.xda-developers.com/android-q-storage-access-framework-scoped-storage/) in **Android 11**, your library could load slowly and/or the app is unable to delete chapters automatically.
Following the introduction of [Scoped Storage](https://www.xda-developers.com/android-q-storage-access-framework-scoped-storage/) 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](https://www.xda-developers.com/quickly-install-adb/) command on a computer to opt-out the app from the new storage changes.
One way to fix this is by executing an [ADB](https://www.xda-developers.com/quickly-install-adb/) 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”.
ADB is a small tool bundled in the Android SDK as part of the "Platform Tools."
1. [Download the SDK Platform Tools](https://developer.android.com/studio/releases/platform-tools.html) 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 and/or aren't able to enable Developer options try googling how to enable Developer options on your specific device
* 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
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 next steps:
With platform-tools downloaded and USB debugging enabled, you can now follow the following steps:
1. Connect your Android device to the computer with an USB cable
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 you can enter the following ADB command!
7. Now, enter the following ADB command:
**ADB command**
@ -118,7 +122,7 @@ If you're using Preview, or a Fork, replace `eu.kanade.tachiyomi` with the other
* **TachiyomiSY** → `eu.kanade.tachiyomi.sy`
* **Neko** → `tachiyomi.mangadex`
***Please note that the command will not show an output if successful.***
***Please note that the command will not show any output if it is successful.***
:::
::::
@ -141,32 +145,32 @@ If you're using Preview, or a Fork, replace `eu.kanade.tachiyomi` with the other
* Force close **Tachiyomi** and reopen it.
::: c-tip
Your issue may have been fixed in the Preview version already, just wait for a new Stable release.
The Preview version may have already fixed your issue. Just wait for a new Stable release.
:::
If any of these help, go to [it only happens to me](#it-only-happens-to-me).
If any of these solutions help, go to [it only happens to me](#it-only-happens-to-me).
If it's not just you, go to [everyone is having this problem](#everyone-is-having-this-problem).
If none of these help, try asking in our [Discord Server](https://discord.gg/tachiyomi). State app version, source, manga and chapter with the problem.
If none of these solutions help, try asking in our [Discord Server](https://discord.gg/tachiyomi). State your app version and the source, manga, and chapter with the problem.
### It only happens to me
You may be getting a [Cloudflare](#solving-the-cloudflare-issue) protection, 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 [Cloudflare](#solving-the-cloudflare-issue)) have to be manually solved, some are temporary (IP bans).
You may be getting a [Cloudflare](#solving-the-cloudflare-issue) protection, 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 **Tachiyomi** can do to solve it. Some of them (like [Cloudflare](#solving-the-cloudflare-issue)) have to be manually solved, and some are temporary (IP bans).
**Workarounds that can lower chance of it happening again:**
**Workarounds that can the lower chance of an issue happening again:**
* Don't use downloads with the source.
* Have less manga in library from the source.
* Have less manga in your library from the source.
::: c-warning
All of the above are very imprecise and fuzzy rules, because each site has their own, non-public limits and triggers.
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 then there may be an issue with the extension or app.
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](https://github.com/tachiyomiorg/tachiyomi/issues) and/or [extensions](https://github.com/tachiyomiorg/tachiyomi-extensions/issues).
1. It may have been fixed already, but not released yet, so look at closed issues ([app](https://github.com/tachiyomiorg/tachiyomi/issues?q=is%3Aissue+is%3Aclosed) / [extensions](https://github.com/tachiyomiorg/tachiyomi-extensions/issues?q=is%3Aissue+is%3Aclosed)) issues as well.
1. It may have been fixed already but not released yet, so look at closed issues ([app](https://github.com/tachiyomiorg/tachiyomi/issues?q=is%3Aissue+is%3Aclosed) / [extensions](https://github.com/tachiyomiorg/tachiyomi-extensions/issues?q=is%3Aissue+is%3Aclosed)) issues as well.
1. 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.
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
@ -193,16 +197,16 @@ To update **WebView**, you need to find what **WebView implementation** is used
* Android 6.0.1 and lower - [Android System WebView](https://play.google.com/store/apps/details?id=com.google.android.webview).
::: c-tip
Users of Android 7.0 and higher can also see and change **WebView implementation** in [Developer Options](https://developer.android.com/studio/debug/dev-options).
Users on Android 7.0 and up can also see and change **WebView implementation** in [Developer Options](https://developer.android.com/studio/debug/dev-options).
:::
::: c-warning
Non-standard implementations like Firefox can lead to Tachiyomi not working correctly or in the worst-case crash. We recommend to set **WebView implementation** to [Android System WebView](https://play.google.com/store/apps/details?id=com.google.android.webview) or [Google Chrome](https://play.google.com/store/apps/details?id=com.android.chrome).
Non-standard implementations like Firefox can lead to **Tachiyomi** not working correctly or, in the worst-case crash. We recommend to set **WebView implementation** to [Android System WebView](https://play.google.com/store/apps/details?id=com.google.android.webview) or [Google Chrome](https://play.google.com/store/apps/details?id=com.android.chrome).
:::
## Unable to install the app or extensions
Try installing [Split APK Installer](https://play.google.com/store/apps/details?id=com.aefyr.sai) from the Google Play Store, then use it to try and install the affected APK. Split APK Installer will either tell you why the APK cannot be installed, or it will install the APK for you.
Try installing [Split APK Installer](https://play.google.com/store/apps/details?id=com.aefyr.sai) 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
@ -214,4 +218,4 @@ To dump crash logs following an app crash, go to (<Navigation item="more"/> →
</figure>
:::
To get device logs if the app is not behaving as expected, record the device logs using a [Logcat Reader](https://play.google.com/store/apps/details?id=com.dp.logcatapp).
To get device logs if the app is not behaving as expected, record the device logs using a [Logcat Reader](https://play.google.com/store/apps/details?id=com.dp.logcatapp).