Clarification

server/routes/download.js

@@ -16,90 +16,110 @@
   along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-const express = require("express");
-const router = express.Router();
-const { execFile } = require("child_process");
-const path = require("path");
-const fs = require("fs");
+const express = require("express");         // importe le framework Express
+const router = express.Router();            // crée un routeur Express pour modulariser les routes
+const { execFile } = require("child_process"); // permet d’exécuter un binaire externe sans passer par un shell
+const path = require("path");               // module Node.js pour gérer les chemins de fichiers
+const fs = require("fs");                   // module Node.js pour manipuler le système de fichiers
 
-const logger = require("../logger").logger;  // importe ton logger Winston
+const logger = require("../logger").logger; // récupère l'instance de logger Winston personnalisée
 
+// chemin vers l’exécutable yt-dlp packagé avec l’appli
 const ytDlpPath = path.join(__dirname, '../../yt-dlp.exe');
 
+// route POST sur la racine (ex: POST /download)
 router.post("/", (req, res) => {
   try {
+    // récupère les options envoyées depuis le frontend (via formulaire ou requête AJAX)
     const options = {
-      url: req.body.url,
-      audioOnly: req.body.audioOnly === "1",
-      quality: req.body.quality || "best",
-      subtitles: req.body.subs === "1",
+      url: req.body.url,                              // URL à télécharger
+      audioOnly: req.body.audioOnly === "1",          // conversion audio uniquement (mp3)
+      quality: req.body.quality || "best",            // qualité vidéo à télécharger
+      subtitles: req.body.subs === "1",               // récupérer les sous-titres anglais
     };
 
     if (!options.url) {
+      // si l’URL est absente, on log et on renvoie 400
       logger.warn("Requête POST /download sans URL");
       return res.status(400).send("❌ URL manquante !");
     }
 
-    // Récupérer le chemin Freedom Loader Output depuis app.locals
+    // on récupère le dossier de sortie depuis app.locals (défini ailleurs dans le serveur)
     const outputFolder = req.app.locals.outputFolder;
 
+    // s'il n'existe pas, on le crée automatiquement
     if (!fs.existsSync(outputFolder)) {
       fs.mkdirSync(outputFolder, { recursive: true });
       logger.info("Dossier Freedom Loader Output créé à la volée dans Téléchargements.");
     }
 
-    // Construire le template de sortie
+    // template du nom de fichier de sortie (ex: MonTitre.mp4 ou MonTitre.mp3)
     const outputTemplate = path.join(outputFolder, "%(title)s.%(ext)s");
 
-    // Construire les arguments pour execFile
+    // tableau d'arguments pour yt-dlp
     const args = [];
 
     if (options.audioOnly) {
+      // si audioOnly, on force extraction audio en mp3
       args.push("--extract-audio", "--audio-format", "mp3");
     }
 
     if (options.subtitles) {
+      // si l’utilisateur veut des sous-titres
       args.push("--write-subs", "--sub-lang", "en");
     }
 
+    // qualité souhaitée
     args.push("-f", options.quality);
+    // modèle de sortie
     args.push("-o", outputTemplate);
+    // enfin, l'URL à télécharger
     args.push(options.url);
 
+    // log de la commande complète pour debug
     logger.info(`Commande yt-dlp : ${ytDlpPath} ${args.join(" ")}`);
 
+    // exécution du binaire yt-dlp
     const child = execFile(ytDlpPath, args);
 
+    // gestion des logs stdout de yt-dlp
     child.stdout.on("data", (data) => {
       data.toString().split("\n").forEach(line => {
         if(line.trim()) logger.info(`[yt-dlp stdout] ${line.trim()}`);
       });
     });
 
+    // gestion des logs stderr de yt-dlp (les erreurs)
     child.stderr.on("data", (data) => {
       data.toString().split("\n").forEach(line => {
         if(line.trim()) logger.error(`[yt-dlp stderr] ${line.trim()}`);
       });
     });
 
+    // si une erreur système survient (par ex : yt-dlp.exe introuvable)
     child.on("error", (err) => {
       logger.error(`Erreur lancement yt-dlp : ${err.message}`);
       res.status(500).send(`❌ Erreur lors de l'exécution : ${err.message}`);
     });
 
+    // callback quand le processus se termine
     child.on("close", (code) => {
       logger.info(`yt-dlp terminé avec code de sortie : ${code}`);
       if(code === 0) {
+        // succès
         res.send("✅ Téléchargement terminé !");
       } else {
+        // yt-dlp a échoué
         res.status(500).send(`❌ yt-dlp a échoué avec le code : ${code}`);
       }
     });
 
   } catch (err) {
+    // en cas d'erreur JavaScript
     logger.error(`Erreur serveur dans /download : ${err.message}`);
     res.status(500).send(`Erreur serveur : ${err.message}`);
   }
 });
 
-module.exports = router;
+// on exporte ce routeur pour qu'il soit utilisé par l'app principale
+module.exports = router;

server/routes/info.js

@@ -16,32 +16,40 @@
   along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-const express = require("express");
-const router = express.Router();
-const { execFile } = require("child_process");
-const path = require("path");
+const express = require("express");        // importe Express
+const router = express.Router();           // crée un routeur Express indépendant
+const { execFile } = require("child_process"); // permet d’exécuter un programme externe
+const path = require("path");              // module pour gérer les chemins de fichiers
 
+// chemin vers le binaire yt-dlp embarqué
 const ytDlpPath = path.join(__dirname, "../../yt-dlp.exe");
 
+// route POST sur la racine de ce routeur
 router.post("/", (req, res) => {
-  const url = req.body.url;
-  if (!url) return res.status(400).send("❌ URL manquante");
+  const url = req.body.url;                // récupère l'URL depuis la requête POST
+  if (!url) return res.status(400).send("❌ URL manquante"); // validation simple
 
+  // exécute yt-dlp avec --dump-json pour récupérer les métadonnées de la vidéo
   execFile(ytDlpPath, ["--dump-json", url], (error, stdout, stderr) => {
     if (error) {
+      // gestion d’erreur : par exemple yt-dlp plante ou l’URL est invalide
       console.error("Erreur lors de l'exécution de yt-dlp :", error);
       console.error("stderr :", stderr);
       return res.status(500).send("❌ Impossible de récupérer les infos.");
     }
 
     try {
+      // on parse le JSON envoyé par yt-dlp
       const info = JSON.parse(stdout);
+      // on renvoie l’objet JSON directement au frontend
       res.json(info);
     } catch (e) {
+      // le JSON est mal formé
       console.error("Erreur lors du parsing JSON :", e);
       res.status(500).send("❌ JSON illisible.");
     }
   });
 });
 
+// on exporte le routeur pour être utilisé dans app.js ou ailleurs
 module.exports = router;