docs(troubleshooting): add YouTube Login Issues section explaining temporary disablement

Author: Priveetee

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

@@ -20,10 +20,36 @@ Bien que les messages d'erreur diffèrent, ils partagent des causes communes : v
     *   *Note : Nous ne sommes pas affiliés à ce service ; cette recommandation est basée sur des tests de la communauté montrant sa grande fiabilité.*
 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.
+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. Voir [Problèmes de Connexion YouTube](#problèmes-de-connexion-youtube) pour plus d'informations.
 
 ::: 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.
+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. Voir [Problèmes de Connexion YouTube](#problèmes-de-connexion-youtube) pour plus d'informations.
+:::
+
+## Problèmes de Connexion YouTube
+
+### Pourquoi la connexion peut être indisponible
+
+YouTube implémente fréquemment de nouveaux mécanismes de chiffrement dans son API pour prévenir l'accès non autorisé. À la fin 2025, YouTube a introduit un **chiffrement complexe dans son extracteur d'état connecté**, rendant impossible pour PipePipe d'extraire les flux vidéo lorsque les utilisateurs étaient connectés.
+
+**Contexte :** PipePipe n'utilise pas l'API officielle de YouTube (qui n'existe pas pour les applications tierces). Au lieu de cela, il extrait les données de l'API InnerTube de YouTube en effectuant une ingénierie inverse des interfaces web et mobiles de YouTube. Cette approche nécessite d'analyser les requêtes et les réponses que YouTube envoie aux clients légitimes.
+
+**Le Problème :** Ce n'était pas un problème graduel, c'était un changement cassant qui affectait tous les utilisateurs connectés simultanément, rendant la lecture vidéo impossible pour tous ceux qui essayaient d'utiliser la fonctionnalité de connexion.
+
+**Pourquoi la désactivation temporaire ?** Les développeurs avaient deux options :
+1. Garder la connexion activée et laisser les utilisateurs faire face à des lectures vidéo cassées (mauvaise expérience utilisateur)
+2. Désactiver temporairement la connexion le temps de trouver une solution de contournement
+
+Il a choisi l'option 2 pour éviter une cascade de rapports de crash et de frustration utilisateur.
+
+**Comment a-t-il été résolu ?** Les développeurs ont découvert une solution de contournement en collaborant avec d'autres communautés d'outils open-source YouTube. Cela a permis de réactiver la connexion dans les versions suivantes, bien qu'avec des défaillances d'analyse occasionnelles qui nécessitaient des redémarrages d'application.
+
+**En résumé :** Ce n'est pas une fonctionnalité en train d'être progressivement supprimée, c'est un jeu du chat et de la souris entre l'équipe de sécurité de YouTube (qui essaie de bloquer l'accès non autorisé) et les développeurs open source (qui essaient de maintenir la compatibilité). Quand YouTube change son chiffrement, PipePipe se casse temporairement jusqu'à ce qu'une nouvelle solution de contournement soit trouvée. Ce cycle se répète car YouTube continue d'évoluer ses protections.
+
+### Si la connexion est indisponible
+
+::: warning ⚠️ Connexion Temporairement Indisponible
+Si vous ne pouvez pas vous connecter, utilisez les méthodes alternatives de la section [Réseau et Restrictions YouTube](#réseau-et-restrictions-youtube) ci-dessus.
 :::
 
 ## Lecture Vidéo : "La page doit être rechargée"

docs/user-guide/common-issues.md

@@ -19,10 +19,36 @@ While the error messages differ, they share common root causes: your IP being fl
     *   *Note: We are not affiliated with this service; this recommendation is based on community tests showing its reliability.*
 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.
+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. See [YouTube Login Issues](#youtube-login-issues) for more information.
 
 ::: 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.
+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. See [YouTube Login Issues](#youtube-login-issues) for more information.
+:::
+
+## YouTube Login Issues
+
+### Why login may be unavailable
+
+YouTube frequently implements new encryption mechanisms in its API to prevent unauthorized access. In late 2025, YouTube introduced **complex encryption in its logged-in state extractor**, making it impossible for PipePipe to extract video streams when users were logged in.
+
+**Background:** PipePipe does not use YouTube's official API (which doesn't exist for third-party apps). Instead, it extracts data from YouTube's InnerTube API by reverse-engineering YouTube's web and mobile interfaces. This approach requires analyzing the requests and responses that YouTube sends to legitimate clients.
+
+**The Problem:** This was not a gradual issue, it was a breaking change that affected all logged-in users simultaneously, making video playback fail for everyone trying to use the login feature.
+
+**Why the temporary disable?** The developers had two options:
+1. Keep login enabled and let users face broken video playback (poor user experience)
+2. Temporarily disable login while finding a workaround
+
+They chose option 2 to prevent a cascade of crash reports and user frustration.
+
+**How was it resolved?** The developers discovered a workaround by collaborating with other open-source YouTube tool communities. This allowed login to be re-enabled in subsequent versions, though with occasional parsing failures that required app restarts.
+
+**Bottom line:** This isn't a feature being phased out, it's a cat and mouse game between YouTube's security team (trying to block unauthorized access) and open source developers (trying to maintain compatibility). When YouTube changes its encryption, PipePipe temporarily breaks until a new workaround is found. This cycle repeats as YouTube continuously evolves its protections.
+
+### If login is unavailable
+
+::: warning ⚠️ Login Temporarily Unavailable
+If you cannot log in, use the alternative methods from the [Network and YouTube Restrictions](#network-and-youtube-restrictions) section above.
 :::
 
 ## Video Playback: "The page needs to be reloaded"