docs(guide): add detailed page for player settings (#11)

Priveetee · web-flow · commit 4b088e8bbe60 · 2025-08-17T21:07:12.000+02:00
diff --git a/docs/.vitepress/en.mts b/docs/.vitepress/en.mts
@@ -14,7 +14,7 @@ export const en = defineConfig({
         sidebar: {
             "/user-guide/": [
                 {
-                    text: "User Guide",
+                    text: "Getting Started",
                     items: [
                         {
                             text: "Introduction",
@@ -24,6 +24,11 @@ export const en = defineConfig({
                             text: "Installation",
                             link: "/user-guide/installation",
                         },
+                    ],
+                },
+                {
+                    text: "Core Concepts",
+                    items: [
                         {
                             text: "Core Features",
                             link: "/user-guide/core-features",
@@ -38,6 +43,15 @@ export const en = defineConfig({
                         },
                     ],
                 },
+                {
+                    text: "Settings",
+                    items: [
+                        {
+                            text: "Player Settings",
+                            link: "/user-guide/settings-player",
+                        },
+                    ],
+                },
             ],
             "/developer-guide/": [
                 {
diff --git a/docs/.vitepress/fr.mts b/docs/.vitepress/fr.mts
@@ -18,7 +18,7 @@ export const fr = defineConfig({
         sidebar: {
             "/fr/user-guide/": [
                 {
-                    text: "Guide de l'Utilisateur",
+                    text: "Pour Commencer",
                     items: [
                         {
                             text: "Introduction",
@@ -28,6 +28,11 @@ export const fr = defineConfig({
                             text: "Installation",
                             link: "/fr/user-guide/installation",
                         },
+                    ],
+                },
+                {
+                    text: "Concepts Clés",
+                    items: [
                         {
                             text: "Fonctionnalités Clés",
                             link: "/fr/user-guide/core-features",
@@ -42,6 +47,15 @@ export const fr = defineConfig({
                         },
                     ],
                 },
+                {
+                    text: "Paramètres",
+                    items: [
+                        {
+                            text: "Paramètres du Lecteur",
+                            link: "/fr/user-guide/settings-player",
+                        },
+                    ],
+                },
             ],
             "/fr/developer-guide/": [
                 {
@@ -57,7 +71,6 @@ export const fr = defineConfig({
         },
 
         search: {
-            provider: "local",
             options: {
                 translations: {
                     button: {
@@ -88,7 +101,7 @@ export const fr = defineConfig({
 
         footer: {
             message: "Publié sous la licence GNU AGPL v3.",
-            copyright: "Copyright © 2025-present PipePipe",
+            copyright: "Copyright © 2025-present Priveetee",
         },
 
         editLink: {
diff --git a/docs/fr/user-guide/settings-player.md b/docs/fr/user-guide/settings-player.md
@@ -0,0 +1,99 @@
+# Paramètres du Lecteur
+
+Cette section couvre tous les paramètres liés au lecteur vidéo et audio.
+
+## Résolution par défaut
+
+Définit la qualité vidéo préférée pour toutes les vidéos lues dans le lecteur principal.
+
+- **Options :** Meilleure résolution, 1080p60, 1080p, 720p60, 720p, 480p, 360p, 240p, 144p.
+- **Défaut :** 1080p60
+
+::: tip
+Choisir une résolution plus basse comme 720p peut aider à économiser des données mobiles et à réduire le temps de chargement sur des connexions lentes.
+:::
+
+## Résolution popup par défaut
+
+Définit la qualité vidéo préférée pour les vidéos lues dans le lecteur popup.
+
+- **Options :** Identiques à la résolution par défaut.
+- **Défaut :** 480p
+
+::: info
+Une résolution plus basse est souvent suffisante pour la petite fenêtre du popup et consomme moins de ressources.
+:::
+
+## Activer les formats avancés
+
+Permet au lecteur d'utiliser des codecs vidéo et audio modernes si votre appareil les prend en charge.
+
+- **Options :** VP9, AV1, HEVC, EC-3.
+
+::: warning
+Activer un format que votre appareil ne supporte pas peut entraîner un écran noir ou des plantages. WEBM ou AV1 sont nécessaires pour la lecture en 2k/4k sur YouTube.
+:::
+
+## Limiter la résolution lors de l'utilisation des données mobiles
+
+Bascule automatiquement vers une résolution inférieure lorsque vous n'êtes pas connecté au Wi-Fi pour économiser des données.
+
+- **Options :** Aucune limite, 1080p60, 1080p, 720p60, 720p, 480p, 360p, 240p, 144p.
+- **Défaut :** 480p
+
+## Nécessiter l'accent audio
+
+S'assure que PipePipe est la seule application à jouer du son. Lorsque cette option est activée, les autres applications (comme les lecteurs de musique) se mettront en pause au démarrage d'une vidéo PipePipe.
+
+- **Défaut :** Activé
+
+## Reprendre la lecture
+
+Reprend automatiquement la lecture après une interruption, comme un appel téléphonique.
+
+- **Défaut :** Activé
+
+## Toujours commencer la lecture depuis le début
+
+Désactive la fonction de reprise de lecture pour les vidéos que vous avez déjà commencées. Chaque vidéo commencera à 00:00.
+
+- **Défaut :** Désactivé
+
+## Mémoriser les propriétés du popup
+
+L'application se souviendra de la taille et de la position du lecteur popup de votre dernière session.
+
+- **Défaut :** Activé
+
+## Durée d'avance rapide/retour rapide
+
+Définit la durée de saut en avant ou en arrière lorsque vous double-tapez sur les côtés du lecteur.
+
+- **Options :** 5, 10, 15, 20, 25, 30 secondes.
+- **Défaut :** 10 secondes
+
+## Appuyer longuement pour accélérer la lecture
+
+Vous permet d'accélérer temporairement la vidéo en maintenant un appui long sur le lecteur.
+
+- **Options :** 0.1x à 5x, Désactiver.
+- **Défaut :** 5x
+
+## Minuterie de mise en veille
+
+Arrête automatiquement la lecture après une durée définie.
+
+- **Options :** 5, 10, 15, 20, 30 minutes, 1 heure.
+- **Défaut :** 1 heure
+
+## Paramètres des gestes
+
+Ouvre un sous-menu pour configurer les gestes de balayage du lecteur.
+
+## Paramètres des commentaires défilants
+
+Ouvre un sous-menu pour configurer les commentaires du chat en direct de style "danmaku" (défilants).
+
+## Sous-titres
+
+Ouvre un sous-menu pour configurer l'apparence des sous-titres.
diff --git a/docs/user-guide/settings-player.md b/docs/user-guide/settings-player.md
@@ -0,0 +1,99 @@
+# Player Settings
+
+This section covers all settings related to the video and audio player.
+
+## Default resolution
+
+Sets the preferred video quality for all videos played in the main player.
+
+- **Options:** Best resolution, 1080p60, 1080p, 720p60, 720p, 480p, 360p, 240p, 144p.
+- **Default:** 1080p60
+
+::: tip
+Choosing a lower resolution like 720p can help save mobile data and reduce buffering on slow connections.
+:::
+
+## Default popup resolution
+
+Sets the preferred video quality for videos played in the popup player.
+
+- **Options:** Same as default resolution.
+- **Default:** 480p
+
+::: info
+A lower resolution is often sufficient for the small popup window and consumes fewer resources.
+:::
+
+## Enable advanced formats
+
+Allows the player to use modern video and audio codecs if your device supports them.
+
+- **Options:** VP9, AV1, HEVC, EC-3.
+
+::: warning
+Enabling a format that your device does not support can lead to a black screen or crashes. WEBM or AV1 are required for 2k/4k playback on YouTube.
+:::
+
+## Limit resolution on mobile data
+
+Automatically switches to a lower resolution when you are not connected to Wi-Fi to save data.
+
+- **Options:** No limit, 1080p60, 1080p, 720p60, 720p, 480p, 360p, 240p, 144p.
+- **Default:** 480p
+
+## Request audio focus
+
+Ensures that PipePipe is the only app playing audio. When enabled, other apps (like music players) will pause when a PipePipe video starts.
+
+- **Default:** Enabled
+
+## Resume playback
+
+Automatically resumes playback after an interruption, such as a phone call.
+
+- **Default:** Enabled
+
+## Always start from the beginning
+
+Disables the "resume playback" feature for videos you've already started watching. Every video will start from 00:00.
+
+- **Default:** Disabled
+
+## Remember popup properties
+
+The app will remember the size and position of the popup player from your last session.
+
+- **Default:** Enabled
+
+## Fast forward/rewind duration
+
+Sets the amount of time to skip forward or backward when you double-tap the sides of the player.
+
+- **Options:** 5, 10, 15, 20, 25, 30 seconds.
+- **Default:** 10 seconds
+
+## Long press to speed up playback
+
+Allows you to temporarily speed up the video by long-pressing on the player.
+
+- **Options:** 0.1x to 5x, Disable.
+- **Default:** 5x
+
+## Sleep timer
+
+Automatically stops playback after a set amount of time.
+
+- **Options:** 5, 10, 15, 20, 30 minutes, 1 hour.
+- **Default:** 1 hour
+
+## Gesture settings
+
+Opens a sub-menu to configure the player's swipe gestures.
+
+## Scrolling comment settings
+
+Opens a sub-menu to configure the danmaku-style (scrolling) live chat comments.
+
+## Subtitles
+
+Opens a sub-menu to configure the appearance of subtitles.
