FAQ

FAQs/FAQ_EN.md

@@ -0,0 +1,43 @@
+# FAQ (Frequently Asked Questions)
+
+[✓] 🇺🇸 English FAQ | [🇷🇺 ЧаВо на Русском](FAQ_RU.md)
+
+<details>
+  <summary>What iOS versions does YouTube Plus support?</summary>
+    <p>YouTube Plus supports iOS 14 and above. <strong>However</strong>, if you're sideloading it on a non-jailbroken device, you must also consider the YouTube app's compatibility with your iOS version. Below is a list of the latest supported YouTube versions per iOS:</p>
+    <li><strong>iOS 14</strong>: YouTube v19.20.2</li>
+    <li><strong>iOS 15</strong>: YouTube v20.21.6</li>
+    <li><strong>iOS 16+</strong>: Any version, as supported by YouTube</li>
+</details>
+<br>
+<details>
+  <summary>My iOS version is no longer supported by the latest YouTube app. What can I do?</summary>
+    <p>Here are some possible options:</p>
+    <li><a href="https://ios.cfw.guide/get-started/">Jailbreak your device</a>, install the latest supported YouTube version from the App Store, and <a href="http://dvntm0.github.io/#jb">install YouTube Plus as a tweak</a></li>
+    <li><a href="https://ios.cfw.guide/installing-trollstore/">Install TrollStore</a>, then <a href="https://github.com/Lessica/TrollFools/releases/">TrollFools</a>, install the latest supported YouTube version from the App Store, and inject <a href="https://github.com/dayanch96/YTLite/releases/">YouTube Plus</a> using TrollFools</li>
+    <li>Find a compatible IPA version online and <a href="../README.md#how-to-build-a-youtube-plus-app-using-github-actions">build a YouTube Plus app using Github actions</a></li>
+</details>
+<br>
+<details>
+  <summary>Cast stopped working on sideloaded YouTube Plus. What should I do?</summary>
+    <p>Until this issue is resolved, it is recommended to use YouTube version 20.14.1 or below.</p>
+</details>
+<br>
+<details>
+  <summary>When I try to play a video, I get <strong><em>Something went wrong. Refresh and try again later.</em></strong></summary>
+    <p>Before jumping to conclusions, let’s clarify a few things:</p>
+    <ol>
+      <li><strong>This is NOT</strong> caused by ad blocking</li>
+      <li><strong>This is NOT</strong> because your account was magically flagged</li>
+      <li><strong>This is NOT</strong> due to your account being secretly blacklisted</li>
+    </ol>
+    <br>
+    <p>The issue seems to lie somewhere in the sideloading process itself, even without any tweaks applied. It might be related to an invalid or missing VisitorID or VisitorData, as suggested <a href="https://github.com/pepeloni-away/userscripts/issues/6#issuecomment-2860641610">here</a>. This error has become more frequent due to YouTube’s stricter anti-download measures.</p>
+    <br>
+    <p><strong>Possible temporary workaround:</strong></p>
+    <ol>
+      <li>Sign out of your current account (or all accounts) completely: Go to the <em>You tab → Switch account → Manage accounts on this device → Remove from this device</em></li>
+      <li>Watch a few full-length videos without being signed in. Stay signed out for a few hours.</li>
+      <li>Sign back into the account that was having issues</li>
+    </ol>
+</details>

FAQs/FAQ_RU.md

@@ -0,0 +1,42 @@
+# ЧаВо (Часто задаваемые вопросы)
+
+[🇺🇸 English FAQ](FAQ_EN.md) | [✓] 🇷🇺 ЧаВо на Русском
+
+<details>
+  <summary>Какие версии iOS поддерживает YouTube Plus?</summary>
+  <p>YouTube Plus поддерживает iOS 14 и выше. <strong>Однако</strong>, если вы устанавливаете его сертификатом разработчика, нужно учитывать совместимость самой YouTube с вашей iOS. Вот список последних поддерживаемых версий YouTube для каждой iOS:</p>
+  <li><strong>iOS 14</strong>: YouTube v19.20.2</li>
+  <li><strong>iOS 15</strong>: YouTube v20.21.6</li>
+  <li><strong>iOS 16+</strong>: Любая версия, поддерживаемая YouTube</li>
+</details>
+<br>
+<details>
+  <summary>Моя версия iOS более не поддерживается последним YouTube-ом. Что делать?</summary>
+  <p>Вот возможные варианты:</p>
+  <li><a href="https://ios.cfw.guide/get-started/">Установить джейлбрейк</a>, установить поддерживаемую версию YouTube из App Store, затем <a href="http://dvntm0.github.io/#jb">установить YouTube Plus как твик</a></li>
+  <li><a href="https://ios.cfw.guide/installing-trollstore/">Установить TrollStore</a>, установить <a href="https://github.com/Lessica/TrollFools/releases/">TrollFools</a> через TrollStore, установить подходящую версию YouTube из App Store, затем «инжектнуть» <a href="https://github.com/dayanch96/YTLite/releases/">YouTube Plus</a> через TrollFools</li>
+  <li>Найти и скачать совместимую IPA-версию в интернете, затем <a href="../README.md#how-to-build-a-youtube-plus-app-using-github-actions">собрать YouTube Plus через GitHub Actions</a></li>
+</details>
+<br>
+<details>
+  <summary>Перестала работать функция трансляции на ТВ на сертификате разработчика. Что делать?</summary>
+  <p>Пока проблема не будет решена, рекомендуется использовать версию YouTube 20.14.1 или ниже.</p>
+</details>
+<br>
+<details>
+  <summary>При попытке воспроизведения видео появляется <strong><em>Произошла ошибка. Обновите страницу и попробуйте снова.</em></strong></summary>
+  <p>Прежде чем делать выводы, уточним несколько моментов:</p>
+  <ol>
+    <li><strong>Это НЕ</strong> из-за блокировщика рекламы</li>
+    <li><strong>Это НЕ</strong> потому что ваш аккаунт каким-то образом был помечен</li>
+    <li><strong>Это НЕ</strong> из-за того, что ваш аккаунт добавлен в загадочный чёрный список</li>
+  </ol>
+  <br>
+  <p>Проблема, скорее, кроется в самом процессе сайдлоадинга, даже «чистом» YouTube без твиков. <a href="https://github.com/pepeloni-away/userscripts/issues/6#issuecomment-2860641610">Тут</a> пишут, что причина в некорректных или отсутствующих VisitorID/VisitorData. Такая ошибка стала встречаться чаще из-за новых механизмов YouTube по борьбе с загрузчиками.</p>
+  <p><strong>Возможные временные решения:</strong></p>
+  <ol>
+    <li>Полностью выйдите из аккаунта (или всех аккаунтов): <em>Перейдите во вкладку «Вы» → Сменить аккаунт → Управление аккаунтами на этом устройстве → Удалить</em></li>
+    <li>Просмотрите несколько длинных видео без входа в аккаунт. Оставайтесь в разлогиненном состоянии несколько часов.</li>
+    <li>Заново войдите в аккаунт, на котором возникала проблема</li>
+  </ol>
+</details>

README.md

@@ -1,6 +1,16 @@
 # YouTube Plus (ex. YTLite)
 A flexible enhancer for YouTube on iOS, featuring over hundred customizable options.
 
+## Table of Contents
+- [Screenshots](#screenshots)
+- [Main Features](#main-features)
+- [FAQ](#faq)
+- [Reviews](#reviews)
+- [How to build a YouTube Plus app using GitHub Actions](#how-to-build-a-youtube-plus-app-using-github-actions)
+- [Supported YouTube Version](#supported-youtube-version)
+- [Tweak Integration Details](#tweak-integration-details)
+- [FAQ (Frequently Asked Questions)](#faq-frequently-asked-questions)
+
 ## Screenshots
 <table>
    <tr>
@@ -40,9 +50,11 @@ A flexible enhancer for YouTube on iOS, featuring over hundred customizable opti
 **YouTube Plus preferences can be found in the YouTube Settings**
 
 **All contributors are listed in the Contributors section**
-
 **Used open-source libraries are listed in the Open Source Libraries section**
 
+## FAQ
+- [🇺🇸 English FAQ](FAQs/FAQ_EN.md)
+- [🇷🇺 ЧаВо на Русском](FAQs/FAQ_RU.md)
 
 ## Reviews
 Review by [@qbap](https://github.com/qbap) on ONE Jailbreak: https://onejailbreak.com/blog/youtube-plus/