Rewrite "Application"

This commit is contained in:
Soitora 2023-08-30 22:23:36 +02:00
parent b065dacabc
commit 56a3c15101
No known key found for this signature in database
GPG Key ID: A6D711EB4F2CCD97
11 changed files with 186 additions and 193 deletions

View File

@ -31,8 +31,8 @@ function defaultSidebar() {
collapsed: true,
items: [
{
text: "Reading with Local Source",
link: "/docs/faq/application/browse/reading-with-local-source",
text: "Local sources",
link: "/docs/faq/application/browse/local-sources",
},
],
},

View File

@ -1,28 +1,32 @@
---
title: Android 11+
description: WIP
description: Understanding Android 11 Changes
---
# Android 11+
Understanding **Android 11** Changes
## What changed in Android 11?
## Android 11 Modifications
**Android 11** introduced changes related to [Scoped Storage](https://developer.android.com/about/versions/11/privacy/storage), which was initially introduced in **Android 5.0 Lollipop**.
In Android 11, Google began forcing users to use [Scoped Storage](https://developer.android.com/about/versions/11/privacy/storage), which was introduced in Android 5.0 Lollipop, but Google only began forcing developers to use it on Android 11.
Some OEMs seem to better implement Scoped Storage than others, with some users not running into any issues while users using other phone brands have multitudes of problems.
However, the enforcement of **Scoped Storage** was initiated by **Google** with **Android 11**.
## What does it mean for Tachiyomi?
Different smartphone manufacturers implement **Scoped Storage** with varying levels of success, resulting in varying user experiences.
Some encounter minimal issues, while others using different phone brands face numerous challenges.
The introduction of Scoped Storage means that many storage-related functions that Tachiyomi uses may be much slower due to the inherent slowness of Scoped Storage, as outlined [here](https://www.xda-developers.com/android-q-storage-access-framework-scoped-storage/).
These include deleting chapters, library load times, accessing the folders outside the data folders to download to or read from, and more.
## Implications for Tachiyomi
**Scoped Storage**'s introduction affects various storage-related functions in **Tachiyomi**.
These functions may become slower due to **Scoped Storage**'s inherent latency, as discussed in detail [here](https://www.xda-developers.com/android-q-storage-access-framework-scoped-storage/).
## Is there any way to improve performance?
This impact encompasses tasks like deleting chapters, library loading times, accessing folders outside data directories for downloads and reading, and more.
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.
## Enhancing Performance
For potential performance improvements, consider utilizing the following ADB command if you are comfortable with it.
```bash
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.
This command grants general storage access to the app, enabling **Tachiyomi** to use the conventional storage access interface.
If you are using a Tachiyomi Preview or a fork, replace `eu.kanade.tachiyomi` with the corresponding fork's package name.
If using **Tachiyomi Preview**, or a fork, replace `eu.kanade.tachiyomi` with the corresponding package name.

View File

@ -1,39 +1,36 @@
---
title: Browse
description: WIP
description: Frequently Asked Questions regarding Browse.
---
# Browse
Frequently Asked Questions regarding Browse.
## Why can I not see sources that I have installed?
## Why Can't I See Installed Sources?
### If it is an extension that is not the same language as your phone's primary language
### If the Extension Language Differs from Your Phone's Primary Language
Enable the source's language at **Browse -> Sources -> Filter**, then turn on the language of the desired source.
Enable the language of the source by going to Browse → Sources tab → Filter → Turn on the language of the source you would like to use.
### If It's an NSFW Extension
Navigate to **More -> Settings -> Browse** and check the **Show in sources list** option.
### If it is an NSFW extension
## How Can I Locate a Specific Series?
At times, locating a source containing the series you want to read can be challenging.
Settings → Browse → Check show in sources list.
Here are strategies to help you find it:
## How do I find a series I am looking for?
1. Search for the series on [Google](https://google.com/) or a database like [MangaUpdates](https://www.mangaupdates.com/).
1. Consider alternate spellings or title variations for the series.
- Retry searching your sources using the alternate titles you discovered.
2. If you still can't find the series on any source:
- Search for an extension for the website you found in *step 1* within the [extensions list](/extensions/).
Sometimes you can struggle to find a source that has the series you are looking to read.
Here are some tips to help you find it:
### If You Find the Series on a Specific Scanlator or Aggregator With an Extension
Download the relevant extension, locate it under **Browse -> Sources**, and proceed to search for the series there.
Tips to find your series
### If You Find the Series on a Specific Scanlator or Aggregator Without an Extension
Check if a request has been made to add the site as an extension [here](https://github.com/tachiyomiorg/tachiyomi-extensions/issues) and confirm it's not on the [list of extensions that won't be added back](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/3475).
1. Look up the series on [Google](https://google.com/) or a database such as [MangaUpdates](https://www.mangaupdates.com/).
1. See if the series has any alternate spellings or other title variations.
1. Try searching again in your sources with the alternate titles you found.
1. If you still cannot find the series in any of your sources, then try to search for an extension for the website you found in step 1 in the extensions list.
If it's not requested and not on the exclusion list, you can [submit a request here](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/new/choose).
### If you find the series on a specific scanlator or aggregator and they do have an extension
Download the corresponding extension, tap on it under → **Sources**, and then search for the series there.
### If you find the series on a specific scanlator or 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) and that it is not on the list of extensions that will not be added back [here](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/3475).
If it has not been requested and it is not on the list, you can [request it here](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/new/choose).
If the scanlator or aggregator does not have an online reader, you can download the series from their website and set up the series as a local series.
For scanlators or aggregators without an online reader, you can download the series from their website and set it up as a local series.

View File

@ -0,0 +1,29 @@
---
title: Local sources
description: Frequently Asked Questions regarding local sources.
---
# Local sources
Frequently Asked Questions regarding local sources.
## How Can I Import My Downloaded Series into Tachiyomi?
For a step-by-step process, we recommend referring to [this guide](/docs/guides/local-series/).
## What Should I Do If I Can't Find the Tachiyomi Folder?
In case the **Tachiyomi** folder is not visible, create one using a file manager.
## How Can I Resolve Empty/Blank Covers on My Local Series?
Occasionally, cover images for local series might not appear.
1. Confirm that you've organized the folder structure correctly.
* To verify, access the series with the missing cover and see if you can read chapters within the app.
* If not, follow the [provided guide](/docs/guides/local-series/#folder-structure) first.
1. Capture a screenshot of the read chapters, then remove the series from your library.
1. Navigate to **Browse → Settings → Advanced** and tap **Clear database**.
* This action will only affect series not in your library.
1. Return to **Browse -> Local source** and locate the series.
* The cover issue should now be resolved.
* Re-add the series to your library, mark your read chapters, and re-enable tracking if necessary.
Related GitHub Issue: [#932](https://github.com/tachiyomiorg/tachiyomi/issues/932)

View File

@ -1,31 +0,0 @@
---
title: Reading with Local Source
description: WIP
---
# Reading with Local Source
## How do I import my downloaded series into Tachiyomi?*
We recommend you to read [this](../../../guides/local-series/index.md) guide on how to do so.
## What do I do if I cannot find the Tachiyomi folder?
If you do not see the **Tachiyomi** folder, create one with a file manager.
## How do I fix empty/blank covers on my local series?
Sometimes some covers for local series are not displayed.
Follow these steps to fix it:
1. Make sure you have created the right folder structure.
1. To check that you have, open the series with the missing cover and check if you can read chapters in the app.
1. If not, follow this guide first.
1. Take a screenshot of which chapters you have read, and then remove series from the library.
1. Go to → → and tap **Clear database**.
1. This will only affect series that are not in your library.
1. Go back to the → **Local source** and find the series.
1. The cover should be fixed now.
1. Add the series back to your library, mark your read chapters, and re-add tracking if needed.
Related GitHub issue: [#932](https://github.com/tachiyomiorg/tachiyomi/issues/932)

View File

@ -1,48 +1,46 @@
---
title: Downloads
description: WIP
description: Frequently Asked Question related to Downloads.
---
# Downloads
Frequently Asked Question related to Downloads.
## How do I download several chapters or series simultaneously?
## Downloading Multiple Chapters or Series Concurrently
The app does not support parallel downloads from a single source to prevent potential IP bans due to excessive requests.
While this might impact speed, it's preferable to rendering a source inaccessible.
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 series from various sources, up to five different sources can be downloaded simultaneously.
However, if you download several series from different sources, the app will start downloading simultaneously from up to five different sources.
## Downloads Stopping Midway
Downloads stopping midway may relate to network connection issues or source problems.
**Tachiyomi** will provide notifications regarding encountered errors during download attempts.
## Why do my downloads sometimes stop midway through?
## Undetected Downloads Reasons
Downloads might not be detected due to multiple factors:
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.
* Inaccessibility of the download location.
> Ensure the SD card is properly detected if in use.
* Source name changes.
> Rename the source's folder to match the new name.
* Series title modifications by the source.
> Adjust the folder title to the updated name.
### Why aren't my downloads being detected?
## Managing Download Queue
Navigate to **More -> Download Queue** to interact with queued downloads.
This can happen for a variety of reasons:
Cancel all items by clicking the **Overflow** button beside a series chapter or the top right corner.
* The download location may be inaccessible.
* If you are using an SD card, make sure it's detected.
* The source name may have changed.
* Change the name of the source's folder to the new name.
* The source you downloaded the series from may have changed the title.
* Change the title of the folder to the new title.
To reorder the queue, long-press the `=` icon next to a queue item.
## How do I cancel or change the download queue?
## Internal Storage and External SD-Card Storage
As of now, this option isn't available.
You could explore using symlinks, but this requires device rooting.
Go to **More****Download Queue** and cancel items in the queue or cancel all items by tapping on the overflow next to a series chapter or on the top right.
If you would like the change the order of the queue, tap and hold the = on the side of an item in the queue.
For more details on rooting your device, refer to [this guide](https://www.xda-developers.com/root/).
## Can you make it possible to store series on both internal storage and external SD-card?
## Series Pages in Device Photo Gallery
**Tachiyomi** typically prevents series pages in downloads from appearing in your device's photo gallery by default through a `.nomedia` file.
However, in some cases, this might not function as intended.
At the moment, no.
You could try using symlinks, but that requires having your device rooted.
Read more about rooting your device [here](https://www.xda-developers.com/root/)
## Why can I see series pages from my downloads 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 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 series, place the `.nomedia` file in the local folder.
A quick solution is to create the `.nomedia` file yourself, name it as such, and place it in your downloads folder. If the issue pertains to local series, put the `.nomedia` file in the respective local folder.

View File

@ -4,33 +4,24 @@ description: Frequently Asked Questions related to the Application.
---
# Application
Frequently Asked Questions related to the Application.
## What is Tachiyomi Preview?
## Tachiyomi Preview
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.
**Tachiyomi Preview** is a regularly updated beta version of the app.
It showcases potential upcoming features, but it's more prone to bugs and crashes.
If you are willing to use Tachiyomi Preview, be sure to turn on auto-backup to prevent losing your library due to potential bugs or crashes.
Ideal for users seeking the latest **Tachiyomi** experience, it's essential to [enable auto-backup](/docs/guides/backups#enabling-automatic-backups) to prevent library loss due to issues.
## Updating the application
## Automatic Updates Not Working
### How do I enable automatic updates?
Some Android skins (e.g., **MIUI**) aggressively save battery, potentially shutting down apps in the background.
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.
Whitelist **Tachiyomi** from your battery saver by going to **More → Settings -> Advanced** and tapping **Disable battery optimization**.
However, if you think you are on an outdated version, go to **More****About** and tap on **Check for updates**.
If unsuccessful, try [DontKillMyApp](https://dontkillmyapp.com/) for battery-saving options on your device and workarounds.
### Why are automatic updates not working?
## Uninstall Issues
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 **More****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.
## Uninstalling the application
### Why am I unable to 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.
On **Android 10**, a bug emerged preventing **Tachiyomi** uninstallation if a MicroSD card was present.
To resolve this, remove the MicroSD card from your device before uninstalling **Tachiyomi**.

View File

@ -1,59 +1,56 @@
---
title: Library
description: TBA
description: Frequently Asked Questions regarding the Library.
---
# Library
Frequently Asked Questions regarding the Library.
## How can I see how many chapters I have downloaded or unread?
## How Can I Monitor My Downloaded Chapters?
You can enable badges by navigating to **Library -> Filter** and clicking the **Display** tab.
Then, at the bottom, select **Download badges**.
Enable badges by going to Library → Filter → **Display** tab and then checking **Download badges** or **Unread badges** at the bottom.
## Why Does Global Update Skip Certain Entries?
The app's default behavior is to skip updates for entries that meet the following criteria:
## Why does global update skip some entries?
* Have unread chapters
* Haven't been initiated
* Carry a "**Completed**" status
By default, the app does not check for updates if an entry:
This strategy prevents unnecessary server traffic, which could lead to sources implementing measures against **Tachiyomi**.
To manage entries with infrequent or no updates, consider using categories and excluding them from updates.
* Has unread chapters
* Hasn't been started
* Has "Completed" status
We recommend sticking with the default settings and prioritizing unread chapters for reading.
This helps avoid unnecessary heavy traffic to sources to help ensure that they stay available.
If you have entries that get infrequent or no updates, you should consider using categories and excluding them from updates.
If you wish to disable the notification about skipped items, you can do so at **More -> Settings -> General -> Manage notifications** (doing so requires Android 8 or above).
We recommend to **keep the defaults as they are** and read your unread chapters first.
## Why Am I Warned About Large Bulk Updates and Downloads?
Excessive server queries and superfluous site interactions could trigger anti-**Tachiyomi** measures from sources. See the previous question for more context. Long-running update checks and downloads might also impact your device's battery life.
If you don't want to see the skipped items notification, you can disable it at More → Settings → General → **Manage notifications** (Android 8+).
To mitigate these concerns:
## Why does the app warn about large bulk updates and downloads?
* It's advisable to maintain the default settings.
* Try these tips if you still encounter the warning message:
* Use categories to segment your library (Reading, Plan to Read, Completed, etc.).
* Update only the Reading category by navigating to **More -> Settings -> Library -> Global update** and then tap **Categories**.
* If the warning persists, create a new category for infrequently updated entries (like monthly series or those on hiatus) and set global updates to target the more frequently updated reading category.
Excessive server queries and unnecessary site interaction may cause sources to employ anti-Tachiyomi tactics.
Also refer to the above question.
Long running update checks and downloading may also negatively impact your battery life.
## How Can I Ignore Duplicate Chapters?
Dealing with series translated by multiple groups that result in duplicate chapter releases?
Tips to reduce server load As mentioned above, it is **recommended to keep the defaults as they are**, but if you are still seeing this warning message, try the following suggestions:
Bookmark or mark as read the undesired chapters, then open the **Filter** menu, ensure you're on the **Filter** tab, then double-tap **Bookmarked** or single-tap **Unread**.
* Use categories (Reading, Plan to read and Completed, or anything else that segments your library).
* Update only the Reading category by going to More → Settings → Library → **Global update** then tap **Categories**.
* If the warning message still occurs, split your reading category down further by seperating entries in your library that are infrequently updated (such as monthly series or series that are on haitus) into a new category, then set global update to only update your more frequently updated reading category
This hides bookmarked or read chapters, enabling you to skip them as you read.
Ensure [Skip filtered chapters](/docs/guides/reader-settings#skip-filtered-chapters) is enabled at **More → Settings → Reader** under the section **Reading**.
## How do I ignore duplicate chapters?
Alternatively, migrate to a source without duplicates.
Refer to the [migration guide](/docs/guides/source-migration) for detailed instructions.
Sometimes, you find a series that is translated by more than one group.
Because of this, you get multiple releases for each chapter in the series.
There are several ways to skip the duplicate chapters:
## Why Are Some Cover Thumbnails Corrupted or Blank?
If cover thumbnails appear corrupted, blank, or broken, it's likely due to an incomplete download. Fix this by refreshing the covers in settings.
* Bookmark or mark as read the unwanted chapters, then tap on → **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 More → Settings → Reader → **Reading**.
* Migrate to another source that does not have duplicates.
* For more information on how to migrate a series, see the migration guide.
Refresh your covers at **More -> Settings -> Advanced** then tap **Refresh library covers**.
## Why are some cover thumbnails corrupted, white, showing a broken page, or wrong?
The thumbnail download likely did not complete correctly.
To fix this, refresh the covers in settings.
Refresh your covers by going to **More -> Settings -> Advanced** then pressing **Refresh library covers**.
## Why have some series chapters been marked as unread when I have not touched them?
The URLs of the series chapters have changed, so Tachiyomi detects the chapter(s) as new chapters.
## Why Have Some Series Chapters Been Marked as Unread?
If certain series chapters are marked as unread without your interaction, it could be due to changed URLs.
**Tachiyomi** detects these changes and interprets the chapters as new.

View File

@ -1,23 +1,26 @@
---
title: Reader
description: TBA
description: Frequently Asked Questions relating to the Reader.
---
# Reader
Frequently Asked Questions relating to the Reader.
## Why are some images not displayed?
## Unseen Images in Reader
Besides network-related problems, **Tachiyomi** may occasionally fail to recognize certain images.
To address this, simply exit and re-enter the reader, often resolving the issue.
Aside from network issues, sometimes Tachiyomi does not register the image as existing, exit, and re-enter the reader to fix this.
## Dual-Page Reader Implementation
Creating an effective dual-page reader that accommodates scanlator page inconsistencies and other complexities poses challenges.
Consequently, implementing this feature is unlikely at present.
## Will there ever be a dual-page reader option?
## Settings
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.
### Modifying Tapping Zones
For detailed instructions on changing tapping zones, please consult the guides section on the website [here](/docs/guides/reader-settings#tap-zones-pages).
---
### Reversing Tapping Direction
To reverse the direction of tapping for navigation, follow the instructions available [here](/docs/guides/reader-settings#invert-tap-zones-pages).
### How can I make Tachiyomi turn pages with the volume rocker?
### Can I reverse the tapping direction?
### Can I change the tapping zones?
Refer to the guides section of the site here.
Refer to here if you want to use your volume rocker to navigate pages.
### Volume Rocker Page Turning
For using the volume keys to navigate pages, refer to the instructions provided [here](/docs/guides/reader-settings#volume-keys).

View File

@ -1,30 +1,34 @@
---
title: Shizuku
description: TBA
description: Using Shizuku with Tachiyomi.
---
# Shizuku
Using **Shizuku** with **Tachiyomi**.
## What is Shizuku?
## Understanding Shizuku
**Shizuku** serves as an alternative method for installing and updating extensions in **Tachiyomi**.
Tachiyomi can use Shizuku as an alternate way to install and update extensions.
It accesses system APIs to install packages directly without user input.
Shizuku requires setup with ADB or root privileges.
Read more about it [here](https://shizuku.rikka.app/introduction/).
It taps into system APIs to directly install packages without requiring user interaction.
## Do I need Shizuku?
To get a detailed understanding of **Shizuku**, its purpose, and how it operates, refer to the information provided [here](https://shizuku.rikka.app/introduction/).
No, only use Shizuku if you want to avoid being prompted during extension installations.
## Is Shizuku Necessary?
No, **Shizuku** is not obligatory.
## How do I set Shizuku up?
It should be considered if you wish to bypass installation prompts during extension setup.
To learn how to set Shizuku up, go [here](https://shizuku.rikka.app/guide/setup/).
Once you have set it up, enable it in Tachiyomi by going to **More****Settings****Advanced****Installer**.
## Setting Up Shizuku
To set up **Shizuku**, follow the instructions [here](https://shizuku.rikka.app/guide/setup/).
## What is the difference between the installers?
After configuring it, activate **Shizuku** within **Tachiyomi** by navigating to **More -> Settings -> Advanced** then changing the **Installer** setting.
* **Legacy**: fallback method installer if the standard PackageInstaller has issues.
* This is the default for MIUI.
* **PackageInstaller**: The default installer.
* This has more features depending on the Android version, such as skipping user prompts on Android 12 when updating extensions.
* **Shizuku**: See above.
## Comparing Installers
Three installer options are available:
* **Legacy**: A fallback installer if the standard **PackageInstaller** faces complications.
> This is the default for **MIUI**.
* **PackageInstaller**: The primary installer option with additional features dependent on the Android version.
> For instance, it can bypass user prompts when updating extensions on **Android 12**.
* **Shizuku**: Refer to the above section for details on **Shizuku**'s functionality.
* **Private**: Installs directly to your device without passing as an application.

View File

@ -1,13 +1,14 @@
---
title: User interface
description: TBA
description: Frequently Asked Questions regarding the User Interface.
---
# User interface
Frequently Asked Questions regarding the User Interface.
## Can I change the app language?
## Can I Change the App Language?
No.
It was removed due to it causing small bugs everywhere in **Tachiyomi**.
Android does not provide a standard way of selecting a language that's not your device-language.
You can improve the quality of the translations in your language [here](https://hosted.weblate.org/projects/tachiyomi/) or change your system language.
Yes.
With the introduction of [Per-app language preferences](https://developer.android.com/guide/topics/resources/app-languages) in **Android 13**.
To enhance the translation quality in your preferred language, you can contribute [here](https://hosted.weblate.org/projects/tachiyomi/).