diff --git a/website/src/docs/faq/extensions.md b/website/src/docs/faq/extensions.md index 4a2d00b8..ed3e4702 100644 --- a/website/src/docs/faq/extensions.md +++ b/website/src/docs/faq/extensions.md @@ -1,120 +1,71 @@ --- title: Extensions - FAQ -description: Frequently Asked Questions related to Extensions. +description: Frequently Asked Questions about Extensions. --- # Extensions +Frequently Asked Questions about Extensions. -Frequently Asked Questions related to Extensions. +## Recommended Extensions and Sources -## General +**Tachiyomi** does not endorse or recommend any source, and there is no best extension. -### What are some recommended extensions? What source is the best? What is the replacement for source X? Where to read series Y? - -Tachiyomi does not endorse or recommend any 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. ::: info Disclaimer -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. +**Tachiyomi** isn't responsible for slow, down, missing chapters, or subpar image quality of sources as it doesn't host content. ::: ---- +## Scanlator Sources +Non-officially licensed series are translated by scanlators, often found on their websites or [MangaDex](https://mangadex.org/). +Compare with official sources like [MANGA Plus By SHUEISHA](https://mangaplus.shueisha.co.jp) or [VIZ Shonen Jump](https://www.viz.com/shonenjump). +Learn more in this [Wikipedia article](https://en.wikipedia.org/wiki/Scanlation). -### What are scanlator sources? - -Series 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 series. - -Learn more about scanlation in this **Wikipedia** [**article**](https://en.wikipedia.org/wiki/Scanlation). - -#### 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. -Make sure it is not on the removed extensions list [here](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/3475) first. +## Requesting New Extensions +[Open an issue](https://github.com/tachiyomiorg/tachiyomi-extensions/issues) on **GitHub** if not already there. +Check the removed [extensions list](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/3475) first. You can find the list of extensions to download [here](/extensions/) ---- - -### How do I allow third-party installations? - +## Enabling Third-Party Installations ::::tabs == Android 8.0 and higher -When installing your first extension and you are prompted that your device _is not allowed_ to install unknown apps from that source, follow the prompt to allow it. +When prompted while installing your first extension, allow unknown apps installation from that source. For newer Androids, enable per-app in **Install unknown apps**. -> In _newer_ versions of **Android**, you need to enable **Install unknown apps** on a per-app basis. - -== Android 7.1 and lower -When installing your first extension and you are prompted that your device _is not 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. +::: details Video guide - Recorded on Android 10 + +::: ::: tip Still got questions? -If you need more help regarding this, read [this](https://nerdschalk.com/how-to-allow-apps-installation-from-unknown-sources-on-android-9-pie/ "nerdschalk.com | How to allow apps installation from unknown sources on Android 9 Pie"). +If you need more help regarding this, read [this post](https://nerdschalk.com/how-to-allow-apps-installation-from-unknown-sources-on-android-9-pie/ "nerdschalk.com | How to allow apps installation from unknown sources on Android 9 Pie"). +::: +== Android 7.1 and lower +When prompted while installing your first extension, allow unknown apps installation from that source. For older Androids, enable globally in **Unknown sources**. + +::: details Video guide - Recorded on Android 7 + +::: :::: ---- +## Uninstalling an Extension +Uninstall extensions like regular apps: through device settings or in **Tachiyomi**. -### How do I uninstall an extension? - -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**. - -::: tip -To uninstall an extension from within **Tachiyomi**, go to → **Extensions** then tap **Uninstall** on the extension you want to remove. +::: tip Uninstalling an Extension +In **Tachiyomi**, uninstall an extension via **Browse -> Extensions**, then tap **Uninstall** on the chosen extension. ::: ## Removed Extensions +Extensions can disappear due to several reasons: -### 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 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), 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. - ---- - -### What extensions have been split? - -All of them have been split. - ---- - -### Why does my multisource extension show up as obsolete? - -The multisource extension is obsolete because it has been split. -The multisource extension has been removed from the repository. -It is not actually obsolete. - ---- - -### How do I move to a split extension? - -Install the extension that your series is from, and then uninstall the multisource extension. -If the series shows the source as a bunch of numbers, force close the app. -For known issues with split extensions, go to this [GitHub issue](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/5672). - ---- - -### Do I need to migrate? - -No, unless expressly stated, the internal ID of sources has not changed, so migration is unnecessary. - ---- - -### What if I uninstall the multisource extension before I install the singular extensions? - -See what extension IDs correspond to what extensions [here](https://pastebin.com/raw/QX2scdRT). +* Frequent website changes. +* Image scrambling. +* Scanlator removal request. +* Paywall implementation. +* Reverse engineering needs. +* Site shutdown. +* Find the list of removed extensions [here](https://github.com/tachiyomiorg/tachiyomi-extensions/issues/3475), excluding offline sites. diff --git a/website/src/public/docs/faq/extensions/unknown-sources-A10.light.webm b/website/src/public/docs/faq/extensions/unknown-sources-A10.light.webm new file mode 100644 index 00000000..2ce5fad3 Binary files /dev/null and b/website/src/public/docs/faq/extensions/unknown-sources-A10.light.webm differ diff --git a/website/src/public/docs/faq/extensions/unknown-sources-A7.light.webm b/website/src/public/docs/faq/extensions/unknown-sources-A7.light.webm new file mode 100644 index 00000000..f2690a52 Binary files /dev/null and b/website/src/public/docs/faq/extensions/unknown-sources-A7.light.webm differ