docs(troubleshooting): merge AntiBotException and ExtractionException into unified YouTube blocking section

Author: Priveetee

docs/fr/user-guide/common-issues.md

@@ -3,16 +3,28 @@
 
 ## Réseau et Restrictions YouTube
 
-### AntiBotException : "Connectez-vous pour prouver que vous n'êtes pas un robot"
-Il s'agit d'un blocage côté serveur de YouTube. Cela arrive quand votre adresse IP est signalée pour "comportement anormal" (trop de requêtes en peu de temps, souvent causé par le partage d'IP (NAT) ou l'import massif d'abonnements).
+### YouTube bloque ou échoue à charger les streams
+Ceci couvre deux erreurs liées qui ont toutes les deux pour origine YouTube qui restreint ou échoue à servir les données de stream à des clients anonymes :
+
+- `AntiBotException : Connectez-vous pour prouver que vous n'êtes pas un robot`
+- `ExtractionException : Error occurs when fetching the page. Try increase the loading timeout in Settings.`
+
+Bien que les messages d'erreur diffèrent, ils partagent des causes communes : votre IP signalée par YouTube, la limitation des requêtes anonymes (rate-limiting), un timeout réseau, ou une défaillance temporaire côté serveur YouTube.
 
 **Solutions :**
-1.  **Changez d'IP :** Passez du Wi-Fi aux données mobiles, ou redémarrez votre box pour obtenir une nouvelle IP dynamique.
-2.  **Utilisez un VPN :** Nous recommandons un service de qualité comme [Proton VPN](https://protonvpn.com/fr/).
+
+1.  **Réessayez la vidéo :** L'`ExtractionException` est souvent temporaire. Appuyer sur réessayer ou rouvrir la vidéo suffit à la résoudre.
+2.  **Augmentez le délai de chargement :** Allez dans `Paramètres > Contenu > Délai de chargement` et augmentez la valeur. Cela laisse plus de temps à PipePipe pour récupérer les métadonnées du stream avant d'abandonner.
+3.  **Changez d'IP :** Passez du Wi-Fi aux données mobiles, ou redémarrez votre box pour obtenir une nouvelle IP dynamique. Une IP signalée est la cause la plus fréquente de l'`AntiBotException`.
+4.  **Utilisez un VPN :** Nous recommandons un service de qualité comme [Proton VPN](https://protonvpn.com/fr/).
     *   *Note : Nous ne sommes pas affiliés à ce service ; cette recommandation est basée sur des tests de la communauté montrant sa grande fiabilité.*
-3.  **Changez de Région :** Si vous utilisez déjà un VPN et que l'erreur persiste, changez simplement de serveur pour un autre pays. Cela vous donnera une nouvelle IP non signalée.
-4.  **Orbot (Tor) :** Utiliser [Orbot](https://orbot.app/fr/) vous permet de basculer entre différents nœuds de sortie à travers le monde jusqu'à ce que le blocage soit levé.
-5.  **Connexion :** Se connecter à son compte YouTube dans PipePipe reste une méthode stable pour éviter cette exception si vous ne souhaitez pas utiliser de VPN.
+5.  **Changez de région VPN :** Si vous utilisez déjà un VPN et que l'erreur persiste, changez de serveur pour un autre pays afin d'obtenir une IP fraîche et non signalée.
+6.  **Orbot (Tor) :** Utiliser [Orbot](https://orbot.app/fr/) vous permet de basculer entre différents nœuds de sortie à travers le monde jusqu'à ce que le blocage soit levé.
+7.  **Connexion :** Se connecter à son compte YouTube dans PipePipe reste une méthode stable pour éviter ces deux exceptions si vous ne souhaitez pas utiliser de VPN.
+
+::: tip Anonyme vs. connecté
+YouTube limite et bloque les clients anonymes (non authentifiés) bien plus agressivement que les clients connectés. Si vous rencontrez régulièrement l'une ou l'autre de ces erreurs, se connecter est la solution la plus fiable sur le long terme.
+:::
 
 ## Lecture Vidéo : "La page doit être rechargée"
 

docs/user-guide/common-issues.md

@@ -2,16 +2,28 @@
 
 ## Network and YouTube Restrictions
 
-### AntiBotException: "Sign in to confirm you’re not a bot"
-This is a server-side block from YouTube. It happens when your IP address is flagged for "abnormal behavior" (too many requests in a short time, often caused by NAT or importing many subscriptions).
+### YouTube Blocking or Failing to Load Streams
+This covers two related errors that both stem from YouTube restricting or failing to serve stream data to anonymous clients:
+
+- `AntiBotException: Sign in to confirm you're not a bot`
+- `ExtractionException: Error occurs when fetching the page. Try increase the loading timeout in Settings.`
+
+While the error messages differ, they share common root causes: your IP being flagged by YouTube, rate-limiting of anonymous requests, network timeouts, or transient server-side failures on YouTube's end.
 
 **Solutions:**
-1.  **Change your IP:** Switch from Wi-Fi to mobile data, or restart your router to get a new dynamic IP.
-2.  **Use a VPN:** We recommend using a high-quality service like [Proton VPN](https://protonvpn.com/).
+
+1.  **Retry the video:** The `ExtractionException` is often transient. Simply tapping retry or reopening the video resolves it.
+2.  **Increase the loading timeout:** Go to `Settings > Content > Loading timeout` and increase the value. This gives PipePipe more time to fetch stream metadata before giving up.
+3.  **Change your IP:** Switch from Wi-Fi to mobile data, or restart your router to get a new dynamic IP. A flagged IP is the most common cause of the `AntiBotException`.
+4.  **Use a VPN:** We recommend a high-quality service like [Proton VPN](https://protonvpn.com/).
     *   *Note: We are not affiliated with this service; this recommendation is based on community tests showing its reliability.*
-3.  **Switch Region:** If you are using a VPN and still get the error, simply change the server to another country. This provides a new IP that is likely not flagged by YouTube.
-4.  **Orbot (Tor):** Using [Orbot](https://orbot.app/) allows you to rotate through different exit nodes across the world until the block is bypassed.
-5.  **Login:** Logging into your YouTube account within PipePipe remains a stable way to avoid this exception if you don't want to use a VPN.
+5.  **Switch VPN region:** If you are already on a VPN and still get the error, change server to another country for a fresh, unflagged IP.
+6.  **Orbot (Tor):** Using [Orbot](https://orbot.app/) lets you rotate through different exit nodes worldwide until the block is bypassed.
+7.  **Login:** Logging into your YouTube account within PipePipe remains a stable way to avoid both exceptions if you prefer not to use a VPN.
+
+::: tip Anonymous vs. logged-in
+YouTube throttles and blocks anonymous (unauthenticated) clients far more aggressively than logged-in ones. If you keep hitting either of these errors, logging in is the most reliable long-term fix.
+:::
 
 ## Video Playback: "The page needs to be reloaded"