add: dark.zip and white.zip theme to the repo

Currently, themes are disabled and firefox notification too.

.github/ISSUE_TEMPLATE/question.md

@@ -9,8 +9,8 @@ assignees: 'MasterAcnolo'
 
 ## Pre-submission Checklist
 
-- [ ] I have checked the [FAQ](https://masteracnolo.github.io/FreedomLoader/pages/faq.html)
-- [ ] I have reviewed the [Wiki](https://masteracnolo.github.io/FreedomLoader/pages/wiki.html)
+- [ ] I have checked the [FAQ](https://masteracnolo.github.io/Freedom-Loader-Site/pages/faq)
+- [ ] I have reviewed the [Wiki](https://masteracnolo.github.io/Freedom-Loader-Site/pages/wiki)
 - [ ] I have searched existing issues
 
 ## Question

.gitignore

@@ -1,11 +1,23 @@
+# Dependencies
 /node_modules
-/downloads
+
+# Build Output Folder
 /dist
 /out
 
-/ressources/ffmpeg.exe
-/ressources/ffprobe.exe
-/ressources/deno.exe
+# Config JSON File. Create it and fill it if you want to have dev only settings
+config/config.dev.json
 
-logs/*.json
-logs/*.log
+# IDE
+/.idea
+/.vscode
+
+# Linux executable
+ffmpeg
+ffprobe
+deno
+
+# Windows Executable
+ffmpeg.exe
+ffprobe.exe
+deno.exe

CONTRIBUTING.md

@@ -105,7 +105,7 @@ Freedom-Loader/
 │   ├── controller/   # Business logic
 │   └── helpers/      # Utility functions
 ├── public/           # Frontend (HTML, CSS, JS)
-└── ressources/       # Binaries (yt-dlp, ffmpeg, etc.)
+└── resources/       # Binaries (yt-dlp, ffmpeg, etc.)
 ```
 
 ---
@@ -148,8 +148,8 @@ See [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) for details.
 
 ## Questions?
 
-- Check the [FAQ](https://masteracnolo.github.io/FreedomLoader/pages/faq.html)
-- Review the [Wiki](https://masteracnolo.github.io/FreedomLoader/pages/wiki.html)
+- Check the [FAQ](https://masteracnolo.github.io/Freedom-Loader-Site/faq)
+- Review the [Wiki](https://masteracnolo.github.io/Freedom-Loader-Site/wiki)
 - Open a [Question issue](https://github.com/MasterAcnolo/Freedom-Loader/issues/new/choose)
 
 ---

README.md

@@ -1,16 +1,17 @@
 <div align="center">
 
-  <a href="https://masteracnolo.github.io/FreedomLoader/"><img
+  <a href="https://masteracnolo.github.io/Freedom-Loader-Site/"><img
     src="./build/banner.png"
     alt="Banner"
     style="width: 50%;"/></a>
 
 ### **A clean, open-source multimedia downloader for Windows**
 
-[![Release](https://img.shields.io/badge/Release-1.4.6-blue?style=for-the-badge)](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+[![Release](https://img.shields.io/badge/Release-1.5.1-blue?style=for-the-badge)](https://github.com/MasterAcnolo/Freedom-Loader/releases)
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-red.svg?style=for-the-badge)](https://www.gnu.org/licenses/gpl-3.0)
-[![Website](https://img.shields.io/badge/Website-Visit-404040?style=for-the-badge)](https://masteracnolo.github.io/FreedomLoader/)
-  <a href="https://www.firefox.com/fr/?utm_campaign=SET_DEFAULT_BROWSER"><img src="https://img.shields.io/badge/Require Firefox-E66000?style=for-the-badge&logo=Firefox-Browser&logoColor=white"></a>
+[![Website](https://img.shields.io/badge/Website-Visit-404040?style=for-the-badge)](https://masteracnolo.github.io/Freedom-Loader-Site/)
+[![Workshop](https://img.shields.io/badge/Worshop-Visit-0E05A1?style=for-the-badge)](https://masteracnolo.github.io/Freedom-Loader-Workshop/)
+<a href="https://www.firefox.com/fr/?utm_campaign=SET_DEFAULT_BROWSER"><img src="https://img.shields.io/badge/Require Firefox-E66000?style=for-the-badge&logo=Firefox-Browser&logoColor=white"></a>
 
 </div>
 
@@ -22,6 +23,11 @@ Freedom Loader is a desktop application built with Electron that provides a stra
 
 The primary goal is to make media downloading accessible to users who want offline access to their favorite content, particularly in situations where internet connectivity is unreliable or unavailable.
 
+### See related repo:
+
+- **[Website](https://masteracnolo.github.io/Freedom-Loader-Site/)** - Official project website and documentation
+- **[Workshop](https://github.com/MasterAcnolo/Freedom-Loader-Workshop)** - Theme creation tool and theme browser
+
 ## Table of Contents
 
 - [Features](#features)
@@ -30,10 +36,12 @@ The primary goal is to make media downloading accessible to users who want offli
 - [Preview](#preview)
 - [Configuration](#configuration)
 - [Project Structure](#project-structure)
+- [Theme Workshop](#Theme-Workshop)
 - [Technology Stack](#technology-stack)
 - [Development](#development)
 - [Roadmap](#roadmap)
 - [Contributing](#contributing)
+- [Submitting a community theme](#Submitting-a-community-theme)
 - [Support](#support)
 - [License](#license)
 
@@ -53,7 +61,9 @@ The primary goal is to make media downloading accessible to users who want offli
 ### User Interface
 
 - **Custom window controls** - Frameless window with custom top bar (optional)
-- **Theme system** - Multiple pre-built themes with dynamic switching
+- **Custom themes** — ZIP-based theme system with live preview
+- **Theme Workshop** — web-based theme creator and browser
+- **Toast notifications** — in-app feedback system
 - **Real-time progress tracking** - Live download progress bar with network speed indicator
 - **Server-Sent Events (SSE)** - Non-blocking progress updates via event streaming
 - **Settings panel** - In-app configuration interface with live updates
@@ -70,6 +80,9 @@ The primary goal is to make media downloading accessible to users who want offli
 - **Rate limiting** - Express-based request throttling to prevent server overload
 - **Graceful shutdown** - Proper cleanup of servers, logs, and RPC connections
 - **System notifications** - Windows notifications on download completion (clickable to open folder)
+- **Splash screen** — animated loading screen on startup
+- **Stop download** — ability to cancel in-progress downloads
+- **Playlist folders** — dedicated folder creation per playlist
 
 ## Installation
 
@@ -152,7 +165,7 @@ Freedom Loader can be configured either through the settings panel in the UI or
 
 ### Configuration File Location
 ```
-C:\Users\[USERNAME]\AppData\Roaming\FreedomLoader\config.json
+%APPDATA%\Freedom Loader\config.json
 ```
 
 ### Available Options
@@ -166,11 +179,14 @@ C:\Users\[USERNAME]\AppData\Roaming\FreedomLoader\config.json
   "addMetadata": true,
   "verboseLogs": false,
   "autoDownloadPlaylist": true,
+  "createPlaylistFolders": true,
   "customCodec": "h264",
   "logSystem": true,
   "outputTitleCheck": true,
   "downloadSystem": true,
-  "notifySystem": true
+  "notifySystem": true,
+  "enableHardwareAcceleration": true,
+  "theme": "dark" 
 }
 ```
 
@@ -186,11 +202,14 @@ C:\Users\[USERNAME]\AppData\Roaming\FreedomLoader\config.json
 | `addMetadata` | boolean | `true` | Add metadata tags to downloaded files |
 | `verboseLogs` | boolean | `false` | Enable detailed logging for debugging |
 | `autoDownloadPlaylist` | boolean | `true` | Automatically download entire playlists |
+| `createPlaylistFolders` | boolean | `true` | Automatically create a folder for a playlist |
 | `customCodec` | string | `"h264"` | Video codec for encoding (supported: h264, h265, vp9, av1) |
 | `logSystem` | boolean | `true` | Enable application logging |
 | `outputTitleCheck` | boolean | `true` | Verify output file titles |
 | `downloadSystem` | boolean | `true` | Enable download system |
 | `notifySystem` | boolean | `true` | Enable system notifications |
+| `enableHardwareAcceleration` | boolean | `true` | Enable Hardware Acceleration |
+| `theme` | string | `dark` | Current Theme Name |
 
 ### Supported Codecs
 
@@ -209,19 +228,88 @@ C:\Users\[USERNAME]\AppData\Roaming\FreedomLoader\config.json
 
 ```
 Freedom-Loader/
+├── app/                     # Electron main process modules
+│   ├── autoUpdater.js
+│   ├── dependencyCheck.js
+│   ├── discordRPC.js
+│   ├── ipcHandlers.js
+│   ├── pathValidator.js
+│   ├── splashManager.js
+│   ├── themeManager.js
+│   ├── windowManager.js
+│   └── ytDlpUpdater.js
 ├── build/                   # Build resources and assets
 ├── config/                  # Configuration files
-├── public/                  # Frontend assets (HTML, CSS, JavaScript)
-├── ressources/             # Internal resources (icons, binaries)
-├── server/                 # Express server code
-│   ├── routes/            # API route handlers
-│   ├── services/          # Business logic
-│   └── utils/             # Server utilities
-├── .github/                # GitHub configuration and workflows
-├── main.js                 # Electron main process
-├── preload.js             # Electron preload script
-├── config.js              # Global application configuration
-└── package.json           # Dependencies and npm scripts
+│   ├── config.default.json
+│   └── config.dev.json
+├── public/                  # Frontend assets and UI
+│   ├── index.html
+│   ├── splash.html
+│   ├── assets/
+│   │   ├── icon/            # Application icons
+│   │   └── logo/            # Logo assets
+│   ├── script/              # Frontend JavaScript modules
+│   │   ├── appVersion.js
+│   │   ├── clipboardPaste.js
+│   │   ├── custompath.js
+│   │   ├── customthemes.js
+│   │   ├── downloadstatus.js
+│   │   ├── fetchinfo.js
+│   │   ├── progressBar.js
+│   │   ├── settingsPanel.js
+│   │   ├── toast.js
+│   │   └── topbar.js
+│   └── styles/              # CSS stylesheets
+│       ├── styles.css
+│       ├── variables.css
+│       ├── components/      # Component-specific styles
+│       │   ├── checkbox.css
+│       │   ├── editpathbutton.css
+│       │   ├── loader.css
+│       │   ├── progressBar.css
+│       │   └── toast.css
+│       └── layout/          # Layout styles
+│           ├── container.css
+│           ├── form.css
+│           ├── header.css
+│           ├── settingsPanel.css
+│           ├── topbar.css
+│           └── videoinfo.css
+├── resources/              # Internal resources (binaries)
+├── server/                  # Express backend server
+│   ├── logger.js
+│   ├── server.js
+│   ├── controller/          # Request handlers
+│   │   ├── download.controller.js
+│   │   └── info.controller.js
+│   ├── helpers/             # Utility functions
+│   │   ├── buildArgs.helpers.js
+│   │   ├── getBrowser.helpers.js
+│   │   ├── notify.helpers.js
+│   │   ├── parseInfo.helpers.js
+│   │   ├── path.helpers.js
+│   │   ├── rateLimit.helpers.js
+│   │   └── validation.helpers.js
+│   ├── routes/              # API route definitions
+│   │   ├── download.route.js
+│   │   └── info.route.js
+│   └── services/            # Business logic layer
+│       ├── download.services.js
+│       └── info.services.js
+├── theme/                   # Theme system
+│   ├── template.theme.json  # Theme template
+│   ├── Dark/                # Default dark theme
+│   │   └── dark.theme.json
+│   └── Light/               # Default light theme
+│       └── light.theme.json
+├── main.js                  # Electron main process entry point
+├── preload.js               # Electron preload script (IPC bridge)
+├── config.js                # Global configuration loader
+├── package.json             # Project metadata and dependencies
+├── CODE_OF_CONDUCT.md       # Community guidelines
+├── CONTRIBUTING.md          # Contribution guidelines
+├── LICENSE                  # GPLv3 license
+└── README.md                # This file
 ```
 
 ### Architecture Overview
@@ -230,10 +318,25 @@ Freedom Loader uses a client-server architecture within a single Electron applic
 
 - **Frontend**: HTML/CSS/JavaScript served via Electron's renderer process
 - **Backend**: Express.js server running locally for download management
+- **App modules**: Electron-specific logic (window, IPC, updates, RPC) isolated in `app/`
 - **IPC Bridge**: Secure communication via Electron's preload script
 - **Logging**: Winston-based structured logging with file rotation
 - **Updates**: Automatic checking and installation via electron-updater
 
+## Theme Workshop
+
+Freedom Loader includes a web-based theme creator available at [Freedom Loader Workshop](https://masteracnolo.github.io/Freedom-Loader-Workshop/).
+
+- Create custom themes with a live preview of the actual UI
+- Browse and download community themes
+- Export themes as `.zip` files ready to drop into the `theme/` folder
+- Supports background images, custom colors for every UI element
+
+### Installing a custom theme
+1. Download a `.zip` theme file
+2. Drop it in the `theme/` folder of your Freedom Loader installation
+3. Restart the app — your theme appears in the settings panel
+
 ## Technology Stack
 
 ### Core Technologies
@@ -283,7 +386,7 @@ npm run build
 This project relies on several external binaries.  
 Some of them are **not included** in the public repository and must be added manually.
 
-You must download the required binaries and place them in the `ressources` folder, using the exact filenames listed below.
+You must download the required binaries and place them in the `resources` folder, using the exact filenames listed below.
 
 #### Required binaries
 
@@ -304,7 +407,7 @@ You must download the required binaries and place them in the `ressources` folde
 Final folder structure:
 
 ```
-ressources/
+resources/
 ├── deno.exe
 ├── ffmpeg.exe
 ├── ffprobe.exe
@@ -324,39 +427,17 @@ ressources/
 
 ## Roadmap
 
-### Completed
-
-- [x] ~~Website and documentation~~
-- [x] ~~Automatic YT-DLP updates~~
-- [x] ~~Automatic application updates~~
-- [x] ~~Enhanced download status display~~
-- [x] ~~Video chapter extraction~~
-- [x] ~~Custom output path selection~~
-- [x] ~~Custom codec selection~~
-- [x] ~~Settings Panel with toggle switch for features.~~
-
-### In Progress
-
-- [ ] Additional format support (WebM, OGG, etc.)
-- [ ] Refactoring and cleaning the code base.
-- [ ] Chrome/Edge cookie support
-- [ ] Improved multi-site support
-
-### Planned
-
-- [ ] Subtitle download and embedding
-- [ ] Multiple language support
-- [ ] Partial video downloads
-- [ ] Custom file naming patterns
-- [ ] Parallel downloads
-- [ ] Automatic sponsor detection (SponsorBlock integration)
-- [ ] Download history
-- [ ] Linux version
+See the most recent Roadmap [Here](https://masteracnolo.github.io/Freedom-Loader-Site/Roadmap).
 
 ## Contributing
 
 Contributions are welcome and appreciated. This project benefits from community involvement.
 
+## Submitting a community theme
+
+Want your theme featured in the Workshop? Please **do not open an issue on this repository** for theme submissions.  
+Head over to the [Freedom Loader Workshop repository](https://github.com/MasterAcnolo/Freedom-Loader-Workshop) and open an issue there with your theme files, preview screenshots, and description.
+
 ### Bug Reports
 
 Use the GitHub Issues system and include:
@@ -408,6 +489,7 @@ You are free to use, modify, and redistribute this software under the terms of t
 - [Electron](https://www.electronjs.org/) for the desktop application framework
 - The open-source community for continuous support and contributions
 - [@SpicyFire21](https://github.com/SpicyFire21) to be the spiciest one
+- Zakaria for the website icon 
 - Jacques Chirac to love Apples
 - All users who test, report issues, and help improve the application
 
@@ -417,6 +499,6 @@ You are free to use, modify, and redistribute this software under the terms of t
 
 **Freedom Loader** - Put freedom in your downloads
 
-[Website](https://masteracnolo.github.io/FreedomLoader/) • [Download](https://github.com/MasterAcnolo/Freedom-Loader/releases) • [Documentation](https://masteracnolo.github.io/FreedomLoader/pages/wiki.html) • [Report Bug](https://github.com/MasterAcnolo/Freedom-Loader/issues)
+[Website](https://masteracnolo.github.io/Freedom-Loader-Site/) • [Download](https://github.com/MasterAcnolo/Freedom-Loader/releases) • [Documentation](https://masteracnolo.github.io/Freedom-Loader-Site/wiki) • [Report Bug](https://github.com/MasterAcnolo/Freedom-Loader/issues)
 
-</div>
+</div>

SECURITY.md

@@ -5,7 +5,7 @@
 We actively maintain and provide security updates for the following versions of Freedom Loader:
 
 | Version | Supported          |
-| ------- | ------------------ |
+|---------|--------------------|
 | 1.4.x   | :white_check_mark: |
 | 1.3.x   | :white_check_mark: |
 | < 1.3.0 | :x:                |

app/autoUpdater.js

@@ -0,0 +1,140 @@
+/**
+ * Electron auto-update system using electron-updater.
+ *
+ * Handles:
+ * - update detection
+ * - user confirmation dialogs
+ * - download progress streaming to renderer
+ * - application restart and installation
+ */
+
+const { autoUpdater } = require("electron-updater");
+const { dialog } = require("electron");
+const { logger } = require("../server/logger");
+
+/**
+ * Configures autoUpdater behavior:
+ * - disables automatic download
+ * - disables automatic installation on quit
+ * (manual user-controlled update flow)
+ */
+autoUpdater.autoDownload = false;
+autoUpdater.autoInstallOnAppQuit = false;
+
+/**
+ * Initializes application auto-update lifecycle.
+ *
+ * Registers update event listeners and binds them to:
+ * - UI dialogs (Electron dialog)
+ * - renderer communication (webContents)
+ * - download/install flow control
+ *
+ * @param {BrowserWindow} mainWindow - main Electron window instance
+ */
+function initAutoUpdater(mainWindow) {
+
+  /**
+   * Triggered when a new version is detected.
+   * Prompts user to install or defer update.
+   */
+  autoUpdater.on("update-available", async (info) => {
+    logger.info(`Update available: ${info.version}`);
+
+    const { response } = await dialog.showMessageBox(mainWindow, {
+      type: "info",
+      title: "Update Available",
+      message: `Version ${info.version} is available.`,
+      detail: "Would you like to download and install it now?",
+      buttons: ["Install Update", "Maybe Later"],
+      defaultId: 0,
+      cancelId: 1,
+    });
+
+    if (response === 0) {
+      await autoUpdater.downloadUpdate();
+    } else {
+      mainWindow?.webContents.executeJavaScript(
+        `window.showUpdateBadge && window.showUpdateBadge("${info.version}")`
+      );
+    }
+  });
+
+  /**
+   * Streams update download progress to renderer process.
+   * Used to update UI progress bar and status indicators.
+   */
+  autoUpdater.on("download-progress", (progress) => {
+    logger.info(`Download progress: ${Math.round(progress.percent)}%`);
+    mainWindow?.webContents.send("update-progress", {
+      percent: Math.round(progress.percent),
+      speed: progress.bytesPerSecond,
+    });
+  });
+
+  /**
+   * Triggered when update has been fully downloaded.
+   * Prompts user to restart application and install update.
+   */
+  autoUpdater.on("update-downloaded", async (info) => {
+    logger.info(`Update downloaded: ${info.version}`);
+
+    const { response } = await dialog.showMessageBox(mainWindow, {
+      type: "info",
+      title: "Update Ready",
+      message: `Version ${info.version} has been downloaded.`,
+      detail: "The application will restart to apply the update.",
+      buttons: ["Install Now", "Later"],
+      defaultId: 0,
+      cancelId: 1,
+    });
+
+    if (response === 0) autoUpdater.quitAndInstall();
+  });
+
+  /**
+   * Handles update system errors.
+   * Logs failure and displays an error dialog to user.
+   */
+  autoUpdater.on("error", (err) => {
+    logger.error("Auto update error:", err.message);
+    dialog.showErrorBox("Update Error", err.message);
+  });
+
+  checkForUpdates();
+}
+
+/**
+ * Manually triggers update check on startup.
+ * Separated from init for reusability and testability.
+ */
+async function checkForUpdates() {
+
+  if (!require("electron").app.isPackaged) return ;
+
+  try {
+    await autoUpdater.checkForUpdates();
+  } catch (err) {
+    logger.error("Update check failed:", err.message);
+  }
+}
+
+/**
+ * Manually triggers update download.
+ * Used when user accepts update prompt.
+ */
+async function downloadUpdate() {
+  try {
+    await autoUpdater.downloadUpdate();
+  } catch (err) {
+    logger.error("Download failed:", err.message);
+  }
+}
+
+/**
+ * Immediately quits application and installs downloaded update.
+ */
+function installUpdate() {
+  autoUpdater.quitAndInstall();
+}
+
+module.exports = { initAutoUpdater, downloadUpdate, installUpdate };

app/dependencyCheck.js

@@ -0,0 +1,67 @@
+const fs = require("fs");
+const { app, dialog } = require("electron");
+const { logger } = require("../server/logger");
+
+/**
+ * Verifies that all required native binaries exist before the app starts.
+ *
+ * This includes:
+ * - yt-dlp (download engine)
+ * - ffmpeg (media processing)
+ * - ffprobe (media inspection)
+ * - deno (JS runtime used by yt-dlp hooks)
+ *
+ * If any dependency is missing:
+ * - logs the error
+ * - shows a blocking Electron error dialog
+ * - exits the application
+ *
+ * @returns {boolean} true if all dependencies are present, false otherwise
+ */
+function checkNativeDependencies() {
+  /**
+   * Native dependency paths are resolved at runtime from the server helpers.
+   * This ensures correct resolution in both dev and packaged builds.
+   */
+  const { binaryPaths } = require("../server/helpers/path.helpers");
+
+  const isWindows = process.platform === "win32";
+
+  const addExe = isWindows ? ".exe" : "";
+
+  /**
+   * List of required external executables used by the application runtime.
+   * Each entry defines a binary name and its resolved absolute path.
+   */
+  const deps = [
+    { name: `yt-dlp${addExe}`,  path: binaryPaths.ytDlp },
+    { name: `ffmpeg${addExe}`,  path: binaryPaths.ffmpeg },
+    { name: `ffprobe${addExe}`, path: binaryPaths.ffprobe },
+    { name: `deno${addExe}`,    path: binaryPaths.deno },
+  ];
+
+  const missing = deps.filter(d => !fs.existsSync(d.path));
+  if (missing.length === 0) return true;
+
+  /**
+   * Human-readable list of missing binaries for logging and user dialog display.
+   */
+  const list = missing.map(d => d.name).join(", ");
+  logger.error(`Missing dependencies: ${list}`);
+
+  /**
+   * Defers error dialog until Electron app is fully initialized.
+   * Required to safely display modal dialogs before quit.
+   */
+  app.whenReady().then(() => {
+    dialog.showErrorBox(
+      "Missing dependencies",
+      `The following files are missing in the 'resources' folder:\n${list}\n\nThe application will now exit. Try to reinstall.`
+    );
+    app.quit();
+  });
+
+  return false;
+}
+
+module.exports = { checkNativeDependencies };

app/discordRPC.js

@@ -0,0 +1,87 @@
+const config = require('../config');
+const RPC = require("discord-rpc");
+const { logger } = require("../server/logger");
+
+/**
+ * Discord Application Client ID used to authenticate the RPC connection.
+ * Comes from the application configuration.
+ */
+const clientId = `${config.DiscordRPCID}`;
+
+/**
+ * Discord RPC client instance using IPC transport.
+ * Maintains a persistent connection with Discord desktop client.
+ */
+const rpc = new RPC.Client({ transport: "ipc" });
+
+/**
+ * Optional interval reference used for future RPC refresh logic.
+ * Currently reserved for potential periodic activity updates.
+ */
+let intervalId;
+
+/**
+ * Initializes Discord Rich Presence (RPC) connection.
+ *
+ * Responsibilities:
+ * - Connect to Discord via IPC transport
+ * - Set application presence (title, state, timestamps, assets)
+ * - Handle connection errors gracefully via logger
+ *
+ * Triggered once during application startup.
+ */
+function startRPC() {
+
+  /**
+   * Rich Presence payload describing current application state
+   * shown in Discord user profile.
+   */
+  rpc.on("ready", () => {
+    const presence = {
+      largeImageKey: "icon",
+      smallImageKey: "acnolo_pfp",
+      smallImageText: "By MasterAcnolo",
+      startTimestamp: new Date(),
+      details: `Open Source Download Tools - ${config.version}`,
+      state: "masteracnolo.github.io/FreedomLoader",
+    };
+    rpc.clearActivity()
+    rpc.setActivity(presence);
+
+  });
+
+  rpc.login({ clientId }).catch(err => {
+    logger.error("Unable to connect to the RPC:", err);
+  });
+}
+
+/**
+ * Gracefully stops Discord Rich Presence connection.
+ *
+ * Responsibilities:
+ * - Clear any running intervals
+ * - Remove current activity from Discord
+ * - Destroy RPC transport connection
+ * - Handle cleanup errors safely
+ */
+async function stopRPC(){
+    try {
+      if (intervalId) clearInterval(intervalId);
+
+      /**
+       * Ensures RPC connection exists before attempting cleanup.
+       */
+      if (rpc && rpc.transport) {
+        await rpc.clearActivity()
+        await rpc.destroy();
+      } else{
+        logger.error("Not Able to close RPC")
+      }
+      
+    } catch (err) {
+      logger.error("Error while closing the RPC:", err);
+    }
+  }
+
+
+module.exports = { startRPC, stopRPC};

app/ipcHandlers.js

@@ -0,0 +1,233 @@
+/**
+ * Electron IPC main process registry.
+ *
+ * Centralizes all IPC channels exposed to renderer process:
+ * - Application info (version, features)
+ * - Window controls (topbar actions)
+ * - File system interactions (theme, config, download paths)
+ * - UI state synchronization (progress bar)
+ *
+ * Acts as the bridge between renderer and privileged Node/Electron APIs.
+ */
+
+const { ipcMain, dialog, shell } = require("electron");
+const fs = require("fs");
+const { logger, logDir } = require("../server/logger");
+const { configFeatures, featuresPath } = require("../config");
+const { getThemes, reloadThemes } = require("./themeManager");
+const config = require("../config");
+const { validateDownloadPath, getDefaultDownloadPath } = require("./pathValidator");
+const { userThemesPath } = require("../server/helpers/path.helpers");
+
+/**
+ * Security whitelist for feature flags that can be modified at runtime.
+ *
+ * Prevents unauthorized or unexpected configuration keys from being persisted.
+ * Acts as a basic validation layer for IPC "set-feature".
+ */
+const FEATURE_WHITELIST = new Set([
+  "autoUpdate",
+  "discordRPC",
+  "customTopBar",
+  "autoCheckInfo",
+  "addThumbnail",
+  "addMetadata",
+  "verboseLogs",
+  "autoDownloadPlaylist",
+  "customCodec",
+  "theme",
+  "createPlaylistFolders",
+  "notifySystem",
+  "enableHardwareAcceleration"
+]);
+
+/**
+ * Absolute path to the configuration file storing feature flags.
+ */
+const configFolderPath = featuresPath;
+
+/**
+ * Directory containing user-installed themes.
+ */
+const themeFolderPath = userThemesPath;
+
+/**
+ * Registers all IPC handlers and event listeners for Electron main process.
+ *
+ * This function wires renderer → main communication channels:
+ * - synchronous queries (handle)
+ * - fire-and-forget events (on)
+ *
+ * @param {Function} getMainWindow - Function returning current BrowserWindow instance
+ */
+function registerIpcHandlers(getMainWindow) {
+    
+  /**
+   * Returns application version from config.
+   */
+  ipcMain.handle("version", () => config.version);
+
+  /**
+   * Returns runtime feature configuration object.
+   */
+  ipcMain.handle("features", () => configFeatures);
+
+  /**
+   * Opens native folder selection dialog and validates selected path.
+   *
+   * Ensures:
+   * - user cancellation is handled safely
+   * - selected path is validated against security rules
+   * - unsafe directories are rejected
+   */
+  ipcMain.handle("select-download-folder", async () => {
+    const result = await dialog.showOpenDialog({ properties: ["openDirectory"] });
+    if (result.canceled) {
+      logger.info("Folder selection cancelled by user");
+      return null;
+    }
+    try {
+      const validated = validateDownloadPath(result.filePaths[0]);
+      logger.info(`Folder selected and validated: ${validated}`);
+      return validated;
+    } catch (err) {
+      logger.warn(`Unsafe or invalid folder rejected: ${err.message}`);
+      throw err;
+    }
+  });
+
+  ipcMain.handle("validate-download-path", (_, userPath) => validateDownloadPath(userPath));
+  ipcMain.handle("get-default-download-path", () => getDefaultDownloadPath());
+
+  /**
+   * Updates Windows/macOS taskbar progress indicator.
+   *
+   * @param {number} percent - Progress value (0–100)
+   */
+  ipcMain.on("set-progress", (_, percent) => {
+    getMainWindow()?.setProgressBar(percent / 100);
+  });
+
+  /**
+   * Window minimize request from renderer.
+   */
+  ipcMain.on("window-minimize", () => getMainWindow()?.minimize());
+
+  /**
+   * Toggles maximize/unmaximize state of main window.
+   */
+  ipcMain.on("window-maximize", () => {
+    const win = getMainWindow();
+    if (!win) return;
+    win.isMaximized() ? win.unmaximize() : win.maximize();
+  });
+
+  /**
+   * Closes the main application window.
+   */
+  ipcMain.on("window-close", () => getMainWindow()?.close());
+
+
+  /**
+   * Opens Chromium DevTools in detached mode.
+   */
+  ipcMain.on("open-devtools", () =>
+    getMainWindow()?.webContents.openDevTools({ mode: "detach" })
+  );
+
+  /**
+   * Opens application logs directory in system file explorer.
+   */
+  ipcMain.on("open-logs",    () => logDir && shell.openPath(logDir));
+
+  /**
+   * Opens external website in default browser.
+   */
+  ipcMain.on("open-website", () =>
+    shell.openExternal("https://masteracnolo.github.io/Freedom-Loader-Site/")
+  );
+
+  /**
+   * Opens official wiki page in external browser.
+   */
+  ipcMain.on("open-wiki", () =>
+    shell.openExternal("https://masteracnolo.github.io/Freedom-Loader-Site/wiki")
+  );
+
+  /**
+   * Opens workshop page in external browser.
+   */
+  ipcMain.on("open-workshop", () =>
+    shell.openExternal("https://masteracnolo.github.io/Freedom-Loader-Workshop")
+  );
+
+  /**
+   * Opens configuration folder in system file explorer.
+   */
+  ipcMain.on("open-config", () => shell.openPath(configFolderPath));
+
+  
+  
+  /**
+   * Retrieves available themes from filesystem.
+   */
+  ipcMain.handle("get-themes", () => getThemes());
+
+  /**
+   * Opens theme directory in file explorer.
+   */
+  ipcMain.on("open-theme", () => shell.openPath(themeFolderPath));
+
+  /**
+   * Reloads themes from disk dynamically.
+   */
+  ipcMain.handle("reload-themes", async () => {
+    return await reloadThemes();
+  });
+
+  /**
+   * Updates a runtime feature flag and persists it to disk.
+   *
+   * Flow:
+   * - Validates key against whitelist
+   * - Prevents unnecessary writes if value is unchanged
+   * - Updates in-memory config object
+   * - Persists to configuration file
+   *
+   * Security note:
+   * Only whitelisted keys can be modified via IPC to prevent config injection.
+   *
+   * @param {Electron.IpcMainEvent} event
+   * @param {{key: string, value: any}} payload
+   * @returns {boolean} success state
+   */
+  ipcMain.handle("set-feature", (event, { key, value }) => {
+        try {
+          if (!FEATURE_WHITELIST.has(key)) {
+            logger.warn(`Rejected feature (not whitelisted): ${key}`);
+            return false;
+          }
+
+          if (configFeatures[key] === value) {
+            return true;
+          }
+
+          configFeatures[key] = value;
+
+          fs.writeFileSync(
+            configFolderPath,
+            JSON.stringify(configFeatures, null, 2),
+            "utf-8"
+          );
+
+          logger.info(`Feature updated: ${key} = ${value}`);
+          return true;
+
+        } catch (err) {
+          logger.error(`set-feature failed (${key}): ${err.message}`);
+          return false;
+        }
+    });
+}
+
+module.exports = { registerIpcHandlers };

app/pathValidator.js

@@ -0,0 +1,90 @@
+const fs = require("fs");
+const path = require("path");
+const { logger } = require("../server/logger");
+
+/**
+ * Cached resolved default download path.
+ * Initialized lazily on first access to avoid unnecessary imports.
+ */
+let _defaultPath = null;
+
+/**
+ * Returns the application's default download directory.
+ *
+ * This value is lazily loaded and cached after first call.
+ * The path originates from server configuration helpers.
+ *
+ * @returns {string} Absolute default download path
+ */
+function getDefaultDownloadPath() {
+
+  if (!_defaultPath) {
+
+    /**
+     * Lazy-loaded dependency providing the configured default download folder.
+     * Required only when function is executed to reduce startup cost.
+     */
+    const { defaultDownloadFolder } = require("../server/helpers/path.helpers");
+
+    _defaultPath = defaultDownloadFolder;
+
+  }
+  return _defaultPath;
+}
+
+/**
+ * Validates and sanitizes a user-provided download path.
+ *
+ * Steps performed:
+ * - Resolves absolute real filesystem path
+ * - Normalizes symbolic links via realpathSync
+ * - Checks path safety rules (blocks system-critical directories)
+ * - Falls back to default path if input is empty
+ *
+ * @param {string} userPath - User-provided directory path
+ * @returns {string} Sanitized absolute path
+ * @throws Error If path is invalid, unsafe, or inaccessible
+ */
+function validateDownloadPath(userPath) {
+  
+  /**
+   * Lazy-loaded helper used to enforce safe directory constraints.
+   * Prevents writes to protected system folders.
+   */
+  const { isSafePath } = require("../server/helpers/validation.helpers");
+
+  if (!userPath) return getDefaultDownloadPath();
+
+  try {
+
+    /**
+     * Resolves filesystem symlinks to ensure canonical absolute path.
+     * Required to prevent path traversal or alias bypass.
+     */
+    const resolved = fs.realpathSync(path.resolve(userPath));
+
+    if (!fs.existsSync(resolved)) {
+      fs.mkdirSync(resolved, { recursive: true });
+      logger.info(`Download folder created: ${resolved}`);
+    }
+
+    const real = fs.realpathSync(resolved);
+
+    if (!isSafePath(resolved)) {
+      throw new Error("Path not allowed: system folders are blocked!");
+    }
+
+    return real;
+  }
+  catch (err) {
+    
+    /**
+     * Handles invalid filesystem paths, permissions issues, or resolution failures.
+     * Logs diagnostic information before propagating a sanitized error.
+     */
+    logger.error(`Invalid download path: ${userPath} — ${err.message}`);
+    throw new Error(`Invalid or inaccessible path: ${err.message}`);
+  }
+}
+
+module.exports = { validateDownloadPath, getDefaultDownloadPath };

app/splashManager.js

@@ -0,0 +1,107 @@
+const { BrowserWindow, app } = require("electron");
+const path = require("path");
+
+/**
+ * Reference to the splash screen BrowserWindow instance.
+ * Used during application startup before main window is ready.
+ */
+let splashWindow = null;
+
+/**
+ * Creates and displays the splash screen window.
+ *
+ * Responsibilities:
+ * - Initializes a frameless, always-on-top splash window
+ * - Loads splash HTML UI
+ * - Dynamically injects banner image depending on dev/production mode
+ * - Acts as startup visual feedback before main window loads
+ */
+function createSplashWindow() {
+
+  /**
+   * Configuration for splash screen BrowserWindow.
+   * Optimized for minimal UI and fast startup display.
+   */
+  const splashOptions = {
+    width: 400,
+    height: 300,
+    frame: false,
+    transparent: true,
+    alwaysOnTop: true,
+    resizable: false,
+    skipTaskbar: true,
+    webPreferences: {
+      nodeIntegration: false,
+      contextIsolation: true,
+    },
+  };
+
+  /**
+   * Instantiates the splash screen window.
+   */
+  splashWindow = new BrowserWindow(splashOptions);
+
+  /**
+   * Absolute path to splash HTML file used as initial UI.
+   * Loaded locally from application bundle or project folder.
+   */
+  const splashPath = path.join(__dirname, "../public/splash.html");
+  splashWindow.loadFile(splashPath);
+
+  /**
+   * Executes once splash HTML is fully loaded.
+   * Used here to inject dynamic assets (banner image path).
+   */
+  splashWindow.webContents.on('did-finish-load', () => {
+
+    /**
+     * Resolves splash banner image path depending on runtime mode:
+     * - Production: bundled resources directory
+     * - Development: local build directory
+     */
+    let bannerPath;
+    
+    // Check if app is packaged
+    if (app.isPackaged) {
+      bannerPath = path.join(process.resourcesPath, 'banner.png');
+    } else {
+      // In dev, use build folder
+      bannerPath = path.join(__dirname, '../build/banner.png');
+    }
+    
+    /**
+     * Injects runtime image source into splash DOM.
+     * Uses file:// protocol to load local image safely in Electron context.
+     */
+    splashWindow.webContents.executeJavaScript(`
+      document.querySelector('img[alt="Freedom Loader"]').src = 'file:///${bannerPath.replace(/\\/g, '/')}';
+    `);
+  });
+}
+
+/**
+ * Closes and cleans up the splash screen window.
+ *
+ * Should be called once main window is ready to display.
+ */
+function closeSplashWindow() {
+  if (splashWindow) {
+    splashWindow.close();
+    splashWindow = null;
+  }
+}
+
+/**
+ * Updates splash screen progress indicator from main process.
+ *
+ * Sends a step value to renderer via injected JS function.
+ *
+ * @param {number} step - Current initialization step or progress value
+ */
+function setSplashProgress(step) {
+  if (splashWindow) {
+    splashWindow.webContents.executeJavaScript(`window.setProgress(${step})`);
+  }
+}
+
+module.exports = { createSplashWindow, closeSplashWindow, setSplashProgress };

app/themeManager.js

@@ -0,0 +1,337 @@
+/**
+ * Theme loading and parsing system.
+ *
+ * Supports:
+ * - Folder-based themes
+ * - ZIP-based themes
+ * - Theme validation against required schema
+ * - Image embedding as base64 data URIs
+ * - Cached theme registry with sorted priority order
+ *
+ * Acts as the core theme ingestion pipeline for the application UI.
+ */
+
+const fs = require("fs");
+const path = require("path");
+const { logger } = require("../server/logger");
+const JSZip = require("jszip");
+
+/**
+ * Maximum allowed size (in bytes) for theme images.
+ * Prevents memory abuse from large embedded assets.
+ */
+const MAX_IMAGE_SIZE = 10 * 1024 * 1024;
+
+/**
+ * List of supported image file extensions for theme assets.
+ */
+const ALLOWED_IMAGE_EXTENSIONS = [".jpg", ".jpeg", ".png", ".webp", ".gif", ".avif"];
+
+/**
+ * Allowed base filenames for theme background/cover images.
+ * Restricts theme asset resolution to known conventions.
+ */
+const ALLOWED_IMAGE_NAMES = ["cover", "background"];
+
+/**
+ * Priority order used to sort themes in UI.
+ * Themes not listed are placed at the end.
+ */
+const THEME_ORDER = ["dark", "light"];
+
+/**
+ * Required JSON schema paths for a valid theme definition.
+ * Each entry represents a nested property path that must exist.
+ */
+const REQUIRED_KEYS = [
+  ["meta", "name"],
+  ["meta", "author"],
+  ["meta", "version"],
+  ["meta", "formatVersion"],
+  ["style", "colors", "background"],
+  ["style", "colors", "text", "default"],
+  ["style", "form", "button", "background"],
+  ["style", "progressBar", "fill"],
+];
+
+/**
+ * Safely retrieves a deeply nested value from an object using a key path array.
+ *
+ * @param {object} obj - Target object
+ * @param {string[]} keys - Property path segments
+ * @returns {*} value or undefined if path is invalid
+ */
+function getNestedValue(obj, keys) {
+  return keys.reduce((acc, key) => acc?.[key], obj);
+}
+
+/**
+ * Validates theme JSON structure against required schema.
+ *
+ * Ensures all mandatory configuration keys exist before theme is accepted.
+ *
+ * @param {object} json - Parsed theme JSON
+ * @returns {{valid: boolean, reason?: string}}
+ */
+function validateThemeJson(json) {
+  for (const keyPath of REQUIRED_KEYS) {
+    if (getNestedValue(json, keyPath) === undefined) {
+      return { valid: false, reason: `Missing key: ${keyPath.join(".")}` };
+    }
+  }
+  return { valid: true };
+}
+
+/**
+ * Normalizes raw theme JSON into application-ready theme object.
+ *
+ * @param {string} themeId
+ * @param {object} themeJson
+ * @param {string|null} imageData - Base64 encoded theme image
+ * @returns {object} normalized theme object
+ */
+function buildThemeObject(themeId, themeJson, imageData) {
+  return {
+    id: themeId.toLowerCase(),
+    name: themeJson.meta.name || themeId,
+    author: themeJson.meta.author || "Unknown",
+    version: themeJson.meta.version,
+    subtitle: themeJson.meta.subtitle || "",
+    style: themeJson.style,
+    image: imageData,
+  };
+}
+
+/**
+ * Extracts and encodes an image from theme archive into base64 data URI.
+ *
+ * Applies safety checks:
+ * - Rejects images exceeding MAX_IMAGE_SIZE
+ * - Converts file extension into valid MIME type
+ *
+ * @param {Buffer} buffer
+ * @param {string} filename
+ * @returns {string|null} data URI or null if invalid
+ */
+function extractImage(buffer, filename) {
+  if (buffer.length > MAX_IMAGE_SIZE) {
+    logger.warn(`Image too large, ignoring`);
+    return null;
+  }
+  const ext = path.extname(filename).toLowerCase().replace(".", "");
+  const mime = ext === "jpg" || ext === "jpeg" ? "jpeg" : ext;
+  return `data:image/${mime};base64,${buffer.toString("base64")}`;
+}
+
+/**
+ * Loads a theme from a ZIP archive.
+ *
+ * Steps:
+ * - Extract ZIP content
+ * - Locate .theme.json file
+ * - Validate JSON structure
+ * - Extract optional image asset
+ * - Build normalized theme object
+ *
+ * @param {string} zipPath
+ * @param {string} themeId
+ * @returns {Promise<object|null>}
+ */
+async function loadThemeFromZip(zipPath, themeId) {
+  try {
+    const zipBuffer = fs.readFileSync(zipPath);
+    const zip = await JSZip.loadAsync(zipBuffer);
+
+    const jsonFile = Object.keys(zip.files).find(f => f.endsWith(".theme.json"));
+    if (!jsonFile) { logger.warn(`Theme ${themeId}: no .theme.json, skipping`); return null; }
+
+    let themeJson;
+    try { themeJson = JSON.parse(await zip.files[jsonFile].async("string")); }
+    catch { logger.warn(`Theme ${themeId}: invalid JSON, skipping`); return null; }
+
+    const validation = validateThemeJson(themeJson);
+    if (!validation.valid) { logger.warn(`Theme ${themeId}: ${validation.reason}, skipping`); return null; }
+
+    let imageData = null;
+    const imageFile = Object.keys(zip.files).find(f => {
+      const ext = path.extname(f).toLowerCase();
+      const name = path.basename(f, ext).toLowerCase();
+      return ALLOWED_IMAGE_NAMES.includes(name) && ALLOWED_IMAGE_EXTENSIONS.includes(ext);
+    });
+
+    if (imageFile) {
+      const buf = await zip.files[imageFile].async("nodebuffer");
+      imageData = extractImage(buf, imageFile);
+    }
+
+    logger.info(`Theme loaded (zip): ${themeId}`);
+    return buildThemeObject(themeId, themeJson, imageData);
+
+  } catch (err) {
+    logger.warn(`Theme ${themeId}: failed to load zip — ${err.message}`);
+    return null;
+  }
+}
+
+/**
+ * Loads a theme from a directory structure.
+ *
+ * Equivalent to ZIP loader but works on filesystem directly.
+ *
+ * @param {string} folderPath
+ * @param {string} themeId
+ * @returns {Promise<object|null>}
+ */
+async function loadThemeFromFolder(folderPath, themeId) {
+  try {
+    const jsonFile = fs.readdirSync(folderPath).find(f => f.endsWith(".theme.json"));
+    if (!jsonFile) { logger.warn(`Theme ${themeId}: no .theme.json, skipping`); return null; }
+
+    let themeJson;
+    try { themeJson = JSON.parse(fs.readFileSync(path.join(folderPath, jsonFile), "utf-8")); }
+    catch { logger.warn(`Theme ${themeId}: invalid JSON, skipping`); return null; }
+
+    const validation = validateThemeJson(themeJson);
+    if (!validation.valid) { logger.warn(`Theme ${themeId}: ${validation.reason}, skipping`); return null; }
+
+    let imageData = null;
+    const imageFile = fs.readdirSync(folderPath).find(f => {
+      const ext = path.extname(f).toLowerCase();
+      const name = path.basename(f, ext).toLowerCase();
+      return ALLOWED_IMAGE_NAMES.includes(name) && ALLOWED_IMAGE_EXTENSIONS.includes(ext);
+    });
+
+    if (imageFile) {
+      const buf = fs.readFileSync(path.join(folderPath, imageFile));
+      imageData = extractImage(buf, imageFile);
+    }
+
+    logger.info(`Theme loaded (folder): ${themeId}`);
+    return buildThemeObject(themeId, themeJson, imageData);
+
+  } catch (err) {
+    logger.warn(`Theme ${themeId}: failed to load folder — ${err.message}`);
+    return null;
+  }
+}
+
+/**
+ * In-memory cache of loaded themes.
+ * Avoids re-parsing filesystem on every request.
+ */
+let cachedThemes = null;
+
+/**
+ * Active theme directory path used as source of truth.
+ */
+let themeFolderPath = null;
+
+/**
+ * Sets the active theme directory path.
+ *
+ * @param {string} folderPath
+ */
+function setThemeFolderPath(folderPath) {
+  themeFolderPath = folderPath;
+}
+
+/**
+ * Loads all themes from the configured theme directory.
+ *
+ * Supports:
+ * - ZIP themes (.zip)
+ * - Folder themes (directory-based)
+ *
+ * Iterates through filesystem entries and delegates parsing
+ * to the appropriate loader (ZIP or folder).
+ *
+ * @returns {Promise<object[]>} List of valid theme objects
+ */
+async function loadThemesFromFolder() {
+  const themes = [];
+
+  if (!fs.existsSync(themeFolderPath)) {
+    logger.warn(`Theme folder not found: ${themeFolderPath}`);
+    return themes;
+  }
+
+  const files = fs.readdirSync(themeFolderPath);
+
+  for (const file of files) {
+    const filePath = path.join(themeFolderPath, file);
+    const themeId = path.basename(file, path.extname(file));
+
+    if (file.endsWith(".zip")) {
+      const theme = await loadThemeFromZip(filePath, themeId);
+      if (theme) themes.push(theme);
+      continue;
+    }
+
+    if (fs.statSync(filePath).isDirectory()) {
+      const theme = await loadThemeFromFolder(filePath, themeId);
+      if (theme) themes.push(theme);
+    }
+  }
+
+  return themes;
+}
+
+/**
+ * Returns sorting priority for a theme ID.
+ *
+ * Lower index = higher priority.
+ * Themes not in THEME_ORDER are placed at the end.
+ *
+ * @param {string} id
+ * @returns {number}
+ */
+function getThemeOrder(id) {
+  const index = THEME_ORDER.indexOf(id);
+  return index === -1 ? Infinity : index;
+}
+
+/**
+ * Initializes the theme system.
+ *
+ * Steps:
+ * - Sets theme folder path
+ * - Loads all themes from disk
+ * - Sorts themes by priority order
+ * - Caches result in memory
+ *
+ * @param {string} folderPath
+ */
+async function initThemes(folderPath) {
+  setThemeFolderPath(folderPath);
+  const themes = await loadThemesFromFolder();
+  logger.info(`Themes before sort: ${themes.map(t => t.id).join(", ")}`);
+  cachedThemes = themes.sort((a, b) => getThemeOrder(a.id) - getThemeOrder(b.id));
+  logger.info(`Themes after sort: ${cachedThemes.map(t => t.id).join(", ")}`);
+}
+
+/**
+ * Returns cached themes.
+ *
+ * If themes are not loaded yet, returns empty array.
+ *
+ * @returns {object[]}
+ */
+function getThemes() {
+  return cachedThemes ?? [];
+}
+
+/**
+ * Reloads themes from disk and refreshes cache.
+ *
+ * Used when themes are modified at runtime without restart.
+ *
+ * @returns {Promise<object[]>}
+ */
+async function reloadThemes() {
+  const themes = await loadThemesFromFolder();
+  cachedThemes = themes.sort((a, b) => getThemeOrder(a.id) - getThemeOrder(b.id));
+  logger.info(`Themes reloaded: ${cachedThemes.length} theme(s)`);
+  return cachedThemes;
+}
+
+module.exports = { initThemes, getThemes , reloadThemes };

app/windowManager.js

@@ -0,0 +1,108 @@
+/**
+ * Electron main window module dependencies.
+ * Handles BrowserWindow lifecycle and application UI shell.
+ */
+
+const { BrowserWindow, app } = require("electron");
+const path = require("path");
+const { logger } = require("../server/logger");
+const { configFeatures } = require("../config");
+const config = require("../config");
+
+/**
+ * Singleton reference to the main Electron BrowserWindow instance.
+ * Ensures only one application window exists at runtime.
+ */
+let mainWindow = null;
+
+/**
+ * Creates and initializes the main Electron application window.
+ *
+ * Responsibilities:
+ * - Ensures singleton window instance (prevents duplicates)
+ * - Configures window options (size, icon, preload, security settings)
+ * - Loads frontend application from local dev server
+ * - Handles lifecycle events (close, errors)
+ *
+ * @returns {Promise<BrowserWindow>} The created or existing window instance
+ */
+async function createMainWindow() {
+
+  /**
+   * Prevents multiple instances of the main window.
+   * Returns existing instance if already created.
+   */
+  if (mainWindow) {
+    logger.warn("Window already exists, no new creation!");
+    return mainWindow;
+  }
+
+  /**
+   * Resolves application icon path depending on runtime mode:
+   * - Development: local build folder
+   * - Production: packaged Electron resources
+   */
+  const iconPath = config.devMode
+    ? path.join(__dirname, "../build/app-icon.ico")
+    : path.join(process.resourcesPath, "build/app-icon.ico");
+
+  /**
+   * Electron BrowserWindow configuration object.
+   * Defines UI behavior, security settings, and preload bridge.
+   */
+  const windowOptions = {
+    title: `Freedom Loader ${config.version}`,
+    icon: iconPath,
+    width: 750,
+    height: 800,
+    minWidth: 750,
+    minHeight: 800,
+    frame: !configFeatures.customTopBar,
+    devTools: !app.isPackaged,
+    show: false, 
+    webPreferences: {
+      nodeIntegration: false,
+      contextIsolation: true,
+      preload: path.join(__dirname, "../preload.js"),
+    },
+  };
+
+  mainWindow = new BrowserWindow(windowOptions);
+
+  /**
+   * Loads the frontend application served by the local dev server.
+   * In production, this could be replaced with a file:// build.
+   */
+  try {
+    await mainWindow.loadURL(`http://localhost:${config.applicationPort}`);
+    logger.info("Window loaded");
+  } catch (err) {
+    logger.error("Window loading error:", err);
+    throw err;
+  }
+
+  /**
+   * Cleans up window reference when the main window is closed.
+   * Prevents memory leaks and allows recreation if needed.
+   */
+  mainWindow.on("closed", () => {
+    logger.info("Main window closed");
+    mainWindow = null;
+  });
+
+  return mainWindow;
+}
+
+/**
+ * Returns the current main window instance.
+ *
+ * Useful for IPC handlers and background services
+ * needing access to the renderer process.
+ *
+ * @returns {BrowserWindow | null}
+ */
+function getMainWindow() {
+  return mainWindow;
+}
+
+module.exports = { createMainWindow, getMainWindow };

app/ytDlpUpdater.js

@@ -0,0 +1,35 @@
+const { execFile } = require("child_process");
+const { logger } = require("../server/logger");
+
+/**
+ * Attempts to update the local yt-dlp binary using its built-in update command.
+ *
+ * This function:
+ * - Executes yt-dlp with the `-U` flag
+ * - Logs update output or warnings if update fails
+ * - Never throws: update failure is non-blocking by design
+ *
+ * @param {string} ytDlpPath - Absolute path to the yt-dlp executable
+ */
+function updateYtDlp(ytDlpPath) {
+
+  logger.info("yt-dlp update check starting...");
+
+  /**
+   * Executes yt-dlp CLI process in a non-interactive mode.
+   * Used here specifically for self-update via `-U` flag.
+   */
+  execFile(ytDlpPath, ["-U"], (err, stdout) => {
+
+    /**
+     * Handles yt-dlp update result:
+     * - Logs warning if update fails (network, binary issues, permissions)
+     * - Logs stdout output when update succeeds
+     */
+    if (err) logger.warn("yt-dlp update failed (continuing):", err.message);
+    
+    else logger.info(`yt-dlp update: ${stdout.trim()}`);
+  });
+}
+
+module.exports = { updateYtDlp };

config.js

@@ -3,25 +3,107 @@ const { app } = require("electron");
 const fs = require("fs");
 const path = require("path");
 
-const localMode = !app.isPackaged;
+/**
+ * Indicates whether the application is running in development mode.
+ * Determined by Electron's packaging state.
+ */
+const devMode = !app.isPackaged;
 
-// Change path for JSON file
-const featuresPath =  path.join(path.join(`${localMode ? __dirname : process.resourcesPath}`,"config/" , "config.json"));
+/**
+ * Resolves the configuration file path depending on runtime environment.
+ *
+ * In development:
+ * - Uses local config/config.dev.json
+ * - Creates it from default if missing
+ *
+ * In production:
+ * - Uses app userData/config.json
+ * - Creates it from bundled default config if missing
+ *
+ * @returns {string} Absolute path to the active configuration file
+ */
+function resolveConfigPath() {
+  if (devMode) {
+    const devConfigPath = path.join(__dirname, "config", "config.dev.json");
 
-let features = {};
+    if (!fs.existsSync(devConfigPath)) {
+      const defaultConfigPath = path.join(
+        __dirname,
+        "config",
+        "config.default.json"
+      );
+      fs.copyFileSync(defaultConfigPath, devConfigPath);
+    }
 
-function loadFeatures() {
-    const raw = fs.readFileSync(featuresPath, "utf-8");
-    features = JSON.parse(raw);
-    return features;
+    return devConfigPath;
+  }
+
+  const userConfigPath = path.join(app.getPath("userData"), "config.json");
+
+  if (!fs.existsSync(userConfigPath)) {
+    const defaultConfigPath = path.join(
+      process.resourcesPath,
+      "config",
+      "config.default.json"
+    );
+    fs.copyFileSync(defaultConfigPath, userConfigPath);
+  }
+
+  return userConfigPath;
 }
 
+/**
+ * Path to the active configuration file used at runtime.
+ */
+const featuresPath = resolveConfigPath();
+
+/**
+ * Loads and parses the feature configuration file.
+ *
+ * @returns {Object} Parsed feature flags configuration
+ * @throws {Error} If the configuration file is missing or invalid
+ */
+function loadFeatures() {
+  const raw = fs.readFileSync(featuresPath, "utf-8");
+  return JSON.parse(raw);
+}
+
+/**
+ * In-memory snapshot of application feature flags.
+ *
+ * Note: Changes to the config file are not automatically reflected.
+ * A restart or reload is required.
+ */
 const configFeatures = loadFeatures();
 
 module.exports = {
-    version: packageJson.version,
-    applicationPort: "8787",
-    localMode,
-    DiscordRPCID: "1410934537051181146",
-    configFeatures
-}
+  /**
+   * Application version from package.json
+   */
+  version: devMode ? `dev-${packageJson.version}` : `v${packageJson.version}` ,
+
+  /**
+   * Backend Express / internal server port
+   */
+  applicationPort: "8787",
+
+  /**
+   * Indicates whether the app is running in development mode
+   */
+  devMode,
+
+  /**
+   * Discord RPC application identifier
+   */
+  DiscordRPCID: "1410934537051181146",
+
+  /**
+   * Runtime feature flags loaded from configuration file
+   */
+  configFeatures,
+
+  /**
+   * Path to the active configuration file
+   */
+  featuresPath,
+};

config/config.default.json

@@ -7,9 +7,12 @@
   "addMetadata": true,
   "verboseLogs": false,
   "autoDownloadPlaylist": true,
+  "createPlaylistFolders": true,
   "customCodec": "h264",
   "logSystem": true,
   "outputTitleCheck": true,
   "downloadSystem": true,
-  "notifySystem": true
+  "notifySystem": true,
+  "enableHardwareAcceleration": true,
+  "theme": "dark" 
 }

main.js

@@ -1,301 +1,153 @@
-const config = require("./config.js");
-const { app, BrowserWindow, ipcMain, dialog, Menu, shell } = require("electron");
-const path = require("path");
-const fs = require("fs");
+/**
+ * Handle crash application and avoid ghost instance
+ */
+const { app } = require("electron");
 
-const { logger, logSessionStart, logSessionEnd, logDir } = require("./server/logger");
-const { AutoUpdater } = require("./server/update.js");
-const { configFeatures } = require("./config.js");
-const { startRPC, stopRPC} = require("./server/discordRPC");
+process.on("uncaughtException", (err) => {
+  console.error("Uncaught exception:", err);
+  app.quit();
+});
 
-let mainWindow;
-const logsFolderPath = logDir;
+process.on("unhandledRejection", (reason) => {
+  console.error("Unhandled rejection:", reason);
+  app.quit();
+});
 
-const basePath = config.localMode
-  ? path.join(__dirname )
-  : path.join(path.dirname(process.execPath), "resources");
 
-const configFolderPath = path.join(basePath, "config" ,"config.json");
+/**
+ * True if this is the primary instance (lock acquired successfully)
+ */
+const isPrimaryInstance = app.requestSingleInstanceLock();
 
-// Default download path (centralized, lazy loaded)
-let defaultDownloadPath;
-
-app.setAppUserModelId("com.masteracnolo.freedomloader"); // pour notifications Windows
-app.disableHardwareAcceleration();
-
-ipcMain.handle("version", () => config.version);
-
-// Gestion single instance
-const gotLock = app.requestSingleInstanceLock();
-
-// Native dependencies check (yt-dlp.exe, ffmpeg.exe, ffprobe.exe, Deno)
-function checkNativeDependencies() {
-  // Import centralized paths after app initialization
-  const { binaryPaths } = require("./server/helpers/path.helpers.js");
-  
-  const deps = [
-    { name: "yt-dlp.exe", path: binaryPaths.ytDlp },
-    { name: "ffmpeg.exe", path: binaryPaths.ffmpeg },
-    { name: "ffprobe.exe", path: binaryPaths.ffprobe },
-    { name: "deno.exe", path: binaryPaths.deno },
-  ];
-  const missing = deps.filter(dep => !fs.existsSync(dep.path));
-  let errorMsg = "";
-  if (missing.length > 0) {
-    const missingList = missing.map(dep => dep.name).join(", ");
-    logger.error(`Missing dependencies: ${missingList}`);
-    errorMsg += `The following files are missing in the 'ressources' folder:\n${missingList}`;
-  }
-  if (errorMsg) {
-    app.whenReady().then(() => {
-      dialog.showErrorBox(
-        "Missing dependencies",
-        `${errorMsg}\n\nThe application will now exit. Try to reinstall`
-      );
-      app.quit();
-    });
-    return false;
-  }
-  return true;
+/**
+ * If we are on a second instance
+ */
+if (!isPrimaryInstance) {
+  app.quit();
+  process.exit(0);
 }
 
-if(!config.localMode){
-  if (!gotLock) {
-    // Une instance existe déjà -> fermer l'ancienne et continuer la nouvelle
-    // Ici la nouvelle instance continue normalement
-  } else {
-    if (!checkNativeDependencies()) {
-      // Arrêt déjà géré dans la fonction
-    } else {
-      app.on("second-instance", () => {
-        // La vieille instance se ferme
-        if (mainWindow) {
-          logger.info("New Instance Detected, closing the older...");
-          mainWindow.destroy();
-          mainWindow = null;
-        }
-      });
-    }
-  }
-}
-// Création fenêtre principale
-async function createMainWindow() {
-  if (mainWindow) {
-    logger.warn("Window already exists, no new creation!");
-    return;
-  }
+/**
+ * Set App Name and AppID 
+ */
+app.setName("Freedom Loader");
+app.setAppUserModelId("com.masteracnolo.freedomloader");
 
-  mainWindow = new BrowserWindow({
-    title: `Freedom Loader ${config.version}`,
-    width: 750,
-    height: 800,
-    minWidth: 750,
-    minHeight: 800,
-    frame: !configFeatures.customTopBar,
-    devTools: `${app.isPackaged ? false : true}`,
-    webPreferences: {
-      nodeIntegration: false,
-      contextIsolation: true,
-      preload: path.join(__dirname, "preload.js"),
-    },
-  });
 
-  try {
-    await mainWindow.loadURL(`http://localhost:${config.applicationPort}`);
-    logger.info("Window Loaded");
-  } catch (err) {
-    logger.error("Window Loading Error:", err);
-  }
+/**
+ * Load the app dependencies for hardware choice
+ */
+const { logger, logSessionStart, logSessionEnd } = require("./server/logger");
+const { configFeatures } = require("./config");
 
-  mainWindow.on("closed", () => {
-    logger.info("Main Window Closed");
-    mainWindow = null;
-  });
+/**
+ * On start, enable or disable hardWareAcceleration
+ */
+if (!configFeatures.enableHardwareAcceleration){
+  app.disableHardwareAcceleration();
+  logger.info("Disabled Hardware Acceleration")
+} else {
+  logger.info("Enable Hardware Acceleration")
 }
 
-function validateDownloadPath(userPath) {
-  const { isSafePath } = require("./server/helpers/validation.helpers.js");
-  
-  // Lazy load default path
-  if (!defaultDownloadPath) {
-    const { defaultDownloadFolder } = require("./server/helpers/path.helpers.js");
-    defaultDownloadPath = defaultDownloadFolder;
-  }
+/**
+ * In-memory snapshot of application feature flags.
+ *
+ * Note: Changes to the config file are not automatically reflected.
+ * A restart could be required.
+ */
+const config = require("./config");
 
-  if (!userPath) return defaultDownloadPath;
-
-  try {
-    // Canonical resolution and symlink following
-    const resolved = fs.realpathSync(path.resolve(userPath));
-    
-    // Use the same validation as backend (allows all drives except system folders)
-    if (!isSafePath(resolved)) {
-      throw new Error("Path not allowed: system folders are blocked!");
-    }
-
-    return resolved;
-  } catch (err) {
-    logger.error(`Invalid download path: ${userPath} - ${err.message}`);
-    throw new Error(`Invalid or inaccessible path: ${err.message}`);
-  }
+if(config.devMode){
+  /**
+   * Start devTron extensions - @see https://github.com/electron/devtron
+   */
+  const { devtron } = require('@electron/devtron');
+  devtron.install(); 
+  logger.info("Loaded DevTron Extension")
 }
 
+/**
+ * Load the app dependencies 
+ */
+const { initThemes } = require("./app/themeManager");
 
-// IPC
-ipcMain.handle("select-download-folder", async () => {
-  const result = await dialog.showOpenDialog({ properties: ["openDirectory"] });
-  if (result.canceled) {
-    logger.info("Folder selection cancelled by user");
-    return null;
-  }
-  if (result.filePaths.length > 0) {
-    const selectedPath = result.filePaths[0];
-    try {
-      const validatedPath = validateDownloadPath(selectedPath);
-      logger.info(`Folder selected and validated: ${validatedPath}`);
-      return validatedPath;
-    } catch (err) {
-      logger.warn(`Unsafe or invalid folder rejected: ${err.message}`);
-      throw err; // Propagate error to UI
-    }
-  }
-  return null;
-});
-
-ipcMain.handle("validate-download-path", (event, userPath) => {
-  return validateDownloadPath(userPath);
-});
+const { initAutoUpdater } = require("./app/autoUpdater");
+const { startRPC, stopRPC } = require("./app/discordRPC");
+const { checkNativeDependencies } = require("./app/dependencyCheck");
+const { updateYtDlp } = require("./app/ytDlpUpdater");
+const { createMainWindow, getMainWindow } = require("./app/windowManager");
+const { registerIpcHandlers } = require("./app/ipcHandlers");
+const { createSplashWindow, closeSplashWindow, setSplashProgress } = require("./app/splashManager");
+const { userThemesPath, initUserThemes, isWindows } = require("./server/helpers/path.helpers");
 
 
-ipcMain.handle("get-default-download-path", () => {
-  if (!defaultDownloadPath) {
-    const { defaultDownloadFolder } = require("./server/helpers/path");
-    defaultDownloadPath = defaultDownloadFolder;
-  }
-  return defaultDownloadPath;
+/**
+ * If another instance want to run
+ */
+app.on("second-instance", () => {
+  logger.info("Second instance detected");
+
+  const mainWindow = require("./app/windowManager").getMainWindow();
+
+  if (!mainWindow) return;
+
+  if (mainWindow.isMinimized()) mainWindow.restore();
+
+  mainWindow.show();
+  mainWindow.focus();
 });
 
-ipcMain.on("set-progress", (event, percent) => {
-  if (mainWindow) mainWindow.setProgressBar(percent / 100); // Electron attend 0 → 1
-});
-
-// Topbar window controls
-ipcMain.on("window-minimize", () => {
-  if (mainWindow) mainWindow.minimize();
-});
-
-// Toggle Maximize -> UnMaximize
-ipcMain.on("window-maximize", () => {
-  if (mainWindow) {
-    if (mainWindow.isMaximized()) {
-      mainWindow.unmaximize();
-    } else {
-      mainWindow.maximize();
-    }
-  }
-});
-
-ipcMain.on("window-close", () => {
-  if (mainWindow) mainWindow.close();
-});
-
-// Topbar custom actions
-ipcMain.on("open-devtools", () => {
-  if (mainWindow) mainWindow.webContents.openDevTools({ mode: 'detach' });
-});
-ipcMain.on("open-logs", () => {
-  if (logsFolderPath) shell.openPath(logsFolderPath);
-});
-ipcMain.on("open-website", () => {
-  shell.openExternal("https://masteracnolo.github.io/FreedomLoader/index.html");
-});
-ipcMain.on("open-wiki", () => {
-  shell.openExternal("https://masteracnolo.github.io/FreedomLoader/pages/wiki.html");
-});
-ipcMain.on("open-config", () => {
-  if (configFolderPath) shell.openPath(configFolderPath);
-});
-
-
-// App ready
 app.whenReady().then(async () => {
   logSessionStart();
-  logger.info("App Ready, Server Express starting...");
 
-  const serverPath = path.join(__dirname, "server", "server.js")
+  createSplashWindow();
 
-  const expressServer = require(serverPath);
+  if (!config.devMode && !checkNativeDependencies()) return;
+
+  const { userYtDlp } = require("./server/helpers/path.helpers");
+  updateYtDlp(userYtDlp);
 
   try {
-    await expressServer.startServer();
-    logger.info("Express Server Started");
+    setSplashProgress(0); // Checking dependencies
+    await require("./server/server").startServer();
 
-    ipcMain.handle("features", () => {
-        return configFeatures;
-    });
+    setSplashProgress(1); // Starting server
+    registerIpcHandlers(getMainWindow);
 
-    const featureWhitelist = new Set([
-        "autoUpdate",
-        "discordRPC",
-        "customTopBar",
-        "autoCheckInfo",
-        "addThumbnail",
-        "addMetadata",
-        "verboseLogs",
-        "autoDownloadPlaylist",
-        "customCodec"
-      ]);
+    setSplashProgress(2); // Loading themes
 
-    
-    ipcMain.handle("set-feature", (event, { key, value }) => {
-        try {
-          if (!featureWhitelist.has(key)) {
-            logger.warn(`Rejected feature (not whitelisted): ${key}`);
-            return false;
-          }
-
-          // optionnel mais propre
-          if (configFeatures[key] === value) {
-            return true;
-          }
-
-          configFeatures[key] = value;
-
-          fs.writeFileSync(
-            configFolderPath,
-            JSON.stringify(configFeatures, null, 2),
-            "utf-8"
-          );
-
-          logger.info(`Feature updated: ${key} = ${value}`);
-          return true;
-
-        } catch (err) {
-          logger.error(`set-feature failed (${key}): ${err.message}`);
-          return false;
-        }
-      });
-
-
-    if (configFeatures.discordRPC) startRPC(); // Discord RPC
+    // TODO: Patch this, i disable this features for the moment
+    // Themes are currently disabled if we are not on Windows
+    if(isWindows){
+      initUserThemes();
+      await initThemes(userThemesPath); 
+    } else {
+      logger.info(`OS is ${process.platform}, Skipping themes loading`)
+    }
 
+    setSplashProgress(3); // Almost ready
     await createMainWindow();
+    
+    closeSplashWindow();
+    getMainWindow().show();
+    if (configFeatures.discordRPC) startRPC();
 
-    if (configFeatures.autoUpdate) AutoUpdater(mainWindow); // Auto Update
+    if (configFeatures.autoUpdate) initAutoUpdater(getMainWindow());
 
   } catch (err) {
-    logger.error("Window or Server error :", err);
+    logger.error("Boot error:", err);
     app.quit();
   }
 });
 
 app.on("window-all-closed", () => {
-  logger.info("Shuting Down App...");
+  logger.info("Shutting down...");
   app.quit();
 });
 
 app.on("before-quit", async () => {
   await stopRPC();
-  logger.info("All Services Stopped. Have a nice day!")
-  logSessionEnd(); 
-});
+  logger.info("All services stopped. Have a nice day!");
+  logSessionEnd();
+});

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "freedom-loader",
-  "version": "1.4.5",
+  "version": "1.5.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "freedom-loader",
-      "version": "1.4.5",
+      "version": "1.5.1",
       "dependencies": {
         "chalk": "^4.1.2",
         "debug": "^4.4.1",
@@ -14,15 +14,27 @@
         "electron-updater": "^6.6.2",
         "express": "^5.1.0",
         "express-rate-limit": "^8.2.1",
+        "jszip": "^3.10.1",
         "webidl-conversions": "^8.0.0",
         "winston": "^3.17.0",
         "winston-daily-rotate-file": "^5.0.0"
       },
       "devDependencies": {
-        "electron": "^37.1.0",
+        "@electron/devtron": "^2.1.1",
+        "electron": "^41.2.0",
         "electron-builder": "^26.8.1"
       }
     },
+    "node_modules/@babel/runtime": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.29.7.tgz",
+      "integrity": "sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
     "node_modules/@colors/colors": {
       "version": "1.6.0",
       "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.6.0.tgz",
@@ -87,9 +99,9 @@
       "license": "MIT"
     },
     "node_modules/@electron/asar/node_modules/brace-expansion": {
-      "version": "1.1.12",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
-      "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
+      "version": "1.1.13",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.13.tgz",
+      "integrity": "sha512-9ZLprWS6EENmhEOpjCYW2c8VkmOvckIJZfkr7rBW6dObmfgJ/L1GpSYW5Hpo9lDz4D1+n0Ckz8rU7FwHDQiG/w==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -110,6 +122,27 @@
         "node": "*"
       }
     },
+    "node_modules/@electron/devtron": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/@electron/devtron/-/devtron-2.1.1.tgz",
+      "integrity": "sha512-hiNj9faRQJYVJ69TQyJ2+BWlMAc97xwuaol1XhRb2PM4FYn7ze569kOxycQodZlEq9Sim+9yu0TxFu7//Oagxg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@fontsource-variable/roboto": "^5.2.5",
+        "@fontsource/space-mono": "^5.2.5",
+        "@microlink/react-json-view": "^1.26.2",
+        "ag-grid-community": "^34.1.2",
+        "ag-grid-react": "^34.1.2",
+        "denque": "^2.1.0",
+        "lucide-react": "^0.513.0",
+        "react": "^19.1.0",
+        "react-dom": "^19.1.0"
+      },
+      "engines": {
+        "node": ">=22.12.0"
+      }
+    },
     "node_modules/@electron/fuses": {
       "version": "1.8.0",
       "resolved": "https://registry.npmjs.org/@electron/fuses/-/fuses-1.8.0.tgz",
@@ -381,9 +414,9 @@
       "license": "MIT"
     },
     "node_modules/@electron/universal/node_modules/brace-expansion": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz",
-      "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==",
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz",
+      "integrity": "sha512-MCV/fYJEbqx68aE58kv2cA/kiky1G8vux3OR6/jbS+jIMe/6fJWa0DTzJU7dqijOWYwHi1t29FlfYI9uytqlpA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -510,6 +543,26 @@
         "node": ">= 10.0.0"
       }
     },
+    "node_modules/@fontsource-variable/roboto": {
+      "version": "5.2.10",
+      "resolved": "https://registry.npmjs.org/@fontsource-variable/roboto/-/roboto-5.2.10.tgz",
+      "integrity": "sha512-LJ0iLg6aHbLzN515gyHzmdTqJzd9NlI95cCg1DW0F5G7KkFqRLBBKBbqEJx4nSu4aby3IKmw3ZH6Fe928IfaSQ==",
+      "dev": true,
+      "license": "OFL-1.1",
+      "funding": {
+        "url": "https://github.com/sponsors/ayuhito"
+      }
+    },
+    "node_modules/@fontsource/space-mono": {
+      "version": "5.2.9",
+      "resolved": "https://registry.npmjs.org/@fontsource/space-mono/-/space-mono-5.2.9.tgz",
+      "integrity": "sha512-b61faFOHEISQ/pD25G+cfGY9o/WW6lRv6hBQQfpWvEJ4y1V+S4gmth95EVyBE2VL3qDYHeVQ8nBzrplzdXTDDg==",
+      "dev": true,
+      "license": "OFL-1.1",
+      "funding": {
+        "url": "https://github.com/sponsors/ayuhito"
+      }
+    },
     "node_modules/@isaacs/cliui": {
       "version": "8.0.2",
       "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz",
@@ -704,6 +757,25 @@
         "node": ">= 10.0.0"
       }
     },
+    "node_modules/@microlink/react-json-view": {
+      "version": "1.31.20",
+      "resolved": "https://registry.npmjs.org/@microlink/react-json-view/-/react-json-view-1.31.20.tgz",
+      "integrity": "sha512-gNLkGvjFDeAqVGvK3H7lfoDqetn/9lW2ugiYiJhchc7jQU1ZaKsZnt97ANluXWFfd/wifoA9TrVOTsUXwXCJwA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "react-base16-styling": "~0.10.0",
+        "react-lifecycles-compat": "~3.0.4",
+        "react-textarea-autosize": "~8.5.9"
+      },
+      "engines": {
+        "node": ">=17"
+      },
+      "peerDependencies": {
+        "react": ">= 15",
+        "react-dom": ">= 15"
+      }
+    },
     "node_modules/@npmcli/agent": {
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/@npmcli/agent/-/agent-3.0.0.tgz",
@@ -815,9 +887,9 @@
       }
     },
     "node_modules/@types/debug": {
-      "version": "4.1.12",
-      "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.12.tgz",
-      "integrity": "sha512-vIChWdVG3LG1SMxEvI/AK+FWJthlrqlTu7fbrlywTkkaONwk/UAGaULXRlf8vkzFBLVm0zkMdCquhL5aOjhXPQ==",
+      "version": "4.1.13",
+      "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.13.tgz",
+      "integrity": "sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -851,6 +923,13 @@
         "@types/node": "*"
       }
     },
+    "node_modules/@types/lodash": {
+      "version": "4.17.24",
+      "resolved": "https://registry.npmjs.org/@types/lodash/-/lodash-4.17.24.tgz",
+      "integrity": "sha512-gIW7lQLZbue7lRSWEFql49QJJWThrTFFeIMJdp3eH4tKoxm1OvEPg02rm4wCCSHS0cL3/Fizimb35b7k8atwsQ==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/@types/ms": {
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz",
@@ -859,13 +938,13 @@
       "license": "MIT"
     },
     "node_modules/@types/node": {
-      "version": "22.19.15",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.19.15.tgz",
-      "integrity": "sha512-F0R/h2+dsy5wJAUe3tAU6oqa2qbWY5TpNfL/RGmo1y38hiyO1w3x2jPtt76wmuaJI4DQnOBu21cNXQ2STIUUWg==",
+      "version": "24.12.2",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-24.12.2.tgz",
+      "integrity": "sha512-A1sre26ke7HDIuY/M23nd9gfB+nrmhtYyMINbjI1zHJxYteKR6qSMX56FsmjMcDb3SMcjJg5BiRRgOCC/yBD0g==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "undici-types": "~6.21.0"
+        "undici-types": "~7.16.0"
       }
     },
     "node_modules/@types/plist": {
@@ -916,9 +995,9 @@
       }
     },
     "node_modules/@xmldom/xmldom": {
-      "version": "0.8.11",
-      "resolved": "https://registry.npmjs.org/@xmldom/xmldom/-/xmldom-0.8.11.tgz",
-      "integrity": "sha512-cQzWCtO6C8TQiYl1ruKNn2U6Ao4o4WBBcbL61yJl84x+j5sOWWFU9X7DpND8XZG3daDppSsigMdfAIl2upQBRw==",
+      "version": "0.8.13",
+      "resolved": "https://registry.npmjs.org/@xmldom/xmldom/-/xmldom-0.8.13.tgz",
+      "integrity": "sha512-KRYzxepc14G/CEpEGc3Yn+JKaAeT63smlDr+vjB8jRfgTBBI9wRj/nkQEO+ucV8p8I9bfKLWp37uHgFrbntPvw==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -955,6 +1034,38 @@
         "node": ">= 0.6"
       }
     },
+    "node_modules/ag-charts-types": {
+      "version": "12.3.1",
+      "resolved": "https://registry.npmjs.org/ag-charts-types/-/ag-charts-types-12.3.1.tgz",
+      "integrity": "sha512-5216xYoawnvMXDFI6kTpPku+mH0Csiwu/FE7lsAm8Z22HEN6ciSG/V7g+IrpLWncELqksgENebCTP75PZ3CsHA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/ag-grid-community": {
+      "version": "34.3.1",
+      "resolved": "https://registry.npmjs.org/ag-grid-community/-/ag-grid-community-34.3.1.tgz",
+      "integrity": "sha512-PwlrPudsFOzGumphi2y9ihWeaUlIwKhOra/MXu2LjeV2U8DgLLcYS8CartE5Hszhn1poJHawwI9HWrxlKliwdw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ag-charts-types": "12.3.1"
+      }
+    },
+    "node_modules/ag-grid-react": {
+      "version": "34.3.1",
+      "resolved": "https://registry.npmjs.org/ag-grid-react/-/ag-grid-react-34.3.1.tgz",
+      "integrity": "sha512-1UTlBT+xJkjNZAuf7RxK61mgxKGTPB+6XR99oIHq7cYC89kJmLbWqhHt/1XqRWF5cAgSKk8u+HtOQaN8tAZStw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ag-grid-community": "34.3.1",
+        "prop-types": "^15.8.1"
+      },
+      "peerDependencies": {
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+        "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      }
+    },
     "node_modules/agent-base": {
       "version": "7.1.4",
       "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz",
@@ -1354,9 +1465,9 @@
       "optional": true
     },
     "node_modules/brace-expansion": {
-      "version": "5.0.4",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.4.tgz",
-      "integrity": "sha512-h+DEnpVvxmfVefa4jFbCf5HdH5YMDXRsmKflpf1pILZWRFlTbJpxeU55nJl4Smt5HQaGzg1o6RHFPJaOqnmBDg==",
+      "version": "5.0.6",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.6.tgz",
+      "integrity": "sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -1525,9 +1636,9 @@
       "license": "MIT"
     },
     "node_modules/cacache/node_modules/brace-expansion": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz",
-      "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==",
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz",
+      "integrity": "sha512-MCV/fYJEbqx68aE58kv2cA/kiky1G8vux3OR6/jbS+jIMe/6fJWa0DTzJU7dqijOWYwHi1t29FlfYI9uytqlpA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -1882,9 +1993,9 @@
       "license": "MIT"
     },
     "node_modules/content-disposition": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.0.1.tgz",
-      "integrity": "sha512-oIXISMynqSqm241k6kcQ5UwttDILMK4BiurCfGEREw6+X9jkkpEe5T9FZaApyLGGOnFuyMWZpdolTXMtvEJ08Q==",
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.1.0.tgz",
+      "integrity": "sha512-5jRCH9Z/+DRP7rkvY83B+yGIGX96OYdJmzngqnw2SBSxqCFPd0w2km3s5iawpGX8krnwSGmF0FW5Nhr0Hfai3g==",
       "license": "MIT",
       "engines": {
         "node": ">=18"
@@ -1925,9 +2036,7 @@
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz",
       "integrity": "sha512-3lqz5YjWTYnW6dlDa5TLaTCcShfar1e40rmcJVwCBJC6mWlFuj0eCHIElmG1g5kyuJ/GD+8Wn4FFCcz4gJPfaQ==",
-      "dev": true,
-      "license": "MIT",
-      "optional": true
+      "license": "MIT"
     },
     "node_modules/crc": {
       "version": "3.8.0",
@@ -1987,6 +2096,13 @@
         "node": ">= 8"
       }
     },
+    "node_modules/csstype": {
+      "version": "3.2.3",
+      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
+      "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/debug": {
       "version": "4.4.3",
       "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
@@ -2104,6 +2220,16 @@
         "node": ">=0.4.0"
       }
     },
+    "node_modules/denque": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/denque/-/denque-2.1.0.tgz",
+      "integrity": "sha512-HVQE3AAb/pxF8fQAoiqpvg9i3evqug3hoiwakOyZAwJm+6vZehbkYXZ0l4JxS+I3QxM97v5aaRNhj8v5oBhekw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.10"
+      }
+    },
     "node_modules/depd": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
@@ -2150,9 +2276,9 @@
       "license": "MIT"
     },
     "node_modules/dir-compare/node_modules/brace-expansion": {
-      "version": "1.1.12",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
-      "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
+      "version": "1.1.13",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.13.tgz",
+      "integrity": "sha512-9ZLprWS6EENmhEOpjCYW2c8VkmOvckIJZfkr7rBW6dObmfgJ/L1GpSYW5Hpo9lDz4D1+n0Ckz8rU7FwHDQiG/w==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -2341,15 +2467,15 @@
       }
     },
     "node_modules/electron": {
-      "version": "37.10.3",
-      "resolved": "https://registry.npmjs.org/electron/-/electron-37.10.3.tgz",
-      "integrity": "sha512-3IjCGSjQmH50IbW2PFveaTzK+KwcFX9PEhE7KXb9v5IT8cLAiryAN7qezm/XzODhDRlLu0xKG1j8xWBtZ/bx/g==",
+      "version": "41.2.0",
+      "resolved": "https://registry.npmjs.org/electron/-/electron-41.2.0.tgz",
+      "integrity": "sha512-0OKLiymqfV0WK68RBXqAm3Myad2TpI5wwxLCBEUcH5Nugo3YfSk7p1Js/AL9266qTz5xZioUnxt9hG8FFwax0g==",
       "dev": true,
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {
         "@electron/get": "^2.0.0",
-        "@types/node": "^22.7.7",
+        "@types/node": "^24.9.0",
         "extract-zip": "^2.0.1"
       },
       "bin": {
@@ -2795,12 +2921,12 @@
       }
     },
     "node_modules/express-rate-limit": {
-      "version": "8.3.1",
-      "resolved": "https://registry.npmjs.org/express-rate-limit/-/express-rate-limit-8.3.1.tgz",
-      "integrity": "sha512-D1dKN+cmyPWuvB+G2SREQDzPY1agpBIcTa9sJxOPMCNeH3gwzhqJRDWCXW3gg0y//+LQ/8j52JbMROWyrKdMdw==",
+      "version": "8.5.1",
+      "resolved": "https://registry.npmjs.org/express-rate-limit/-/express-rate-limit-8.5.1.tgz",
+      "integrity": "sha512-5O6KYmyJEpuPJV5hNTXKbAHWRqrzyu+OI3vUnSd2kXFubIVpG7ezpgxQy76Zo5GQZtrQBg86hF+CM/NX+cioiQ==",
       "license": "MIT",
       "dependencies": {
-        "ip-address": "10.1.0"
+        "ip-address": "^10.2.0"
       },
       "engines": {
         "node": ">= 16"
@@ -2926,9 +3052,9 @@
       "license": "MIT"
     },
     "node_modules/filelist/node_modules/brace-expansion": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz",
-      "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==",
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz",
+      "integrity": "sha512-MCV/fYJEbqx68aE58kv2cA/kiky1G8vux3OR6/jbS+jIMe/6fJWa0DTzJU7dqijOWYwHi1t29FlfYI9uytqlpA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -3200,9 +3326,9 @@
       "license": "MIT"
     },
     "node_modules/glob/node_modules/brace-expansion": {
-      "version": "1.1.12",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
-      "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
+      "version": "1.1.13",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.13.tgz",
+      "integrity": "sha512-9ZLprWS6EENmhEOpjCYW2c8VkmOvckIJZfkr7rBW6dObmfgJ/L1GpSYW5Hpo9lDz4D1+n0Ckz8rU7FwHDQiG/w==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -3515,6 +3641,12 @@
       ],
       "license": "BSD-3-Clause"
     },
+    "node_modules/immediate": {
+      "version": "3.0.6",
+      "resolved": "https://registry.npmjs.org/immediate/-/immediate-3.0.6.tgz",
+      "integrity": "sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==",
+      "license": "MIT"
+    },
     "node_modules/imurmurhash": {
       "version": "0.1.4",
       "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz",
@@ -3544,9 +3676,9 @@
       "license": "ISC"
     },
     "node_modules/ip-address": {
-      "version": "10.1.0",
-      "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.1.0.tgz",
-      "integrity": "sha512-XXADHxXmvT9+CRxhXg56LJovE+bmWnEWB78LB83VZTprKTmaC5QfruXocxzTZ2Kl0DNwKuBdlIhjL8LeY8Sf8Q==",
+      "version": "10.2.0",
+      "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.2.0.tgz",
+      "integrity": "sha512-/+S6j4E9AHvW9SWMSEY9Xfy66O5PWvVEJ08O0y5JGyEKQpojb0K0GKpz/v5HJ/G0vi3D2sjGK78119oXZeE0qA==",
       "license": "MIT",
       "engines": {
         "node": ">= 12"
@@ -3561,6 +3693,13 @@
         "node": ">= 0.10"
       }
     },
+    "node_modules/is-arrayish": {
+      "version": "0.3.4",
+      "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.3.4.tgz",
+      "integrity": "sha512-m6UrgzFVUYawGBh1dUsWR5M2Clqic9RVXC/9f8ceNlv2IcO9j9J/z8UoCLPqtsPBFNzEpfR3xftohbfqDx8EQA==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/is-fullwidth-code-point": {
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
@@ -3612,6 +3751,12 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/isarray": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
+      "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
+      "license": "MIT"
+    },
     "node_modules/isbinaryfile": {
       "version": "5.0.7",
       "resolved": "https://registry.npmjs.org/isbinaryfile/-/isbinaryfile-5.0.7.tgz",
@@ -3679,6 +3824,13 @@
         "jiti": "lib/jiti-cli.mjs"
       }
     },
+    "node_modules/js-tokens": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/js-yaml": {
       "version": "4.1.1",
       "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz",
@@ -3736,6 +3888,48 @@
         "graceful-fs": "^4.1.6"
       }
     },
+    "node_modules/jszip": {
+      "version": "3.10.1",
+      "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.10.1.tgz",
+      "integrity": "sha512-xXDvecyTpGLrqFrvkrUSoxxfJI5AH7U8zxxtVclpsUtMCq4JQ290LY8AW5c7Ggnr/Y/oK+bQMbqK2qmtk3pN4g==",
+      "license": "(MIT OR GPL-3.0-or-later)",
+      "dependencies": {
+        "lie": "~3.3.0",
+        "pako": "~1.0.2",
+        "readable-stream": "~2.3.6",
+        "setimmediate": "^1.0.5"
+      }
+    },
+    "node_modules/jszip/node_modules/readable-stream": {
+      "version": "2.3.8",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz",
+      "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==",
+      "license": "MIT",
+      "dependencies": {
+        "core-util-is": "~1.0.0",
+        "inherits": "~2.0.3",
+        "isarray": "~1.0.0",
+        "process-nextick-args": "~2.0.0",
+        "safe-buffer": "~5.1.1",
+        "string_decoder": "~1.1.1",
+        "util-deprecate": "~1.0.1"
+      }
+    },
+    "node_modules/jszip/node_modules/safe-buffer": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
+      "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
+      "license": "MIT"
+    },
+    "node_modules/jszip/node_modules/string_decoder": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
+      "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.1.0"
+      }
+    },
     "node_modules/keyv": {
       "version": "4.5.4",
       "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz",
@@ -3758,10 +3952,26 @@
       "integrity": "sha512-0/BnGCCfyUMkBpeDgWihanIAF9JmZhHBgUhEqzvf+adhNGLoP6TaiI5oF8oyb3I45P+PcnrqihSf01M0l0G5+Q==",
       "license": "MIT"
     },
+    "node_modules/lie": {
+      "version": "3.3.0",
+      "resolved": "https://registry.npmjs.org/lie/-/lie-3.3.0.tgz",
+      "integrity": "sha512-UaiMJzeWRlEujzAuw5LokY1L5ecNQYZKfmyZ9L7wDHb/p5etKaxXhohBcrw0EYby+G/NA52vRSN4N39dxHAIwQ==",
+      "license": "MIT",
+      "dependencies": {
+        "immediate": "~3.0.5"
+      }
+    },
     "node_modules/lodash": {
-      "version": "4.17.23",
-      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz",
-      "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==",
+      "version": "4.18.1",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
+      "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lodash-es": {
+      "version": "4.18.1",
+      "resolved": "https://registry.npmjs.org/lodash-es/-/lodash-es-4.18.1.tgz",
+      "integrity": "sha512-J8xewKD/Gk22OZbhpOVSwcs60zhd95ESDwezOFuA3/099925PdHJ7OFHNTGtajL3AlZkykD32HykiMo+BIBI8A==",
       "dev": true,
       "license": "MIT"
     },
@@ -3812,6 +4022,19 @@
         "node": ">= 12.0.0"
       }
     },
+    "node_modules/loose-envify": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz",
+      "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "js-tokens": "^3.0.0 || ^4.0.0"
+      },
+      "bin": {
+        "loose-envify": "cli.js"
+      }
+    },
     "node_modules/lowercase-keys": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/lowercase-keys/-/lowercase-keys-2.0.0.tgz",
@@ -3835,6 +4058,16 @@
         "node": ">=10"
       }
     },
+    "node_modules/lucide-react": {
+      "version": "0.513.0",
+      "resolved": "https://registry.npmjs.org/lucide-react/-/lucide-react-0.513.0.tgz",
+      "integrity": "sha512-CJZKq2g8Y8yN4Aq002GahSXbG2JpFv9kXwyiOAMvUBv7pxeOFHUWKB0mO7MiY4ZVFCV4aNjv2BJFq/z3DgKPQg==",
+      "dev": true,
+      "license": "ISC",
+      "peerDependencies": {
+        "react": "^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      }
+    },
     "node_modules/make-fetch-happen": {
       "version": "14.0.3",
       "resolved": "https://registry.npmjs.org/make-fetch-happen/-/make-fetch-happen-14.0.3.tgz",
@@ -3961,13 +4194,13 @@
       }
     },
     "node_modules/minimatch": {
-      "version": "10.2.4",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.4.tgz",
-      "integrity": "sha512-oRjTw/97aTBN0RHbYCdtF1MQfvusSIBQM0IZEgzl6426+8jSC0nF1a/GmnVLpfB9yyr6g6FTqWqiZVbxrtaCIg==",
+      "version": "10.2.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz",
+      "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==",
       "dev": true,
       "license": "BlueOak-1.0.0",
       "dependencies": {
-        "brace-expansion": "^5.0.2"
+        "brace-expansion": "^5.0.5"
       },
       "engines": {
         "node": "18 || 20 || >=22"
@@ -4028,11 +4261,11 @@
       }
     },
     "node_modules/minipass-flush": {
-      "version": "1.0.5",
-      "resolved": "https://registry.npmjs.org/minipass-flush/-/minipass-flush-1.0.5.tgz",
-      "integrity": "sha512-JmQSYYpPUqX5Jyn1mXaRwOda1uQ8HP5KAT/oDSLCzt1BYRhQU0/hDtsB1ufZfEEzMZ9aAVmsBw8+FWsIXlClWw==",
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/minipass-flush/-/minipass-flush-1.0.7.tgz",
+      "integrity": "sha512-TbqTz9cUwWyHS2Dy89P3ocAGUGxKjjLuR9z8w4WUTGAVgEj17/4nhgo2Du56i0Fm3Pm30g4iA8Lcqctc76jCzA==",
       "dev": true,
-      "license": "ISC",
+      "license": "BlueOak-1.0.0",
       "dependencies": {
         "minipass": "^3.0.0"
       },
@@ -4299,6 +4532,16 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/object-assign": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
+      "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/object-hash": {
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/object-hash/-/object-hash-3.0.0.tgz",
@@ -4447,6 +4690,12 @@
       "dev": true,
       "license": "BlueOak-1.0.0"
     },
+    "node_modules/pako": {
+      "version": "1.0.11",
+      "resolved": "https://registry.npmjs.org/pako/-/pako-1.0.11.tgz",
+      "integrity": "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==",
+      "license": "(MIT AND Zlib)"
+    },
     "node_modules/parseurl": {
       "version": "1.3.3",
       "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
@@ -4501,9 +4750,9 @@
       "license": "ISC"
     },
     "node_modules/path-to-regexp": {
-      "version": "8.3.0",
-      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.3.0.tgz",
-      "integrity": "sha512-7jdwVIRtsP8MYpdXSwOS0YdD0Du+qOoF/AEPIt88PcCFrZCzx41oxku1jD88hZBwbNUIEfpqvuhjFaMAqMTWnA==",
+      "version": "8.4.2",
+      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.4.2.tgz",
+      "integrity": "sha512-qRcuIdP69NPm4qbACK+aDogI5CBDMi1jKe0ry5rSQJz8JVLsC7jV8XpiJjGRLLol3N+R5ihGYcrPLTno6pAdBA==",
       "license": "MIT",
       "funding": {
         "type": "opencollective",
@@ -4540,9 +4789,9 @@
       "license": "ISC"
     },
     "node_modules/picomatch": {
-      "version": "4.0.3",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
-      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz",
+      "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -4607,6 +4856,12 @@
         "node": "^18.17.0 || >=20.5.0"
       }
     },
+    "node_modules/process-nextick-args": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
+      "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
+      "license": "MIT"
+    },
     "node_modules/progress": {
       "version": "2.0.3",
       "resolved": "https://registry.npmjs.org/progress/-/progress-2.0.3.tgz",
@@ -4631,6 +4886,18 @@
         "node": ">=10"
       }
     },
+    "node_modules/prop-types": {
+      "version": "15.8.1",
+      "resolved": "https://registry.npmjs.org/prop-types/-/prop-types-15.8.1.tgz",
+      "integrity": "sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "loose-envify": "^1.4.0",
+        "object-assign": "^4.1.1",
+        "react-is": "^16.13.1"
+      }
+    },
     "node_modules/proper-lockfile": {
       "version": "4.1.2",
       "resolved": "https://registry.npmjs.org/proper-lockfile/-/proper-lockfile-4.1.2.tgz",
@@ -4678,9 +4945,9 @@
       }
     },
     "node_modules/qs": {
-      "version": "6.15.0",
-      "resolved": "https://registry.npmjs.org/qs/-/qs-6.15.0.tgz",
-      "integrity": "sha512-mAZTtNCeetKMH+pSjrb76NAM8V9a05I9aBZOHztWy/UqcJdQYNsf59vrRKWnojAT9Y+GbIvoTBC++CPHqpDBhQ==",
+      "version": "6.15.2",
+      "resolved": "https://registry.npmjs.org/qs/-/qs-6.15.2.tgz",
+      "integrity": "sha512-Rzq0KEyX/w/tEybncDgdkZrJgVUsUMk3xjh3t5bv3S1HTAtg+uOYt72+ZfwiQwKdysThkTBdL/rTi6HDmX9Ddw==",
       "license": "BSD-3-Clause",
       "dependencies": {
         "side-channel": "^1.1.0"
@@ -4745,6 +5012,99 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/react": {
+      "version": "19.2.7",
+      "resolved": "https://registry.npmjs.org/react/-/react-19.2.7.tgz",
+      "integrity": "sha512-HNe9WslTbXmFK8o8cmwgAeJFSBvt1bPdHCVKtaaV+WlAN36mpT4hcRpwbf3fY56ar2oIXzsBpOAiIRHAdY0OlQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/react-base16-styling": {
+      "version": "0.10.0",
+      "resolved": "https://registry.npmjs.org/react-base16-styling/-/react-base16-styling-0.10.0.tgz",
+      "integrity": "sha512-H1k2eFB6M45OaiRru3PBXkuCcn2qNmx+gzLb4a9IPMR7tMH8oBRXU5jGbPDYG1Hz+82d88ED0vjR8BmqU3pQdg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/lodash": "^4.17.0",
+        "color": "^4.2.3",
+        "csstype": "^3.1.3",
+        "lodash-es": "^4.17.21"
+      }
+    },
+    "node_modules/react-base16-styling/node_modules/color": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/color/-/color-4.2.3.tgz",
+      "integrity": "sha512-1rXeuUUiGGrykh+CeBdu5Ie7OJwinCgQY0bc7GCRxy5xVHy+moaqkpL/jqQq0MtQOeYcrqEz4abc5f0KtU7W4A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "color-convert": "^2.0.1",
+        "color-string": "^1.9.0"
+      },
+      "engines": {
+        "node": ">=12.5.0"
+      }
+    },
+    "node_modules/react-base16-styling/node_modules/color-string": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/color-string/-/color-string-1.9.1.tgz",
+      "integrity": "sha512-shrVawQFojnZv6xM40anx4CkoDP+fZsw/ZerEMsW/pyzsRbElpsL/DBVW7q3ExxwusdNXI3lXpuhEZkzs8p5Eg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "color-name": "^1.0.0",
+        "simple-swizzle": "^0.2.2"
+      }
+    },
+    "node_modules/react-dom": {
+      "version": "19.2.7",
+      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.7.tgz",
+      "integrity": "sha512-t0BRVXvbiE/o20Hfw669rLbMCDWtYZLvmJigy2f0MxsXF+71pxhR3xOkspmsO8h3ZlNzyibAmtCa3l4lYKk6gQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "scheduler": "^0.27.0"
+      },
+      "peerDependencies": {
+        "react": "^19.2.7"
+      }
+    },
+    "node_modules/react-is": {
+      "version": "16.13.1",
+      "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz",
+      "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/react-lifecycles-compat": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/react-lifecycles-compat/-/react-lifecycles-compat-3.0.4.tgz",
+      "integrity": "sha512-fBASbA6LnOU9dOU2eW7aQ8xmYBSXUIWr+UmF9b1efZBazGNO+rcXT/icdKnYm2pTwcRylVUYwW7H1PHfLekVzA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/react-textarea-autosize": {
+      "version": "8.5.9",
+      "resolved": "https://registry.npmjs.org/react-textarea-autosize/-/react-textarea-autosize-8.5.9.tgz",
+      "integrity": "sha512-U1DGlIQN5AwgjTyOEnI1oCcMuEr1pv1qOtklB2l4nyMGbHzWrI0eFsYK0zos2YWqAolJyG0IWJaqWmWj5ETh0A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.20.13",
+        "use-composed-ref": "^1.3.0",
+        "use-latest": "^1.2.1"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "peerDependencies": {
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      }
+    },
     "node_modules/read-binary-file-arch": {
       "version": "1.0.6",
       "resolved": "https://registry.npmjs.org/read-binary-file-arch/-/read-binary-file-arch-1.0.6.tgz",
@@ -4941,9 +5301,9 @@
       "license": "MIT"
     },
     "node_modules/sanitize-filename": {
-      "version": "1.6.3",
-      "resolved": "https://registry.npmjs.org/sanitize-filename/-/sanitize-filename-1.6.3.tgz",
-      "integrity": "sha512-y/52Mcy7aw3gRm7IrcGDFx/bCk4AhRh2eI9luHOQM86nZsqwiRkkq2GekHXBBD+SmPidc8i2PqtYZl+pWJ8Oeg==",
+      "version": "1.6.4",
+      "resolved": "https://registry.npmjs.org/sanitize-filename/-/sanitize-filename-1.6.4.tgz",
+      "integrity": "sha512-9ZyI08PsvdQl2r/bBIGubpVdR3RR9sY6RDiWFPreA21C/EFlQhmgo20UZlNjZMMZNubusLhAQozkA0Od5J21Eg==",
       "dev": true,
       "license": "WTFPL OR ISC",
       "dependencies": {
@@ -4951,14 +5311,21 @@
       }
     },
     "node_modules/sax": {
-      "version": "1.5.0",
-      "resolved": "https://registry.npmjs.org/sax/-/sax-1.5.0.tgz",
-      "integrity": "sha512-21IYA3Q5cQf089Z6tgaUTr7lDAyzoTPx5HRtbhsME8Udispad8dC/+sziTNugOEx54ilvatQ9YCzl4KQLPcRHA==",
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/sax/-/sax-1.6.0.tgz",
+      "integrity": "sha512-6R3J5M4AcbtLUdZmRv2SygeVaM7IhrLXu9BmnOGmmACak8fiUtOsYNWUS4uK7upbmHIBbLBeFeI//477BKLBzA==",
       "license": "BlueOak-1.0.0",
       "engines": {
         "node": ">=11.0.0"
       }
     },
+    "node_modules/scheduler": {
+      "version": "0.27.0",
+      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.27.0.tgz",
+      "integrity": "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/semver": {
       "version": "6.3.1",
       "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
@@ -5039,6 +5406,12 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/setimmediate": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz",
+      "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==",
+      "license": "MIT"
+    },
     "node_modules/setprototypeof": {
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
@@ -5147,6 +5520,16 @@
       "dev": true,
       "license": "ISC"
     },
+    "node_modules/simple-swizzle": {
+      "version": "0.2.4",
+      "resolved": "https://registry.npmjs.org/simple-swizzle/-/simple-swizzle-0.2.4.tgz",
+      "integrity": "sha512-nAu1WFPQSMNr2Zn9PGSZK9AGn4t/y97lEm+MXTtUDwfP0ksAIX4nO+6ruD9Jwut4C49SB1Ws+fbXsm/yScWOHw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-arrayish": "^0.3.1"
+      }
+    },
     "node_modules/simple-update-notifier": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/simple-update-notifier/-/simple-update-notifier-2.0.0.tgz",
@@ -5393,9 +5776,9 @@
       }
     },
     "node_modules/tar": {
-      "version": "7.5.11",
-      "resolved": "https://registry.npmjs.org/tar/-/tar-7.5.11.tgz",
-      "integrity": "sha512-ChjMH33/KetonMTAtpYdgUFr0tbz69Fp2v7zWxQfYZX4g5ZN2nOBXm1R2xyA+lMIKrLKIoKAwFj93jE/avX9cQ==",
+      "version": "7.5.13",
+      "resolved": "https://registry.npmjs.org/tar/-/tar-7.5.13.tgz",
+      "integrity": "sha512-tOG/7GyXpFevhXVh8jOPJrmtRpOTsYqUIkVdVooZYJS/z8WhfQUX8RJILmeuJNinGAMSu1veBr4asSHFt5/hng==",
       "dev": true,
       "license": "BlueOak-1.0.0",
       "dependencies": {
@@ -5516,14 +5899,14 @@
       "license": "MIT"
     },
     "node_modules/tinyglobby": {
-      "version": "0.2.15",
-      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
-      "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
+      "version": "0.2.16",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.16.tgz",
+      "integrity": "sha512-pn99VhoACYR8nFHhxqix+uvsbXineAasWm5ojXoN8xEwK5Kd3/TrhNn1wByuD52UxWRLy8pu+kRMniEi6Eq9Zg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "fdir": "^6.5.0",
-        "picomatch": "^4.0.3"
+        "picomatch": "^4.0.4"
       },
       "engines": {
         "node": ">=12.0.0"
@@ -5533,9 +5916,9 @@
       }
     },
     "node_modules/tmp": {
-      "version": "0.2.5",
-      "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.2.5.tgz",
-      "integrity": "sha512-voyz6MApa1rQGUxT3E+BK7/ROe8itEx7vD8/HEvt4xwXucvQ5G5oeEiHkmHZJuBO21RpOf+YYm9MOivj709jow==",
+      "version": "0.2.7",
+      "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.2.7.tgz",
+      "integrity": "sha512-e0votIpp4Uo2AJYSzVHV6xCcawuiez3DzqDAbrTc3YxBkplN6e+dM13ZeIcZnDg/QpSuU2zfZ3rzwY8ukEnaXw==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -5615,9 +5998,9 @@
       }
     },
     "node_modules/undici-types": {
-      "version": "6.21.0",
-      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
-      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "version": "7.16.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.16.0.tgz",
+      "integrity": "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==",
       "dev": true,
       "license": "MIT"
     },
@@ -5676,6 +6059,54 @@
         "punycode": "^2.1.0"
       }
     },
+    "node_modules/use-composed-ref": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/use-composed-ref/-/use-composed-ref-1.4.0.tgz",
+      "integrity": "sha512-djviaxuOOh7wkj0paeO1Q/4wMZ8Zrnag5H6yBvzN7AKKe8beOaED9SF5/ByLqsku8NP4zQqsvM2u3ew/tJK8/w==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/react": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/use-isomorphic-layout-effect": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/use-isomorphic-layout-effect/-/use-isomorphic-layout-effect-1.2.1.tgz",
+      "integrity": "sha512-tpZZ+EX0gaghDAiFR37hj5MgY6ZN55kLiPkJsKxBMZ6GZdOSPJXiOzPM984oPYZ5AnehYx5WQp1+ME8I/P/pRA==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/react": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/use-latest": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/use-latest/-/use-latest-1.3.0.tgz",
+      "integrity": "sha512-mhg3xdm9NaM8q+gLT8KryJPnRFOz1/5XPBhmDEVZK1webPzDjrPk7f/mbpeLqTgB9msytYWANxgALOCJKnLvcQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "use-isomorphic-layout-effect": "^1.1.1"
+      },
+      "peerDependencies": {
+        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/react": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/utf8-byte-length": {
       "version": "1.0.5",
       "resolved": "https://registry.npmjs.org/utf8-byte-length/-/utf8-byte-length-1.0.5.tgz",

package.json

@@ -1,13 +1,17 @@
 {
   "name": "freedom-loader",
   "productName": "Freedom Loader",
-  "version": "1.4.6",
-  "author": "MasterAcnolo",
+  "version": "1.6.0",
+  "author": "MasterAcnolo <MasterAcnolo@users.noreply.github.com>",
   "description": "Freedom Loader",
   "main": "main.js",
   "scripts": {
     "start": "electron --trace-warnings .",
+    "postinstall": "chmod +x resources/binaries/linux/* 2>/dev/null || true",
     "build": "electron-builder",
+    "build:win": "electron-builder --win",
+    "build:linux": "electron-builder --linux",
+    "build:all": "electron-builder -wl",
     "update": "npm update"
   },
   "dependencies": {
@@ -17,13 +21,15 @@
     "electron-updater": "^6.6.2",
     "express": "^5.1.0",
     "express-rate-limit": "^8.2.1",
+    "jszip": "^3.10.1",
     "webidl-conversions": "^8.0.0",
     "winston": "^3.17.0",
     "winston-daily-rotate-file": "^5.0.0"
   },
   "devDependencies": {
-    "electron": "^37.1.0",
-    "electron-builder": "^26.8.1"
+    "electron": "^41.2.0",
+    "electron-builder": "^26.8.1",
+    "@electron/devtron": "^2.1.1"
   },
   "build": {
     "appId": "com.masteracnolo.freedomloader",
@@ -38,53 +44,31 @@
     "files": [
       "**/*",
       "node_modules/**/*",
-      "!logs/*.json"
+      "!config/config.dev.json",
+      "!theme/**/*"
     ],
     "directories": {
       "buildResources": "build"
     },
     "asar": true,
     "extraResources": [
-      {
-        "from": "build/confirm-icon.png",
-        "to": "confirm-icon.png"
-      },
-      {
-        "from": "build/app-icon.ico",
-        "to": "app-icon.ico"
-      },
-      {
-        "from": "build/banner.bmp",
-        "to": "banner.bmp"
-      },
-      {
-        "from": "build/error.png",
-        "to": "error.png"
-      },
-      {
-        "from": "ressources/yt-dlp.exe",
-        "to": "binaries/yt-dlp.exe"
-      },
-      {
-        "from": "ressources/ffmpeg.exe",
-        "to": "binaries/ffmpeg.exe"
-      },
-      {
-        "from": "ressources/ffprobe.exe",
-        "to": "binaries/ffprobe.exe"
-      },
-      {
-        "from": "ressources/deno.exe",
-        "to": "binaries/deno.exe"
-      },
-      {
-        "from": "config/config.json",
-        "to": "config/config.json"
-      }
+      { "from": "theme", "to": "theme" },
+      { "from": "build/confirm-icon.png", "to": "confirm-icon.png" },
+      { "from": "build/banner.bmp", "to": "banner.bmp" },
+      { "from": "build/banner.png", "to": "banner.png" },
+      { "from": "build/error.png", "to": "error.png" },
+      { "from": "config/config.default.json", "to": "config/config.default.json" }
     ],
     "win": {
       "target": "nsis",
-      "icon": "build/app-icon.ico"
+      "icon": "build/app-icon.ico",
+      "artifactName": "${productName}-Setup-${version}.${ext}",
+      "extraResources": [
+        { "from": "resources/binaries/win-32/yt-dlp.exe", "to": "binaries/yt-dlp.exe" },
+        { "from": "resources/binaries/win-32/ffmpeg.exe", "to": "binaries/ffmpeg.exe" },
+        { "from": "resources/binaries/win-32/ffprobe.exe", "to": "binaries/ffprobe.exe" },
+        { "from": "resources/binaries/win-32/deno.exe", "to": "binaries/deno.exe" }
+      ]
     },
     "nsis": {
       "oneClick": false,
@@ -96,6 +80,23 @@
       "createDesktopShortcut": true,
       "createStartMenuShortcut": true,
       "shortcutName": "Freedom Loader"
+    },
+    "linux": {
+      "target": ["AppImage", "deb","rpm"],
+      "category": "Utility",
+      "icon": "build/app-icon.png",
+      "extraResources": [
+        { "from": "resources/binaries/linux/yt-dlp", "to": "binaries/yt-dlp" },
+        { "from": "resources/binaries/linux/ffmpeg", "to": "binaries/ffmpeg" },
+        { "from": "resources/binaries/linux/ffprobe", "to": "binaries/ffprobe" },
+        { "from": "resources/binaries/linux/deno", "to": "binaries/deno" }
+      ],
+      "extraFiles": [
+        {
+          "from": "package/com.masteracnolo.freedomloader.metainfo.xml",
+          "to": "usr/share/metainfo/com.masteracnolo.freedomloader.metainfo.xml"
+        }
+      ]
     }
   }
-}
+}

preload.js

@@ -1,23 +1,129 @@
 const { contextBridge, ipcRenderer } = require("electron");
 
+/**
+ * Exposes the main application API to the renderer process.
+ *
+ * This API acts as a secure bridge between the renderer and the
+ * Electron main process using IPC (Inter-Process Communication).
+ * All calls are explicitly whitelisted.
+ */
 contextBridge.exposeInMainWorld("electronAPI", {
+
+  /**
+   * Return process.platform to renderer
+   */
+  getProcessPlatform: () => process.platform,
+
+  /**
+   * Returns the default system download directory.
+   */
   getDefaultDownloadPath: () => ipcRenderer.invoke("get-default-download-path"),
+
+  /**
+   * Opens a native dialog allowing the user to select a download folder.
+   */
   selectDownloadFolder: () => ipcRenderer.invoke("select-download-folder"),
+
+  /**
+   * Sends download progress value to the main process (used for taskbar / UI sync).
+   *
+   * @param {number} percent - Download progress percentage (0–100)
+   */
   setProgress: (percent) => ipcRenderer.send("set-progress", percent),
+
+  /**
+   * Retrieves application feature flags (runtime configuration).
+   */
   getFeatures: () => ipcRenderer.invoke("features"),
-  setFeature: (key, value) => ipcRenderer.invoke("set-feature", { key, value }),
+
+  /**
+   * Updates a feature flag dynamically at runtime.
+   *
+   * @param {string} key - Feature name
+   * @param {any} value - Feature value
+   */
+  setFeature: (key, value) =>
+    ipcRenderer.invoke("set-feature", { key, value }),
+
+  /**
+   * Returns the current application version.
+  */
   getVersion: () => ipcRenderer.invoke("version"),
-  getValidatedDownloadPath: (path) => ipcRenderer.invoke("validate-download-path", path)
+
+  /**
+   * Validates a download path before using it for file operations.
+   *
+   * @param {string} path - Path to validate
+   */
+  getValidatedDownloadPath: (path) =>
+    ipcRenderer.invoke("validate-download-path", path),
+
+  /**
+   * Retrieves available themes from the filesystem or config layer.
+   */
+  getThemes: () => ipcRenderer.invoke("get-themes"),
+
+  /**
+   * Forces a reload of theme files (useful after modification/import).
+   */
+  reloadThemes: () => ipcRenderer.invoke("reload-themes"),
 });
 
-// Contrôles de fenêtre et outils custom pour la topbar
+
+/**
+ * Exposes window control and developer utilities for the custom topbar UI.
+ *
+ * These methods forward commands to the Electron main process via IPC.
+ */
 contextBridge.exposeInMainWorld("topbarAPI", {
+
+  /**
+   * Minimizes the application window.
+   */
   minimize: () => ipcRenderer.send("window-minimize"),
+
+  /**
+   * Toggles maximize/restore state of the application window.
+   */
   maximize: () => ipcRenderer.send("window-maximize"),
+
+  /**
+   * Closes the application window.
+   */
   close: () => ipcRenderer.send("window-close"),
+
+  /**
+   * Opens Chromium DevTools for debugging.
+   */
   openDevTools: () => ipcRenderer.send("open-devtools"),
+
+  /**
+   * Opens application logs directory or log viewer.
+   */
   openLogs: () => ipcRenderer.send("open-logs"),
+
+  /**
+   * Opens the official website or project homepage.
+   */
   openWebsite: () => ipcRenderer.send("open-website"),
+
+  /**
+   * Opens the theme directory or theme editor interface.
+   */
+  openTheme: () => ipcRenderer.send("open-theme"),
+
+  /**
+   * Opens project wiki/documentation.
+   */
   openWiki: () => ipcRenderer.send("open-wiki"),
-  openConfig: () => ipcRenderer.send("open-config")
-});
+
+  /**
+   * Opens the workshop or external content library.
+   */
+  openWorkshop: () => ipcRenderer.send("open-workshop"),
+
+  /**
+   * Opens configuration/settings panel.
+   */
+  openConfig: () => ipcRenderer.send("open-config"),
+});

public/index.html

@@ -9,7 +9,6 @@
     font-src https://fonts.gstatic.com;
     img-src 'self' data: https:;
     ">
-    <title></title>
 
     <link rel="stylesheet" href="styles/styles.css">
     <link rel="stylesheet" href="styles/layout/topbar.css">
@@ -17,20 +16,24 @@
 </head>
 <body>
 
-    <div class="topbar" id="topbar">
-        <div class="custom-controls">
-            <button id="devtools-btn" title="Dev Tools">Tools</button>
-            <button id="logs-btn" title="Logs">Logs</button>
-            <button id="website-btn" title="Website">Website</button>
-            <button id="wiki-btn" title="Wiki">Wiki</button>
+    <header>
+        <div class="topbar" id="topbar">
+            <div class="custom-controls">
+                <button id="devtools-btn" title="Dev Tools">Tools</button>
+                <button id="logs-btn" title="Logs">Logs</button>
+                <button id="website-btn" title="Website">Website</button>
+                <button id="wiki-btn" title="Wiki">Wiki</button>
+                <button id="workshop-btn" title="Workshop">Theme Workshop</button>
+                <!-- <button id="theme-btn" title="Theme">Theme</button> -->
+            </div>
+            <div class="window-controls">
+                <button id="minimize-btn" title="Réduire"><img src="assets/icon/minimize.svg"></button>
+                <button id="maximize-btn" title="Maximiser"><img src="assets/icon/maximize.svg"></button>
+                <button id="close-btn" title="Fermer"><img src="assets/icon/close.svg"></button>
+            </div>
         </div>
-        <div class="window-controls">
-            <button id="minimize-btn" title="Réduire"><img src="assets/icon/minimize.svg"></button>
-            <button id="maximize-btn" title="Maximiser"><img src="assets/icon/maximize.svg"></button>
-            <button id="close-btn" title="Fermer"><img src="assets/icon/close.svg"></button>
-        </div>
-    </div>
-    
+    </header>
+
     <button class="settings-button" id="settings-button">
         <svg width="800px" height="800px" viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg"><title>ionicons-v5-q</title><path d="M262.29,192.31a64,64,0,1,0,57.4,57.4A64.13,64.13,0,0,0,262.29,192.31ZM416.39,256a154.34,154.34,0,0,1-1.53,20.79l45.21,35.46A10.81,10.81,0,0,1,462.52,326l-42.77,74a10.81,10.81,0,0,1-13.14,4.59l-44.9-18.08a16.11,16.11,0,0,0-15.17,1.75A164.48,164.48,0,0,1,325,400.8a15.94,15.94,0,0,0-8.82,12.14l-6.73,47.89A11.08,11.08,0,0,1,298.77,470H213.23a11.11,11.11,0,0,1-10.69-8.87l-6.72-47.82a16.07,16.07,0,0,0-9-12.22,155.3,155.3,0,0,1-21.46-12.57,16,16,0,0,0-15.11-1.71l-44.89,18.07a10.81,10.81,0,0,1-13.14-4.58l-42.77-74a10.8,10.8,0,0,1,2.45-13.75l38.21-30a16.05,16.05,0,0,0,6-14.08c-.36-4.17-.58-8.33-.58-12.5s.21-8.27.58-12.35a16,16,0,0,0-6.07-13.94l-38.19-30A10.81,10.81,0,0,1,49.48,186l42.77-74a10.81,10.81,0,0,1,13.14-4.59l44.9,18.08a16.11,16.11,0,0,0,15.17-1.75A164.48,164.48,0,0,1,187,111.2a15.94,15.94,0,0,0,8.82-12.14l6.73-47.89A11.08,11.08,0,0,1,213.23,42h85.54a11.11,11.11,0,0,1,10.69,8.87l6.72,47.82a16.07,16.07,0,0,0,9,12.22,155.3,155.3,0,0,1,21.46,12.57,16,16,0,0,0,15.11,1.71l44.89-18.07a10.81,10.81,0,0,1,13.14,4.58l42.77,74a10.8,10.8,0,0,1-2.45,13.75l-38.21,30a16.05,16.05,0,0,0-6.05,14.08C416.17,247.67,416.39,251.83,416.39,256Z" style="fill:none;stroke:var(--settings-button-text-color);stroke-linecap:round;stroke-linejoin:round;stroke-width:32px"/></svg>
     </button>
@@ -52,12 +55,18 @@
 
                 <div class="setting-item" id="theme" style="margin-left: 32px;">
                     <div class="setting-info">
-                        <div style="display: flex;">
+                        <div style="display: flex; align-items: center; gap: 10px;">
                         <span class="setting-title">Thème</span>
 
                         <select id="themeSelect" data-key="theme" aria-label="Choisir le thème">
 
                         </select>
+                        <button id="refresh-themes-btn" title="Refresh themes" class="refresh-themes-btn">
+                            <svg width="18" height="18" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+                                <path d="M1 4v6h6M23 20v-6h-6" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+                                <path d="M20.49 9A9 9 0 0 0 5.64 5.64L1 10m22 4l-4.64 4.36A9 9 0 0 1 3.51 15" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+                            </svg>
+                        </button>
                         </div>
                         <small>Choose the theme of the application</small>
                     </div>
@@ -80,20 +89,20 @@
                     </div>
                 </div>
 
-                <!-- <div class="setting-item">
+                <div class="setting-item">
+                    <input type="checkbox" data-key="createPlaylistFolders" id="createPlaylistFolders">
+                    <div class="setting-info">
+                    <span class="setting-title">Create Playlist Folders</span>
+                    <small>Create a dedicated folder for each playlist with its name.</small>
+                    </div>
+                </div>
+
+                <div class="setting-item">
                     <input type="checkbox" data-key="notifySystem" id="notifySystem">
                     <div class="setting-info">
                     <span class="setting-title">Notification at the end</span>
                     <small>Notify when a download finishes.</small>
                     </div>
-                </div> -->
-
-                <div class="setting-item">
-                    <input type="checkbox" data-key="customTopBar" id="customTopBar">
-                    <div class="setting-info">
-                    <span class="setting-title">Custom Top bar</span>
-                    <small>Use this if the topbar is missing or you prefer a custom one.</small>
-                    </div>
                 </div>
 
                 <div class="setting-item">
@@ -142,6 +151,14 @@
                     </div>
                 </div>
 
+                <div class="setting-item">
+                    <input type="checkbox" data-key="customTopBar" id="customTopBar">
+                    <div class="setting-info">
+                    <span class="setting-title">Custom Top bar</span>
+                    <small>Use this if the topbar is missing or you prefer a custom one.</small>
+                    </div>
+                </div>
+
                 <div class="setting-item" style="margin-left: 32px; margin-top: 20px;">
                     <div class="setting-info">
                         <span class="setting-title">Custom Codec</span>
@@ -158,28 +175,20 @@
                     </div>
                 </div>
 
+                <div class="setting-item">
+                    <input type="checkbox" data-key="enableHardwareAcceleration" id="enableHardwareAcceleration">
+                    <div class="setting-info">
+                    <span class="setting-title">Enable Hardware Acceleration</span>
+                    <small>Uses GPU acceleration for rendering when available. <br> (Be effective on next launch)</small>
+                    </div>
+                </div>
+
                 </details>
 
                 <!-- Developer Settings -->
                 <details class="settings-section">
                 <summary>Developer Settings</summary>
 
-                <!-- <div class="setting-item">
-                    <input type="checkbox" data-key="downloadSystem" id="downloadSystem">
-                    <div class="setting-info">
-                    <span class="setting-title">Download System</span>
-                    <small>Enable/disable the internal download system.</small>
-                    </div>
-                </div> -->
-
-                <!-- <div class="setting-item">
-                    <input type="checkbox" data-key="logSystem" id="logSystem">
-                    <div class="setting-info">
-                    <span class="setting-title">Log System</span>
-                    <small>Enable logging system.</small>
-                    </div>
-                </div> -->
-
                 <div class="setting-item">
                     <input type="checkbox" data-key="verboseLogs" id="verboseLogs">
                     <div class="setting-info">
@@ -191,6 +200,7 @@
                 </details>
 
                 <div class="settings-footer">
+                <button id="open-theme">Open Theme Folder</button>
                 <button id="open-json-btn">Open JSON Configuration</button>
             </div>
 
@@ -198,78 +208,89 @@
         </div>
     </div>
  
-    <div class="container" id="container">
+    <main>
+        <div class="container" id="container">
+            <h1 id="title"> Freedom Loader </h1>
+            <p id="subtitle"> Because why not? </p>
+            
+            <form action="/download" method="POST" id="downloadForm">
+                <div class="url-input-container">
+                    <input type="text" name="url" placeholder="URL" id="UrlInput">
+                    <button type="button" id="pasteBtn" class="paste-btn" title="Paste from clipboard">
+                        <svg width="20" height="20" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+                            <path d="M9 5H7C5.89543 5 5 5.89543 5 7V19C5 20.1046 5.89543 21 7 21H17C18.1046 21 19 20.1046 19 19V7C19 5.89543 18.1046 5 17 5H15M9 5C9 6.10457 9.89543 7 11 7H13C14.1046 7 15 6.10457 15 5M9 5C9 3.89543 9.89543 3 11 3H13C14.1046 3 15 3.89543 15 5M12 12H15M12 16H15M9 12H9.01M9 16H9.01" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+                        </svg>
+                    </button>
+                </div>
+
+                <label class="checkbox-inline">
+
+                    <label class="checkbox-mp3">
+                        <input type="checkbox" name="audioOnly" value="1">
+                        <div class="checkmark"></div>
+                    </label>
+                    Audio Only (MP3)
+                </label>
+                <select name="quality">
+                    <option value="best">Best Quality</option>
+                    <option value="medium">Medium Quality</option>
+                    <option value="worst">Lowest Quality</option>
+                    <option value="1080">1080p</option>
+                    <option value="720">720p</option>
+                    <option value="480">480p</option>
+                </select>
+
+                <button type="submit" onclick="startProgress()">Download</button>
+            </form>
+
+            </div>
+
+            <div class="download-path">
+                    Will be save on <span id="savePath"></span> 
+                    <button id="changePath">Edit</button>
+            </div>
+
+            <div class="progress-container">
+                <div id="downloadStage" style="display: none; font-size: 0.85rem; color: var(--default-text-color); margin-top: 8px;"></div>
+                <div id="downloadProgressWrapper">
+                    <div id="downloadProgress"></div>   
+                </div>
+                <div style="display: flex; gap: 20px; align-items: center;">
+                    <div id="downloadProgressText"></div> 
+                    <div id="downloadSpeedText"></div>
+                    <div id="playlistInfoText" style="display: none; font-size: 0.9rem;"></div>
+                    <button type="button" id="stopBtn" onclick="stopDownload()" class="stop-btn" style="display:none;" title="Stop download">■</button>
+                </div>
+            </div>
+
+            <div id="downloadStatus" style="display: none;"></div>
+
+            <div class="infos-container">
+
+                <div id="loaderBox" class="loader-box" style="display:none;">
+                    <div></div>
+                    <div></div>
+                    <div></div>
+                    <span>Fetching info...</span>
+                </div>
+
+                <div id="videoInfo" style="margin-top: 20px;"></div>
+            </div>
+
+            <span id="version-badge" class="version-badge"></span>
 
-    <header>
-        <h1 id="title"> Freedom Loader </h1>
-        <p id="subtitle"> Because why not? </p>
-    </header>
-    
-    <form action="/download" method="POST" id="downloadForm">
-        <div class="url-input-container">
-            <input type="text" name="url" placeholder="URL" id="UrlInput">
-            <button type="button" id="pasteBtn" class="paste-btn" title="Paste from clipboard">
-                <svg width="20" height="20" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
-                    <path d="M9 5H7C5.89543 5 5 5.89543 5 7V19C5 20.1046 5.89543 21 7 21H17C18.1046 21 19 20.1046 19 19V7C19 5.89543 18.1046 5 17 5H15M9 5C9 6.10457 9.89543 7 11 7H13C14.1046 7 15 6.10457 15 5M9 5C9 3.89543 9.89543 3 11 3H13C14.1046 3 15 3.89543 15 5M12 12H15M12 16H15M9 12H9.01M9 16H9.01" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
-                </svg>
-            </button>
         </div>
+    </main>
 
-        <label class="checkbox-inline">
-
-            <label class="checkbox-mp3">
-                <input type="checkbox" name="audioOnly" value="1">
-                <div class="checkmark"></div>
-            </label>
-            Audio Only (MP3)
-        </label>
-        <select name="quality">
-            <option value="best">Best Quality</option>
-            <option value="medium">Medium Quality</option>
-            <option value="worst">Lowest Quality</option>
-            <option value="1080">1080p</option>
-            <option value="720">720p</option>
-            <option value="480">480p</option>
-        </select>
-
-        <button type="submit" onclick="startProgress()">Download</button>
-    </form>
-    </div>
-
-    <div class="download-path">
-            Will be save on <span id="savePath"></span> 
-            <button id="changePath">Edit</button>
-    </div>
-
-    <div id="downloadProgressWrapper">
-        <div id="downloadProgress"></div>   
-    </div>
-
-    <div style="display: flex; gap: 20px;">
-        <div id="downloadProgressText"></div> 
-        <div id="downloadSpeedText"></div>
-    </div>
-
-    <div id="downloadStatus"></div>
-
-    <div class="infos-container">
-
-        <div id="loaderBox" class="loader-box" style="display:none;">
-            <div></div>
-            <div></div>
-            <div></div>
-            <span>Fetching info...</span>
-        </div>
-
-        <div id="videoInfo" style="margin-top: 20px;"></div>
-    </div>
-
-    <span id="version-badge" class="version-badge"></span>
+    <!-- Toast Container -->
+    <div id="toast-container"></div>
 
     <h2 id="reference"> Because Why Not ? </h2>
 
     
     <!-- Scripts -->
+    <script src="script/toast.js"></script>
+    <script src="script/customConfiguration.js"></script>
     <script src="script/clipboardPaste.js"></script>
     <script src="script/custompath.js"></script>
     <script src="script/settingsPanel.js"></script>

public/script/appVersion.js

@@ -1,8 +1,21 @@
-async function versionLabel(){
-    const appVersion = await window.electronAPI.getVersion();
+/**
+ * Retrieves the application version from the Electron main process
+ * and displays it in the UI version badge (bottom-right corner).
+ *
+ * This is mainly used for debugging and build identification.
+ */
+async function versionLabel() {
+  const appVersion = await window.electronAPI.getVersion();
 
-    // Write in front the app version for debugging (bottom right)
-    document.getElementById("version-badge").textContent = `v${appVersion}`;
-};
+    /**
+     * UI element displaying the current application version.
+     * Updated at runtime after IPC call resolves.
+     */
+    const versionBadge = document.getElementById("version-badge");
+
+    if (!versionBadge) return;
+
+    versionBadge.textContent = `${appVersion}`;
+}
 
 versionLabel();

public/script/clipboardPaste.js

@@ -1,35 +1,40 @@
-// Clipboard paste functionality for URL input
-document.addEventListener('DOMContentLoaded', () => {
-    const pasteBtn = document.getElementById('pasteBtn');
-    const urlInput = document.getElementById('UrlInput');
+/**
+ * Initializes clipboard paste functionality for the URL input field.
+ *
+ * When the user clicks the paste button, the system attempts to read
+ * the clipboard content and inject it into the URL input field.
+ * It also triggers an input event to notify any bound listeners.
+ */
+document.addEventListener("DOMContentLoaded", () => {
+  const pasteBtn = document.getElementById("pasteBtn");
+  const urlInput = document.getElementById("UrlInput");
 
-    if (pasteBtn && urlInput) {
-        pasteBtn.addEventListener('click', async () => {
-            try {
-                // Read text from clipboard
-                const text = await navigator.clipboard.readText();
-                
-                // Paste into the URL input
-                urlInput.value = text;
-                
-                // Trigger input event to ensure any listeners are notified
-                urlInput.dispatchEvent(new Event('input', { bubbles: true }));
-                
-                // Optional: Focus the input
-                urlInput.focus();
-                
-                // Visual feedback
-                pasteBtn.style.backgroundColor = 'var(--form-button-bg-hover-color)';
-                setTimeout(() => {
-                    pasteBtn.style.backgroundColor = '';
-                }, 200);
-                
-            } catch (err) {
-                console.error('Failed to read clipboard:', err);
-                
-                // Fallback: prompt user if clipboard API fails
-                alert('Unable to access clipboard. Please paste manually using Ctrl+V.');
-            }
-        });
+  if (!pasteBtn || !urlInput) return;
+
+  /**
+   * Handles clipboard paste action triggered by the paste button.
+   * Reads clipboard text and inserts it into the URL input field.
+   */
+  pasteBtn.addEventListener("click", async () => {
+    try {
+      urlInput.value = await navigator.clipboard.readText();
+
+      // Notify frameworks / listeners bound to input changes
+      urlInput.dispatchEvent(new Event("input", { bubbles: true }));
+
+      urlInput.focus();
+
+      // Temporary UI feedback on paste action
+      pasteBtn.style.backgroundColor = "var(--form-button-bg-hover-color)";
+      setTimeout(() => {
+        pasteBtn.style.backgroundColor = "";
+      }, 200);
+    } catch (err) {
+      console.error("Clipboard access failed:", err);
+
+      alert(
+        "Unable to access clipboard. Please paste manually using Ctrl+V."
+      );
     }
-});
+  });
+});

public/script/customConfiguration.js

@@ -0,0 +1,30 @@
+async function initPlatformRestrictions() {
+  const platform = await window.electronAPI.getProcessPlatform();
+
+  const themeSelect = document.getElementById("themeSelect");
+  const refreshBtn = document.getElementById("refresh-themes-btn");
+
+  /**
+   * Is the OS windows
+   * @type {boolean}
+   */
+  const isWindows = platform === "win32";
+
+  console.log(isWindows);
+
+  // If it's windows, the button is not disabled.
+  themeSelect.disabled = !isWindows;
+  refreshBtn.disabled = !isWindows;
+
+  themeSelect.classList.toggle("disabled", !isWindows);
+  refreshBtn.classList.toggle("disabled", !isWindows);
+
+  if (!isWindows) {
+    themeSelect.title = "Themes are only available on Windows";
+    refreshBtn.title = "Themes are only available on Windows";
+  }
+}
+
+document.addEventListener('DOMContentLoaded', function(){
+    initPlatformRestrictions();
+})

public/script/custompath.js

@@ -1,9 +1,24 @@
+/**
+ * Initializes the download path system once the UI is ready.
+ *
+ * Responsibilities:
+ * - Restore last known user-selected download path (localStorage)
+ * - Validate it against backend rules
+ * - Synchronize with backend authoritative path
+ * - Setup folder selection UI interaction
+ */
 window.addEventListener("DOMContentLoaded", async () => {
   const savePathElem = document.getElementById("savePath");
   const form = document.getElementById("downloadForm");
 
-  // input caché = DERNIER chemin validé par le back
+  /**
+   * Hidden form field storing the validated download path
+   * used during download submission.
+   *
+   * Created dynamically if not already present in DOM.
+   */
   let hidden = document.getElementById("savePathInput");
+  
   if (!hidden) {
     hidden = document.createElement("input");
     hidden.type = "hidden";
@@ -12,12 +27,32 @@ window.addEventListener("DOMContentLoaded", async () => {
     form.appendChild(hidden);
   }
 
+  /**
+   * Applies a validated download path received from backend.
+   *
+   * Updates:
+   * - UI display (visible path)
+   * - tooltip (full path)
+   * - hidden form input (used for submission)
+   * - localStorage cache (UX persistence only, not authoritative)
+   *
+   * @param {string} path - validated absolute download path
+   */
   async function applyPathFromBack(path) {
     savePathElem.textContent = path;
+    savePathElem.title = path; 
     hidden.value = path;
     localStorage.setItem("customDownloadPath", path); // UX only
   }
 
+  /**
+   * Loads the initial download path on application startup.
+   *
+   * Priority order:
+   * 1. cached localStorage value (UX only, not trusted)
+   * 2. backend validated version of cached path
+   * 3. backend default fallback path if validation fails
+   */
   async function loadInitialPath() {
     // On affiche ce que le user a vu la dernière fois (UX)
     const cached = localStorage.getItem("customDownloadPath");
@@ -41,13 +76,16 @@ window.addEventListener("DOMContentLoaded", async () => {
 
   await loadInitialPath();
 
-  document
-    .getElementById("changePath")
-    .addEventListener("click", async () => {
+  /**
+   * Opens system folder selector and updates download path.
+   *
+   * The selected folder is validated by Electron backend
+   * before being applied to the UI and persisted.
+   */
+  document.getElementById("changePath").addEventListener("click", async () => {
       try {
         // selectDownloadFolder already returns a validated path
-        const validatedPath =
-          await window.electronAPI.selectDownloadFolder();
+        const validatedPath = await window.electronAPI.selectDownloadFolder();
 
         if (!validatedPath) return; // cancelled
 

public/script/customthemes.js

@@ -1,62 +1,256 @@
-const themes = {
-  dark:       { label: "Sombre", subtitle: "Darkness is my ally" },
-  light:      { label: "Clair", subtitle: "Qui aime ce thème ?" },
-  neon:       { label: "Purple", subtitle: "How was your day ?"},
-  nf:         { label: "NF", subtitle: "You call it music, i call it my Therapist" },
-  songbird:   { label: "Songbird", subtitle: "From Her to Eternity" },
-  drift:      { label: "Drift", subtitle: "Si la route t'appelle, contre appel" },
-  fanatic:    { label: "Fanatic", subtitle: "Always Fnatic !" },
-  chirac:     { label: "Chirac", subtitle: "J'aime les pommes" },
-  spicy:      { label: "Spicy", subtitle: "The Spiciest One" },
-};
-
 const themeSelect = document.getElementById("themeSelect");
+/**
+ * Currently selected themes loaded from backend.
+ * Used as cache for UI theme switching.
+ */
+let loadedThemes = [];
 
-function populateThemeSelect() {
-  for (const [themeKey, themeInfo] of Object.entries(themes)) {
+/**
+ * Applies a theme object to the application UI by mapping
+ * theme configuration values to CSS variables and DOM properties.
+ *
+ * This function mutates:
+ * - document.body (background styling)
+ * - :root CSS variables (design system tokens)
+ * - subtitle DOM element (theme metadata display)
+ *
+ * @param {Object} theme - Theme definition object
+ * @param {Object} theme.style - Style configuration
+ */
+function applyTheme(theme) {
+  const root = document.documentElement;
+  const style = theme.style;
+
+  // Background
+  if (theme.image) {
+    document.body.style.backgroundImage = `url('${theme.image}')`;
+    document.body.style.backgroundSize = style.background?.size || "cover";
+    document.body.style.backgroundPosition = style.background?.position || "center";
+    document.body.style.backgroundAttachment = style.background?.attachment || "fixed";
+  } else {
+    document.body.style.backgroundImage = "";
+  }
+
+  // CSS variables (design tokens)
+  root.style.setProperty("--background-color", style.colors?.background || "#121212");
+  root.style.setProperty("--default-text-color", style.colors?.text?.default || "#e0e0e0");
+  root.style.setProperty("--subtitle-color", style.colors?.text?.subtitle || "#2196f3");
+  root.style.setProperty("--audio-only-label-color", style.colors?.text?.audioOnly || "#f5f5f5");
+
+  root.style.setProperty("--form-bg-color", style.form?.background || "#1e1e1e");
+  root.style.setProperty("--form-input-bg-color", style.form?.input?.background || "#2a2a2a");
+  root.style.setProperty("--form-input-border-color", style.form?.input?.border || "#444444");
+  root.style.setProperty("--form-input-border-focus-color", style.form?.input?.borderFocus || "#2196f3");
+  root.style.setProperty("--form-input-text-color", style.form?.input?.text || "#f5f5f5");
+  root.style.setProperty("--form-input-placeholder-color", style.form?.input?.placeholder || "#888888");
+  root.style.setProperty("--form-button-bg-color", style.form?.button?.background || "#2196f3");
+  root.style.setProperty("--form-button-text-color", style.form?.button?.text || "#ffffff");
+  root.style.setProperty("--form-button-bg-hover-color", style.form?.button?.hover || "#1976d2");
+  root.style.setProperty("--paste-button-icon-color", style.form?.pasteButtonIcon || "#ffffff");
+
+  root.style.setProperty("--checkbox-unchecked-bg-color", style.checkbox?.background?.unchecked || "#555555");
+  root.style.setProperty("--checkbox-checked-bg-color", style.checkbox?.background?.checked || "#2196f3");
+  root.style.setProperty("--checkbox-checkmark-border-color", style.checkbox?.checkmarkBorder || "#ffffff");
+  root.style.setProperty("--checkbox-pulse-color", style.checkbox?.pulse || "rgba(33, 150, 243, 0.5)");
+
+  root.style.setProperty("--download-status-color", style.download?.status || "#2196f3");
+
+  root.style.setProperty("--progress-bar-bg-color", style.progressBar?.background || "#444444");
+  root.style.setProperty("--progress-bar-fill-color", style.progressBar?.fill || "#2196f3");
+
+  root.style.setProperty("--video-info-bg-color", style.videoInfo?.background || "#1a1a1a");
+  root.style.setProperty("--video-info-text-color", style.videoInfo?.text || "#e0e0e0");
+  root.style.setProperty("--video-info-heading-color", style.videoInfo?.heading || "#2196f3");
+  root.style.setProperty("--video-info-list-color", style.videoInfo?.list || "#cccccc");
+  root.style.setProperty("--video-info-list-strong-color", style.videoInfo?.strong || "#ffffff");
+  root.style.setProperty("--video-info-link-color", style.videoInfo?.link || "#2196f3");
+  root.style.setProperty("--video-info-link-hover-color", style.videoInfo?.linkHover || "#1976d2");
+
+  root.style.setProperty("--playlist-background-color", style.playlist?.background || "#303030");
+
+  root.style.setProperty("--settings-button-bg-color", style.settings?.button?.background || "#1e1e1e");
+  root.style.setProperty("--settings-button-text-color", style.settings?.button?.text || "#e0e0e0");
+  root.style.setProperty("--open-theme-button-bg-color", style.settings?.openThemeButton?.background || "#2196f3");
+  root.style.setProperty("--open-theme-button-text-color", style.settings?.openThemeButton?.text || "#ffffff");
+  root.style.setProperty("--open-json-button-bg-color", style.settings?.openJsonButton?.background || style.settings?.button?.background || "#1e1e1e");
+  root.style.setProperty("--open-json-button-text-color", style.settings?.openJsonButton?.text || style.settings?.button?.text || "#e0e0e0");
+  root.style.setProperty("--settings-modal-bg-color", style.settings?.background?.modal || "#1e1e1e");
+  root.style.setProperty("--settings-section-bg-color", style.settings?.background?.section || "#2a2a2a");
+  root.style.setProperty("--settings-text-color", style.settings?.text || "#e0e0e0");
+  root.style.setProperty("--settings-subtitle-color", style.settings?.subtitle || "#aaaaaa");
+
+  const subtitleEl = document.getElementById("subtitle");
+  if (subtitleEl) subtitleEl.textContent = theme.subtitle || theme.name;
+}
+
+/**
+ * Persists selected theme ID into Electron backend features storage.
+ *
+ * @param {string} themeId
+ */
+function saveTheme(themeId) {
+  window.electronAPI.setFeature("theme", themeId);
+}
+
+/**
+ * Populates theme dropdown selector with available themes.
+ *
+ * @param {Array} themes
+ */
+function populateThemeSelect(themes) {
+  themeSelect.innerHTML = "";
+
+  for (const theme of themes) {
     const option = document.createElement("option");
-    option.value = themeKey;        
-    option.textContent = themeInfo.label; 
+    option.value = theme.id;
+    option.textContent = theme.name;
     themeSelect.appendChild(option);
   }
 }
 
-function applyTheme(themeKey) {
-  document.body.classList.remove(...Object.keys(themes));
-  document.body.classList.add(themeKey);
+/**
+ * Initializes theme system:
+ * - loads themes from backend
+ * - restores saved theme
+ * - applies selected theme
+ */
+async function initThemes() {
+  loadedThemes = await window.electronAPI.getThemes();
 
-  const subtitleElement = document.getElementById("subtitle");
-  if (subtitleElement && themes[themeKey]) {
-    subtitleElement.textContent = themes[themeKey].subtitle;
+  if (!loadedThemes.length) {
+    const defaultTheme = {
+      id: "dark",
+      name: "Dark",
+      subtitle: "Darkness is my ally",
+      style: {
+        background: {
+          size: "cover",
+          position: "center",
+          attachment: "fixed"
+        },
+
+        colors: {
+          background: "#121212",
+          text: {
+            default: "#e0e0e0",
+            subtitle: "#2196f3",
+            audioOnly: "#f5f5f5"
+          }
+        },
+
+        form: {
+          background: "#1e1e1e",
+          input: {
+            background: "#2a2a2a",
+            border: "#444444",
+            borderFocus: "#2196f3",
+            text: "#f5f5f5",
+            placeholder: "#888888"
+          },
+          button: {
+            background: "#2196f3",
+            text: "#ffffff",
+            hover: "#1976d2"
+          },
+          pasteButtonIcon: "#ffffff"
+        },
+
+        checkbox: {
+          background: {
+            unchecked: "#555555",
+            checked: "#2196f3"
+          },
+          checkmarkBorder: "#ffffff",
+          pulse: "rgba(33, 150, 243, 0.5)"
+        },
+
+        download: {
+          status: "#2196f3"
+        },
+
+        progressBar: {
+          background: "#444444",
+          fill: "#2196f3"
+        },
+
+        videoInfo: {
+          background: "#1a1a1a",
+          text: "#e0e0e0",
+          heading: "#2196f3",
+          list: "#cccccc",
+          strong: "#ffffff",
+          link: "#2196f3",
+          linkHover: "#1976d2"
+        },
+
+        playlist: {
+          background: "#303030"
+        },
+
+        settings: {
+          button: {
+            background: "#1e1e1e",
+            text: "#e0e0e0"
+          },
+          openThemeButton: {
+            background: "#2196f3",
+            text: "#ffffff"
+          },
+          openJsonButton: {
+            background: "#2196f3",
+            text: "#ffffff"
+          },
+          background: {
+            modal: "#1e1e1e",
+            section: "#2a2a2a"
+          },
+          text: "#e0e0e0",
+          subtitle: "#aaaaaa"
+        }
+      }
+    };
+
+    loadedThemes = [defaultTheme];
   }
 
+  populateThemeSelect(loadedThemes);
+
+  const features = await window.electronAPI.getFeatures();
+  const savedId = features.theme;
+
+  const theme = loadedThemes.find(t => t.id === savedId) || loadedThemes[0];
+
+  themeSelect.value = theme.id;
+  applyTheme(theme);
 }
 
-function saveTheme(themeKey) {
-  localStorage.setItem("selectedTheme", themeKey);
-}
+/**
+ * Handles theme selection change from UI dropdown.
+ */
+themeSelect.addEventListener("change", (e) => {
+  const theme = loadedThemes.find(t => t.id === e.target.value);
+  if (!theme) return;
 
-function loadTheme() {
-  const savedTheme = localStorage.getItem("selectedTheme");
-
-  if (savedTheme && themes[savedTheme]) {
-    applyTheme(savedTheme);
-    themeSelect.value = savedTheme;
-  } else {
-    applyTheme("dark");
-    themeSelect.value = "dark";
-  }
-}
-
-// When the user changes the theme from the select
-themeSelect.addEventListener("change", (event) => {
-  const selectedTheme = event.target.value;
-  if (themes[selectedTheme]) {
-    applyTheme(selectedTheme);
-    saveTheme(selectedTheme);
-  }
+  applyTheme(theme);
+  saveTheme(theme.id);
 });
 
-// Initialisation
-populateThemeSelect();
-loadTheme();
+/**
+ * Reloads themes from backend and reapplies current selection.
+ */
+async function refreshThemes() {
+  loadedThemes = await window.electronAPI.reloadThemes();
+  populateThemeSelect(loadedThemes);
+
+  const features = await window.electronAPI.getFeatures();
+  const savedId = features.theme;
+
+  const theme = loadedThemes.find(t => t.id === savedId) || loadedThemes[0];
+
+  themeSelect.value = theme.id;
+  applyTheme(theme);
+}
+
+window.refreshThemes = refreshThemes;
+
+initThemes();

public/script/downloadstatus.js

@@ -1,11 +1,55 @@
 const form = document.getElementById("downloadForm");
 const statusDiv = document.getElementById("downloadStatus");
-const button = form.querySelector("button");
+const button = form.querySelector("button[type=\"submit\"]");
+const stopBtn = document.getElementById("stopBtn");
 
+/**
+ * Indicates whether a download process is currently active.
+ * Used to prevent duplicate submissions and to gate UI actions
+ * such as disabling the form or showing progress.
+ */
+let isDownloading = false;
+
+/**
+ * Indicates whether the current download was explicitly
+ * stopped by the user via the cancel action.
+ *
+ * Used to differentiate between:
+ * - user-initiated cancellation
+ * - failures or natural completion
+ */
+let userStoppedDownload = false;
+
+
+
+/**
+ * Handles download form submission.
+ *
+ * - Validates user input (URL)
+ * - Disables UI during download
+ * - Sends request to backend `/download`
+ * - Manages success / error states
+ * - Restores UI state after completion
+ */
 form.addEventListener("submit", async (e) => {
   e.preventDefault();
-  button.disabled = true; // Avoid multiple clicks
-  statusDiv.textContent = "Download in progress...";
+  
+  const urlInput = form.querySelector("input[name='url']");
+  const url = urlInput.value.trim();
+  
+  // Basic URL validation
+  if (!url) {
+    window.showError("Please enter a URL");
+    return;
+  }
+  
+  button.disabled = true;
+  statusDiv.style.display = "none";
+  isDownloading = true;
+  userStoppedDownload = false;
+
+  // Show progress UI immediately with initial message
+  showInitialProgress();
 
   const formData = new FormData(form);
   const params = new URLSearchParams(formData);
@@ -18,20 +62,113 @@ form.addEventListener("submit", async (e) => {
     });
 
     if (!res.ok) {
-      statusDiv.textContent = res;
+      if (!userStoppedDownload) {
+        const errorText = await res.text();
+        window.showError(errorText);
+        resetProgressBar();
+      }
       return;
     }
 
-    const text = await res.text();
-    statusDiv.textContent = text;
+    // Download successful - check if notifications are enabled
+    const features = await window.electronAPI.getFeatures();
+    if (features.notifySystem) {
+      window.showSuccess("Download completed!");
+    }
 
-  } catch {
-    statusDiv.textContent = "❌ An Error has Occured.";
+  } catch (err) {
+    if (!isDownloading && !userStoppedDownload) {
+      statusDiv.style.display = "none";
+    }
   } finally {
+    isDownloading = false;
     button.disabled = false;
-
-    setTimeout(() => {
-      statusDiv.textContent = "";
-    }, 5000);
+    stopBtn.style.display = "none";
   }
-});
+});
+
+/**
+ * Displays initial download progress UI immediately
+ * when a download starts.
+ *
+ * Initializes progress bar, speed indicator, stage text
+ * and shows the stop button.
+ */
+function showInitialProgress() {
+  const progressWrapper = document.getElementById("downloadProgressWrapper");
+  const progressBarText = document.getElementById("downloadProgressText");
+  const speedElement = document.getElementById("downloadSpeedText");
+  const stageElement = document.getElementById("downloadStage");
+  const stopBtn = document.getElementById("stopBtn");
+  
+  if (progressWrapper) progressWrapper.style.display = "block";
+  if (progressBarText) {
+    progressBarText.style.display = "block";
+    progressBarText.innerHTML = "0%";
+  }
+  if (speedElement) {
+    speedElement.style.display = "block";
+    speedElement.textContent = "0 Mib/s";
+  }
+  if (stageElement) {
+    stageElement.style.display = "block";
+    stageElement.textContent = "Retrieving data...";
+  }
+  if (stopBtn) stopBtn.style.display = "inline-flex";
+}
+
+/**
+ * Cancels the current download process.
+ *
+ * Sends a request to backend `/download/cancel`,
+ * updates UI state and resets progress indicators.
+ *
+ * Prevents duplicate calls if no download is active.
+ */
+async function stopDownload() {
+  if (!isDownloading) return;
+
+  userStoppedDownload = true;
+  button.disabled = true;
+  stopBtn.disabled = true;
+
+  try {
+    await fetch("/download/cancel", {
+      method: "POST",
+      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    });
+    
+    window.showWarning("Download stopped");
+  } catch (err) {
+    console.error("Error stopping download:", err);
+  } finally {
+    isDownloading = false;
+    button.disabled = false;
+    stopBtn.disabled = false;
+    stopBtn.style.display = "none";
+    resetProgressBar();
+  }
+}
+
+/**
+ * Resets all download progress UI elements to their
+ * default hidden state.
+ *
+ * Used after completion or cancellation of a download.
+ */
+function resetProgressBar() {
+  const progressWrapper = document.getElementById("downloadProgressWrapper");
+  if (progressWrapper) progressWrapper.style.display = "none";
+  
+  const progressBar = document.getElementById("downloadProgress");
+  if (progressBar) progressBar.style.width = "0%";
+
+  const progressBarText = document.getElementById("downloadProgressText");
+  if (progressBarText) progressBarText.style.display = "none";
+
+  const speedElement = document.getElementById("downloadSpeedText");
+  if (speedElement) speedElement.style.display = "none";
+
+  const playlistInfoElement = document.getElementById("playlistInfoText");
+  if (playlistInfoElement) playlistInfoElement.style.display = "none";
+}

public/script/fetchinfo.js

@@ -1,12 +1,33 @@
+/**
+ * Converts a raw upload date string (format YYYYMMDD)
+ * into a human-readable format (DD/MM/YYYY).
+ *
+ * Returns "Inconnue" if the input is invalid or malformed.
+ */
 function formatDate(dateStr) {
   if (!dateStr || dateStr.length !== 8) return "Inconnue";
   return `${dateStr.slice(6,8)}/${dateStr.slice(4,6)}/${dateStr.slice(0,4)}`;
 }
 
+/**
+ * Converts a file size in bytes into megabytes (MB).
+ *
+ * Returns a formatted string with 2 decimals (e.g. "12.34 Mo").
+ * If input is falsy, returns "Inconnue".
+ */
 function formatSize(bytes) {
   return bytes ? (bytes / (1024*1024)).toFixed(2) + " Mo" : "Inconnue";
 }
 
+/**
+ * Fetches video or playlist metadata from the backend `/info` endpoint.
+ *
+ * Sends a POST request with URL-encoded body.
+ * Handles network errors, HTTP errors and JSON parsing safely.
+ *
+ * @param {string} url - Video or playlist URL
+ * @returns {Promise<Object>} Parsed metadata or error object
+ */
 async function fetchVideoInfo(url) {
   try {
     const res = await fetch("/info", {
@@ -26,13 +47,34 @@ async function fetchVideoInfo(url) {
   }
 }
 
-
+/**
+ * Initializes the video info system UI.
+ *
+ * - Listens to URL input changes
+ * - Automatically fetches video/playlist metadata if enabled
+ * - Renders either playlist UI or single video UI
+ * - Handles loading states and caching (lastFetchedUrl)
+ *
+ * Also manages dynamic playlist title injection into the form.
+ */
 async function init() {
 
+  // Main input listener: triggers auto-fetch when URL changes
   document.addEventListener("DOMContentLoaded", () => {
     const urlInput = document.getElementById("UrlInput");
     const infoDiv = document.getElementById("videoInfo");
     const loaderBox = document.getElementById("loaderBox");
+    const form = document.getElementById("downloadForm");
+
+    // Input caché pour stocker le titre de la playlist
+    let playlistTitleInput = document.getElementById("playlistTitle");
+    if (!playlistTitleInput) {
+      playlistTitleInput = document.createElement("input");
+      playlistTitleInput.type = "hidden";
+      playlistTitleInput.name = "playlistTitle";
+      playlistTitleInput.id = "playlistTitle";
+      form.appendChild(playlistTitleInput);
+    }
 
     let lastFetchedUrl = "";
 
@@ -47,6 +89,7 @@ async function init() {
       if (!url || url.length < 2) {
         infoDiv.innerHTML = "";
         infoDiv.classList.remove("visible", "playlist-mode");
+        playlistTitleInput.value = "";
         lastFetchedUrl = "";
         return;
       }
@@ -70,12 +113,14 @@ async function init() {
         `;
         infoDiv.classList.add("visible");
         infoDiv.classList.remove("playlist-mode");
+        playlistTitleInput.value = "";
         loaderBox.style.display = "none";
         return;
       }
 
       // ---------- PLAYLIST ----------
       if (data.type === "playlist") {
+        playlistTitleInput.value = data.title;
         infoDiv.classList.add("playlist-mode");
         infoDiv.innerHTML = `
           <div class="playlist-header">
@@ -194,6 +239,7 @@ async function init() {
       }
 
       infoDiv.classList.remove("playlist-mode");
+      playlistTitleInput.value = "";
 
       // ---------- VIDEO NORMALE ----------
       const durationStr = data.duration
@@ -225,6 +271,6 @@ async function init() {
 
   })
 
-};
+}
 
 init();

public/script/progressBar.js

@@ -1,25 +1,65 @@
+/**
+ * DOM elements used for download progress UI rendering.
+ * These elements are updated in real-time via SSE streams.
+ */
 const progressWrapper = document.getElementById("downloadProgressWrapper");
 const progressBar = document.getElementById("downloadProgress");
-const progressBarText = document.getElementById("downloadProgressText")
+const progressBarText = document.getElementById("downloadProgressText");
 
 const speedElement = document.getElementById("downloadSpeedText");
+const stageElement = document.getElementById("downloadStage");
+const playlistInfoElement = document.getElementById("playlistInfoText");
+
+/**
+ * Server-Sent Events streams for real-time download updates.
+ * Each stream is responsible for a specific aspect of the download state.
+ */
 const speedEvt = new EventSource("/download/speed");
+const stageEvt = new EventSource("/download/stage");
+const playlistInfoEvt = new EventSource("/download/playlist-info");
 
+/**
+ * Resets the progress UI to its initial state.
+ * Hides all dynamic elements and clears displayed values.
+ */
 function startProgress() {
-  progressWrapper.style.display = "block";
   progressBar.style.width = "0%";
-  progressBarText.style.display = "block";
   progressBarText.innerHTML = "0%";
-
-  speedElement.style.display = "block";
   speedElement.innerHTML = "0 Mib/s";
 }
 
+/**
+ * Makes the progress UI visible and enables related controls
+ * such as the stop button.
+ */
+function showProgress() {
+  progressWrapper.style.display = "block";
+  progressBarText.style.display = "block";
+  speedElement.style.display = "block";
+
+  const stopBtn = document.getElementById("stopBtn");
+  if (stopBtn) stopBtn.style.display = "inline-flex";
+}
+
+/**
+ * Updates the progress bar UI with the given percentage.
+ * Automatically triggers UI visibility if not already shown.
+ *
+ * @param {number} percent - Download progress percentage (0–100)
+ */
 function updateProgress(percent) {
+  if (percent > 0 && progressWrapper.style.display !== "block") {
+    showProgress();
+  }
+
   progressBar.style.width = `${percent}%`;
   progressBarText.innerHTML = `${percent}%`;
 }
 
+/**
+ * Fully resets the progress UI and hides all download indicators.
+ * Called after completion or cancellation.
+ */
 function resetProgress() {
   progressBar.style.width = "0%";
   progressBarText.textContent = "";
@@ -28,10 +68,26 @@ function resetProgress() {
 
   speedElement.textContent = "0 Mib/s";
   speedElement.style.display = "none";
+
+  stageElement.textContent = "";
+  stageElement.style.display = "none";
+
+  playlistInfoElement.textContent = "";
+  playlistInfoElement.style.display = "none";
+
+  const stopBtn = document.getElementById("stopBtn");
+  if (stopBtn) stopBtn.style.display = "none";
 }
 
-// SSE Connexion
+/**
+ * Main SSE stream handling download progress updates.
+ * Supports:
+ * - reset signal
+ * - done signal
+ * - percentage updates
+ */
 const evtSource = new EventSource("/download/progress");
+
 evtSource.onmessage = e => {
   if (e.data === "reset") {
     startProgress();
@@ -40,24 +96,41 @@ evtSource.onmessage = e => {
   }
 
   if (e.data === "done") {
-    resetProgress();
-    window.electronAPI.setProgress(-1); 
+    setTimeout(() => {
+      resetProgress();
+      window.electronAPI.setProgress(-1);
+    }, 2000);
     return;
   }
 
   const percent = parseFloat(e.data);
-  
+
   if (!isNaN(percent)) {
     updateProgress(percent);
-    window.electronAPI.setProgress(percent); // Update Task Bar
-    if (percent >= 100) setTimeout(() => {
-      resetProgress();
-      window.electronAPI.setProgress(-1); // Remove the bar
-    }, 500);
+    window.electronAPI.setProgress(percent);
   }
 };
 
+/**
+ * SSE stream: download speed updates (e.g. "5.2 MiB/s").
+ */
 speedEvt.onmessage = e => {
   speedElement.style.display = "block";
-  speedElement.textContent = e.data; // ex: "5.2MiB/s"
+  speedElement.textContent = e.data;
+};
+
+/**
+ * SSE stream: download stage updates (e.g. downloading, merging, extracting).
+ */
+stageEvt.onmessage = e => {
+  stageElement.style.display = "block";
+  stageElement.textContent = e.data;
+};
+
+/**
+ * SSE stream: playlist progress updates (e.g. "Item 1 of 15").
+ */
+playlistInfoEvt.onmessage = e => {
+  playlistInfoElement.style.display = "block";
+  playlistInfoElement.textContent = e.data;
 };

public/script/settingsPanel.js

@@ -1,50 +1,105 @@
+/**
+ * Settings panel DOM elements used to control application feature flags
+ * and configuration UI interactions.
+ */
 const settingsPanel = document.getElementById("settings-panel");
 const settingsModal = document.querySelector(".settings-modal");
-
 const settingsButton = document.getElementById("settings-button");
 
+/**
+ * Tracks current settings panel state.
+ * NOTE: actual visibility is derived from DOM style in current implementation.
+ */
 let isOpen = false;
 
+/**
+ * Toggles visibility of the settings panel when clicking the settings button.
+ */
 settingsButton.addEventListener("click", () => {
-    const isOpen = settingsPanel.style.display === "block";
-    settingsPanel.style.display = isOpen ? "none" : "block";
+  const currentlyOpen = settingsPanel.style.display === "block";
+  settingsPanel.style.display = currentlyOpen ? "none" : "block";
 });
 
+/**
+ * Closes the settings panel and resets internal state.
+ */
 function closePanel() {
-    isOpen = false;
-    settingsPanel.style.display = "none";
+  isOpen = false;
+  settingsPanel.style.display = "none";
 }
 
-
+/**
+ * Loads feature flags from Electron backend and syncs them
+ * with corresponding UI controls (checkboxes, selects).
+ *
+ * Also registers change listeners to persist updates in real time.
+ */
 async function loadSettings() {
   const features = await window.electronAPI.getFeatures();
 
-  document.querySelectorAll(".settings-section input, .settings-section select").forEach(el => {
-    const key = el.dataset.key;
-    if (features[key] !== undefined) {
-      if (el.type === "checkbox") el.checked = features[key];
-      else if (el.tagName === "SELECT") el.value = features[key];
-    }
+  document
+    .querySelectorAll(".settings-section input, .settings-section select")
+    .forEach((el) => {
+      const key = el.dataset.key;
+      if (!key) return;
 
-    el.addEventListener("change", () => {
-      let value = el.type === "checkbox" ? el.checked : el.value;
-      window.electronAPI.setFeature(key, value);
+      if (features[key] !== undefined) {
+        if (el.type === "checkbox") el.checked = features[key];
+        else if (el.tagName === "SELECT") el.value = features[key];
+      }
+
+      el.addEventListener("change", () => {
+        if (key === "theme") return;
+
+        const value = el.type === "checkbox" ? el.checked : el.value;
+        window.electronAPI.setFeature(key, value);
+      });
     });
-  });
 }
 
-// Open The JSON
-document.getElementById("open-json-btn").addEventListener("click", () => {
-  window.topbarAPI.openConfig(); // ton IPC existant
+/**
+ * Opens configuration JSON file via Electron topbar API.
+ */
+document.getElementById("open-json-btn")
+  ?.addEventListener("click", () => {
+    window.topbarAPI.openConfig();
+  });
+
+/**
+ * Opens theme directory via Electron topbar API.
+ */
+document.getElementById("open-theme")
+  ?.addEventListener("click", () => {
+    window.topbarAPI.openTheme();
+  });
+
+/**
+ * Refreshes theme list and updates UI selector with a short animation.
+ */
+document.getElementById("refresh-themes-btn")
+  ?.addEventListener("click", function () {
+    this.classList.add("spinning");
+    window.refreshThemes();
+
+    setTimeout(() => {
+      this.classList.remove("spinning");
+    }, 600);
+  });
+
+/**
+ * Clicking the overlay outside the modal closes the settings panel.
+ */
+settingsPanel?.addEventListener("click", closePanel);
+
+/**
+ * Prevents modal clicks from closing the settings panel
+ * by stopping event propagation to the overlay.
+ */
+settingsModal?.addEventListener("click", (e) => {
+  e.stopPropagation();
 });
 
-
-/* clic sur l'overlay = fermer */
-settingsPanel.addEventListener("click", closePanel);
-
-/* clic dans la modal = stop propagation */
-settingsModal.addEventListener("click", (e) => {
-    e.stopPropagation();
-});
-
-loadSettings();
+/**
+ * Initializes settings UI by loading backend feature flags.
+ */
+loadSettings();

public/script/toast.js

@@ -0,0 +1,83 @@
+/**
+ * Displays a toast notification in the global UI container.
+ *
+ * Toasts are automatically appended to `#toast-container`,
+ * support multiple visual types, and can auto-dismiss after a delay.
+ *
+ * @param {string} message - Message displayed inside the toast
+ * @param {"success"|"error"|"warning"|"info"} [type="info"] - Visual style of the toast
+ * @param {number} [duration=4000] - Auto-dismiss delay in milliseconds (0 disables auto removal)
+ * @returns {HTMLElement|null} The created toast element or null if container is missing
+ */
+window.showToast = function (message, type = "info", duration = 4000) {
+  const container = document.getElementById("toast-container");
+  if (!container) return null;
+
+  const toast = document.createElement("div");
+  toast.classList.add("toast", type);
+
+  const icons = {
+    success: "✓",
+    error: "✕",
+    warning: "⚠",
+    info: "ℹ"
+  };
+
+  const icon = icons[type] || icons.info;
+
+  toast.innerHTML = `
+    <span class="toast-icon">${icon}</span>
+    <span class="toast-message">${message}</span>
+    <button class="toast-close" title="Close">×</button>
+  `;
+
+  const closeBtn = toast.querySelector(".toast-close");
+  closeBtn.addEventListener("click", () => removeToast(toast));
+
+  container.appendChild(toast);
+
+  if (duration > 0) {
+    setTimeout(() => removeToast(toast), duration);
+  }
+
+  return toast;
+};
+
+/**
+ * Removes a toast element with a small exit animation.
+ *
+ * @param {HTMLElement} toast
+ */
+function removeToast(toast) {
+  if (!toast?.parentElement) return;
+
+  toast.classList.add("removing");
+
+  setTimeout(() => {
+    toast.remove();
+  }, 300);
+}
+
+/**
+ * Shortcut: success toast
+ */
+window.showSuccess = (message, duration = 4000) =>
+  window.showToast(message, "success", duration);
+
+/**
+ * Shortcut: error toast
+ */
+window.showError = (message, duration = 5000) =>
+  window.showToast(message, "error", duration);
+
+/**
+ * Shortcut: warning toast
+ */
+window.showWarning = (message, duration = 4000) =>
+  window.showToast(message, "warning", duration);
+
+/**
+ * Shortcut: info toast
+ */
+window.showInfo = (message, duration = 4000) =>
+  window.showToast(message, "info", duration);

public/script/topbar.js

@@ -1,34 +1,57 @@
-// Ajout des listeners pour la topbar
+/**
+ * Initializes topbar button event listeners and binds them
+ * to the Electron preload API exposed in `window.topbarAPI`.
+ *
+ * This function is safe to call once DOM is ready.
+ * It silently aborts if the API or elements are missing.
+ */
 function setupTopbarListeners() {
-  document.addEventListener('DOMContentLoaded', () => {
-    const { topbarAPI } = window;
-    if (!topbarAPI) return;
-    const minBtn = document.getElementById('minimize-btn');
-    const maxBtn = document.getElementById('maximize-btn');
-    const closeBtn = document.getElementById('close-btn');
-    const devtoolsBtn = document.getElementById('devtools-btn');
-    const logsBtn = document.getElementById('logs-btn');
-    const websiteBtn = document.getElementById('website-btn');
-    const wikiBtn = document.getElementById('wiki-btn');
-    const configBtn = document.getElementById('config-btn');
+  const { topbarAPI } = window;
+  if (!topbarAPI) return;
 
-    if (minBtn) minBtn.onclick = () => topbarAPI.minimize();
-    if (maxBtn) maxBtn.onclick = () => topbarAPI.maximize();
-    if (closeBtn) closeBtn.onclick = () => topbarAPI.close();
-    if (devtoolsBtn) devtoolsBtn.onclick = () => topbarAPI.openDevTools();
-    if (logsBtn) logsBtn.onclick = () => topbarAPI.openLogs();
-    if (websiteBtn) websiteBtn.onclick = () => topbarAPI.openWebsite();
-    if (wikiBtn) wikiBtn.onclick = () => topbarAPI.openWiki();
-    if (configBtn) configBtn.onclick = () => topbarAPI.openConfig();
-  });
+  const minBtn = document.getElementById("minimize-btn");
+  const maxBtn = document.getElementById("maximize-btn");
+  const closeBtn = document.getElementById("close-btn");
+  const devtoolsBtn = document.getElementById("devtools-btn");
+  const logsBtn = document.getElementById("logs-btn");
+  const websiteBtn = document.getElementById("website-btn");
+  const wikiBtn = document.getElementById("wiki-btn");
+  const workshopBtn = document.getElementById("workshop-btn");
+
+  if (minBtn) minBtn.onclick = () => topbarAPI.minimize();
+  if (maxBtn) maxBtn.onclick = () => topbarAPI.maximize();
+  if (closeBtn) closeBtn.onclick = () => topbarAPI.close();
+  if (devtoolsBtn) devtoolsBtn.onclick = () => topbarAPI.openDevTools();
+  if (logsBtn) logsBtn.onclick = () => topbarAPI.openLogs();
+  if (websiteBtn) websiteBtn.onclick = () => topbarAPI.openWebsite();
+  if (wikiBtn) wikiBtn.onclick = () => topbarAPI.openWiki();
+  if (workshopBtn) workshopBtn.onclick = () => topbarAPI.openWorkshop();
 }
 
-setupTopbarListeners(); // IF it put it the if check. It don't work. Why ?
+/**
+ * Registers topbar event listeners after DOM is fully loaded.
+ */
+document.addEventListener("DOMContentLoaded", setupTopbarListeners);
 
-const features = await window.electronAPI.getFeatures();
+/**
+ * Applies UI layout adjustments depending on feature flags
+ * provided by the Electron backend.
+ *
+ * Specifically handles:
+ * - hiding custom topbar
+ * - adjusting layout spacing
+ * - repositioning theme switcher
+ */
+(async function applyFeatureLayout() {
+  const features = await window.electronAPI.getFeatures();
 
-if(!features.customTopBar){
-  document.getElementById("topbar").style.display = "none"; 
-  document.getElementById("container").style.marginTop = "0";
-  document.getElementById("theme-switcher").style.top = "30px";  
-} 
+  if (!features.customTopBar) {
+    const topbar = document.getElementById("topbar");
+    const container = document.getElementById("container");
+    const themeSwitcher = document.getElementById("theme-switcher");
+
+    if (topbar) topbar.style.display = "none";
+    if (container) container.style.marginTop = "0";
+    if (themeSwitcher) themeSwitcher.style.top = "30px";
+  }
+})();

public/splash.html

@@ -0,0 +1,94 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    html, body {
+      width: 100%;
+      height: 100%;
+      background: transparent;
+      overflow: hidden;
+    }
+    .splash-container {
+      width: 100%;
+      height: 100%;
+      background: #D9D9D9;
+      border-radius: 12px;
+      overflow: hidden;
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      justify-content: center;
+      gap: 28px;
+      font-family: "Segoe UI", sans-serif;
+    }
+    .progress-wrapper {
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      gap: 8px;
+    }
+    .progress-track {
+      width: 180px;
+      height: 3px;
+      background: #d0d0d0;
+      border-radius: 99px;
+      overflow: hidden;
+    }
+    .progress-bar {
+      height: 100%;
+      width: 0%;
+      background: #1a1a1a;
+      border-radius: 99px;
+      transition: width 0.3s ease;
+    }
+    .status {
+      font-size: 14px;
+      color: #6d6d6d;
+      letter-spacing: 0.5px;
+    }
+  </style>
+</head>
+<body>
+
+  <div class="splash-container">
+    <img src="./banner.png" alt="Freedom Loader" style="width: 90%;">
+    <div class="progress-wrapper">
+      <div class="progress-track">
+        <div class="progress-bar" id="progress-bar"></div>
+      </div>
+      <span class="status" id="status">Starting...</span>
+    </div>
+  </div>
+
+  <script>
+    const steps = [
+      "Checking dependencies...",
+      "Starting server...",
+      "Loading themes...",
+      "Almost ready...",
+    ];
+    let current = 0;
+    const bar = document.getElementById("progress-bar");
+    const status = document.getElementById("status");
+
+    function advance(label, percent) {
+      bar.style.width = percent + "%";
+      status.textContent = label;
+    }
+
+    window.setProgress = (step) => {
+      if (step >= steps.length) {
+        advance("", 100);
+        return;
+      }
+      const percent = Math.round(((step + 1) / steps.length) * 100);
+      advance(steps[step], percent);
+    };
+
+    window.setProgress(0);
+  </script>
+
+</body>
+</html>

public/styles/components/checkbox.css

@@ -15,13 +15,13 @@
 }
 
 .checkmark {
-  --clr: var(--checkbox-bg-checked);
+  --clr: var(--checkbox-checked-bg-color);
   position: relative;
   top: 0;
   left: 0;
   height: 1.3em;
   width: 1.3em;
-  background-color: var(--checkbox-bg-default);
+  background-color: var(--checkbox-unchecked-bg-color);
   border-radius: .5rem;
   transition: background-color 300ms, border-radius 300ms;
 }

public/styles/components/editpathbutton.css

@@ -17,9 +17,11 @@
   border-radius: 6px;
   font-family: monospace;
   border: 1px dashed var(--form-input-border-color);
-  word-break: break-all;
-  display: inline-block;
-  max-width: 80%;
+  display: inline-flex;
+  max-width: clamp(200px, 60vw, 600px);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 
 

public/styles/components/loader.css

@@ -4,9 +4,9 @@
   gap: 10px;
   padding: 10px 20px;
   background: var(--form-bg-color);
-  border: 2px solid var(--mp3-text-color);
+  border: 2px solid var(--audio-only-label-color);
   border-radius: 8px;
-  color: var(--mp3-text-color);
+  color: var(--audio-only-label-color);
   font-weight: bold;
   animation: pulse 1.2s infinite;
 }

public/styles/components/progressBar.css

@@ -1,22 +1,34 @@
+/* Container pour isoler la progress bar */
+.progress-container {
+  width: 100%;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 8px;
+  padding: 10px 0;
+  margin-top: 20px;
+}
+
 /* Wrapper de la barre de téléchargement */
 #downloadProgressWrapper {
   width: 100%;
   max-width: 400px;
   height: 12px;
-  background-color: #444;
-  border-radius: 6px;
+  background-color: var(--progress-bar-bg-color, #cccccc);
+  border-radius: 10px;
   overflow: hidden;
-  margin: 10px auto;
+  margin: 0;
   display: none;
   box-shadow: inset 0 1px 3px rgba(0,0,0,0.5);
+  box-sizing: border-box;
 }
 
 /* Barre de progression */
 #downloadProgress {
   height: 100%;
   width: 0%;
-  background-color: var(--video-info-link-color, #4caf50);
-  border-radius: 6px 0 0 6px;
+  background-color: var(--progress-bar-fill-color, #007bff);
+  border-radius: 10px;
   transition: width 0.2s ease;
 }
 
@@ -25,7 +37,7 @@
   font-size: 0.8rem;
   color: #fff;
   content: "";
-
+  display: none;
 }
 
 /* Responsive pour mobile */
@@ -39,3 +51,39 @@
     font-size: 0.7rem;
   }
 }
+
+/* Stop Button */
+.stop-btn {
+  width: 40px;
+  height: 40px;
+  min-width: 40px;
+  padding: 0;
+  border: none;
+  border-radius: 8px;
+  background-color: var(--form-button-bg-color);
+  color: var(--form-button-text-color);
+  font-size: 20px;
+  font-weight: bold;
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  transition: all 0.3s ease;
+  box-shadow: 0 2px 6px rgba(0, 0, 0, 0.15);
+}
+
+.stop-btn:hover:not(:disabled) {
+  background-color: var(--form-button-bg-hover-color);
+  box-shadow: 0 6px 16px rgba(0, 0, 0, 0.35);
+  transform: scale(1.05);
+}
+
+.stop-btn:active:not(:disabled) {
+  transform: scale(0.96);
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.15);
+}
+
+.stop-btn:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}

public/styles/components/toast.css

@@ -0,0 +1,136 @@
+/* Toast Container */
+#toast-container {
+  position: fixed;
+  top: 140px;
+  right: 20px;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  z-index: 9999;
+  pointer-events: none;
+}
+
+/* Toast */
+.toast {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 10px 14px;
+  background-color: rgba(50, 50, 50, 0.9);
+  border-radius: 6px;
+  color: #ffffff;
+  font-size: 0.9rem;
+  max-width: 220px;
+  min-width: 100px;
+  animation: slideIn 0.25s ease-out;
+  pointer-events: auto;
+  backdrop-filter: blur(8px);
+}
+
+.toast.success {
+  background-color: rgba(40, 167, 69, 0.15);
+}
+
+.toast.error {
+  background-color: rgba(220, 53, 69, 0.15);
+}
+
+.toast.warning {
+  background-color: rgba(255, 193, 7, 0.15);
+}
+
+.toast.info {
+  background-color: rgba(23, 162, 184, 0.15);
+}
+
+/* Toast Icon */
+.toast-icon {
+  flex-shrink: 0;
+  font-size: 18px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.toast.success .toast-icon {
+  color: #28a745;
+}
+
+.toast.error .toast-icon {
+  color: #dc3545;
+}
+
+.toast.warning .toast-icon {
+  color: #ffc107;
+}
+
+.toast.info .toast-icon {
+  color: #17a2b8;
+}
+
+/* Toast Message */
+.toast-message {
+  flex: 1;
+  font-weight: 500;
+}
+
+/* Toast Close Button */
+.toast-close {
+  flex-shrink: 0;
+  background: none;
+  border: none;
+  color: currentColor;
+  cursor: pointer;
+  font-size: 18px;
+  padding: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  opacity: 0.5;
+  transition: opacity 0.2s ease;
+}
+
+.toast-close:hover {
+  opacity: 1;
+}
+
+/* Animations */
+@keyframes slideIn {
+  from {
+    transform: translateX(350px);
+    opacity: 0;
+  }
+  to {
+    transform: translateX(0);
+    opacity: 1;
+  }
+}
+
+@keyframes slideOut {
+  from {
+    transform: translateX(0);
+    opacity: 1;
+  }
+  to {
+    transform: translateX(350px);
+    opacity: 0;
+  }
+}
+
+.toast.removing {
+  animation: slideOut 0.25s ease-out;
+}
+
+/* Responsive */
+@media (max-width: 480px) {
+  #toast-container {
+    bottom: 12px;
+    right: 12px;
+    left: 12px;
+  }
+
+  .toast {
+    max-width: none;
+    min-width: auto;
+  }
+}

public/styles/layout/container.css

@@ -4,7 +4,6 @@
   left: 0;
   right: 0;
   padding: 1em;
-  z-index: 1000;        
   display: flex;
   flex-direction: column;
   align-items: center;

public/styles/layout/form.css

@@ -40,8 +40,7 @@ form button:hover {
 form#downloadForm {
     display: flex;
     gap: 0.5em;
-    max-width: 600px;
-    width: 100%;
+    width: 350px;
     justify-content: center;
 }
 
@@ -50,7 +49,7 @@ form#downloadForm {
     align-items: center;
     align-self: center;
     gap: 0.5em;
-    color: var(--form-input-text-color);
+    color: var(--audio-only-label-color);
 }
 
 #UrlInput {
@@ -108,6 +107,7 @@ form#downloadForm {
 }
 
 .paste-btn svg {
+    color: var(--paste-button-icon-color);
     width: 30px;
     height: 30px;
 }

public/styles/layout/header.css

@@ -1,11 +1,13 @@
 header {
+    position: fixed;
+    top: 0;
+    width: 100%;
+    height: 48px;
+    z-index: 1100;
     display: flex;
-    flex-direction: column;
-    align-items: center;  
-    margin-bottom: 2vw;
+    align-items: center;
 }
 
-
-header h1{
-    margin-bottom: 0.2vw;
+#title {
+    color: var(--default-text-color);
 }

public/styles/layout/settingsPanel.css

@@ -7,6 +7,7 @@
     top: 60px;
     right: 20px;
     opacity: 0.8;
+    z-index: 15;
     background-color: var(--settings-button-bg-color);
     border-radius: 14px;
     padding: 8px;
@@ -40,7 +41,7 @@
     width: 40vw;
     max-width: 320px;
     max-height: 80vh;
-    background-color: var(--settings-bg-primary-color);
+    background-color: var(--settings-modal-bg-color);
     border-radius: 12px;
     padding: 20px;
     box-shadow: 0 8px 24px rgba(0,0,0,0.4);
@@ -89,7 +90,7 @@
     flex-direction: column;
     margin-bottom: 20px;
     padding: 10px 15px;
-    background: var(--settings-bg-secondary-color);
+    background: var(--settings-section-bg-color);
     border-radius: 12px;
     gap: 6px;
 }
@@ -190,8 +191,18 @@ details summary {
     border: none;
     cursor: pointer;
     font-weight: 600;
-    background-color: var(--form-button-bg-color);
-    color: #fff;
+    background-color: var(--open-json-button-bg-color);
+    color: var(--open-json-button-text-color);
+}
+
+#open-theme {
+    padding: 10px 14px;
+    border-radius: 8px;
+    border: none;
+    cursor: pointer;
+    font-weight: 600;
+    background-color: var(--open-theme-button-bg-color);
+    color: var(--open-theme-button-text-color);
 }
 
 #experimental-args {
@@ -222,6 +233,33 @@ details summary {
     opacity: 1;
 }
 
+/* REFRESH THEMES BUTTON */
+.refresh-themes-btn {
+    padding: 6px 8px;
+    border-radius: 6px;
+    border: 1px solid var(--form-input-border-color);
+    background-color: var(--form-input-bg-color);
+    color: var(--form-input-text-color);
+    cursor: pointer;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: all 0.3s ease;
+}
+
+.refresh-themes-btn:hover {
+    background-color: var(--form-button-bg-hover-color);
+}
+
+.refresh-themes-btn.spinning svg {
+    animation: spin 0.6s ease-in-out;
+}
+
+.refresh-themes-btn svg {
+    color: currentColor;
+    transition: transform 0.6s ease-in-out;
+}
+
 /* ANIMATION */
 @keyframes popIn {
     from { transform: scale(0.95); opacity: 0; }
@@ -231,4 +269,9 @@ details summary {
 @keyframes slideIn {
     from { transform: translateX(20px); opacity: 0; }
     to { transform: translateX(0); opacity: 1; }
+}
+
+@keyframes spin {
+    from { transform: rotate(0deg); }
+    to { transform: rotate(360deg); }
 }

public/styles/layout/topbar.css

@@ -2,20 +2,12 @@
   display: flex;
   align-items: center;
   justify-content: space-between;
-
-  position: fixed;
-  top: 0;
-  z-index: 1100;
-
-  height: 48px;
   width: 100%;
-
+  height: 100%;
   background: #1f1f1f98;
   color: #eaeaea;
-
   -webkit-app-region: drag;
   user-select: none;
-
 }
 
 /* LEFT - custom buttons */

public/styles/layout/videoinfo.css

@@ -4,7 +4,7 @@
   margin-left: auto;
   margin-right: auto;
   padding: 1.5em 2em;
-  background-color: var(--infos-box-color);
+  background-color: var(--video-info-bg-color);
   border-radius: 12px;
   box-shadow: 0 8px 16px rgba(0,0,0,0.1);
   color: var(--video-info-text-color);

public/styles/styles.css

@@ -1,29 +1,41 @@
 /* Layout */
-@import url("layout/form.css");
-@import url("layout/settingsPanel.css");
-@import url("layout/container.css");
+@import url("layout/topbar.css");
 @import url("layout/header.css");
+@import url("layout/form.css");
+@import url("layout/container.css");
+@import url("layout/settingsPanel.css");
 @import url("layout/videoinfo.css");
 
 /* Components */
 @import url("components/checkbox.css");
 @import url("components/loader.css");
-
-@import url("theme/themeimport.css");
 @import url("components/editpathbutton.css");
 @import url("components/progressBar.css");
+@import url("components/toast.css");
 
 @import url('https://fonts.googleapis.com/css2?family=Poppins:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,100;1,200;1,300;1,400;1,500;1,600;1,700;1,800;1,900&display=swap');
 
-#app {
-  display: block; 
-  opacity: 0;
-  transition: opacity 0.6s ease;
+
+/* Mark element as disabled */
+.disabled {
+  pointer-events: none;
+  opacity: 0.5;
+  filter: grayscale(40%);
+  cursor: not-allowed;
 }
-#app.visible {
-  opacity: 1;
+
+/* Because why not */
+#reference{
+  position: fixed;
+  pointer-events: none;
+  bottom:0vh;
+  left: 10px;
+  font-size: 1em;
+  color: #b0b0b02f;
+  z-index: 9999;
 }
 
+
 html,body{
     margin: 0;
     padding: 0;
@@ -34,43 +46,45 @@ html,body{
     font-style: normal;
 }
 
-body {
-    margin: 0;
-    background-color: var(--background-color);
+body{
+  background-color: var(--background-color);
+  color: var(--default-text-color);
+}
+
+header {
+    position: fixed;
+    top: 0;
     width: 100%;
-    height: 100%;
-    color: var(--default-text-color);
-    display: flex;
-    justify-content: center;
-    align-items: center;   
+    z-index: 1100;
+    height: 48px;
+}
+
+main {
+    width: 100%;
+    height: calc(100vh - 48px);
+    margin-top: 48px;
+    overflow-y: auto;
+    overflow-x: hidden;
     display: flex;
     flex-direction: column;
+    justify-content: flex-start;
     align-items: center;
-
+    padding: 0;
+    gap: 0;
 }
 
-/* Because why not */
-#reference{
-  position: fixed;
-  pointer-events: none;
-  bottom:0vh;
-  left: 10px;
-  font-size: 1em;
-  color: #b0b0b02f;
-}
-
-/* Scrollbar globale pour Chromium/Electron */
-body::-webkit-scrollbar {
+/* Scrollbar pour main */
+main::-webkit-scrollbar {
   width: 10px;
   height: 10px;
 }
 
-body::-webkit-scrollbar-track {
+main::-webkit-scrollbar-track {
   background: rgba(255, 255, 255, 0.03);
   border-radius: 5px;
 }
 
-body::-webkit-scrollbar-thumb {
+main::-webkit-scrollbar-thumb {
   background-color: rgba(255, 255, 255, 0.2);
   border-radius: 5px;
   border: 2px solid transparent;
@@ -78,36 +92,32 @@ body::-webkit-scrollbar-thumb {
   transition: background-color 0.2s ease, transform 0.2s ease;
 }
 
-body::-webkit-scrollbar-thumb:hover {
+main::-webkit-scrollbar-thumb:hover {
   background-color: rgba(255, 255, 255, 0.35);
   transform: scaleX(1.05);
 }
 
 /* Thème clair */
-body.light::-webkit-scrollbar-track {
+body.light main::-webkit-scrollbar-track {
   background: rgba(0, 0, 0, 0.05);
 }
 
-body.light::-webkit-scrollbar-thumb {
+body.light main::-webkit-scrollbar-thumb {
   background-color: rgba(0, 0, 0, 0.25);
 }
 
-body.light::-webkit-scrollbar-thumb:hover {
+body.light main::-webkit-scrollbar-thumb:hover {
   background-color: rgba(0, 0, 0, 0.45);
 }
 
 .container{
-  margin-top: 50px;
+  margin-top: 0px;
 }
 
-header p{
+#subtitle{
   color: var(--subtitle-color);
 }
 
-.checkbox-inline{
-  color: var(--mp3-text-color);
-}
-
 body, 
 .container, 
 input, 

public/styles/theme/chirac-theme.css

@@ -1,103 +0,0 @@
-body.chirac {
-  
-  background-image: url('../../assets/images/Chirac.png'); 
-  background-repeat: no-repeat;
-  background-size: cover;
-  background-attachment: fixed;
-  
-
-  --background-color: rgba(255, 255, 255, 0.85); 
-  --default-text-color: #002395;
-  --subtitle-color: #EF4135;
-  --mp3-text-color: #002395;
-  
-  /* Formulaire */
-  --form-bg-color: rgba(255, 255, 255, 0.9);
-  --form-input-bg-color: #f5f5f5;
-  --form-input-border-color: #002395;
-  --form-input-border-focus-color: #EF4135;
-  --form-input-text-color: #002395;
-  --form-input-placeholder-color: #999999;
-  --form-button-bg-color: #002395; 
-  --form-button-text-color: #ffffff;
-  --form-button-bg-hover-color: #EF4135;
-  
-  /* Checkbox */
-  --checkbox-bg-default: #cccccc;
-  --checkbox-bg-checked: #002395;
-  --checkbox-checkmark-border-color: #ffffff;
-  --checkbox-pulse-color: rgba(0, 35, 149, 0.5);
-  
-  /* Download status */
-  --download-status-color: #002395;
-  
-  /* Video Info Box */
-  --infos-box-color: rgba(255, 255, 255, 0.9);
-  --video-info-text-color: #000000;
-  --video-info-heading-color: #EF4135;
-  --video-info-list-color: #444444;
-  --video-info-list-strong-color: #000000;
-  --video-info-link-color: #002395;
-  --video-info-link-hover-color: #EF4135;
-
-  /* Playlist Color */
-  --playlist-background-color: #d1d1d1ca;
-
-  /* Settings */ 
-  --settings-button-bg-color: #00196a;
-  --settings-button-text-color: #dcdcdc;  
-
-  --settings-bg-primary-color: #0b0528;
-  --settings-bg-secondary-color: #1c1055;
-
-  --settings-text-color: #cecece; 
-  --settings-subtitle-color: #adadad;
-}
-
-
-/* 
-
-Je serai le président de tous les Français
-Tous les Français
-Tous les Français
-Tous les Français
-Tous les Français
-Tous les Français
-Tous les Français
-Tous les Français
-Tous les Français
-Tous les Français
-Mes chers compatriotes
-Je serai le président de tous les Français, de tous les Français
-Je mesure la difficulté de la tâche qui nous attend
-Tous les Français
-Tous les Français
-Je veux un État, je veux les Français
-Je veux un État, je veux
-Je veux un État-tat-tat-tat vigoureux
-Un État-tat-tat-tat impartial
-Un État-tat-tat-tat vigoureux
-Un État-tat-tat-tat exigeant
-Un État-tat-tat-tat
-Je serai le président de tous les Français
-Tous les Français
-Tous les Français
-Tous les Français
-Un État qui n'isole pas, tous, pas, pas
-Tous, pas, tous, pas, pas
-Tous, pas, tous, pas, pas (les Français)
-Tous, tous, pas, tous, tous, pas, pas
-Tous, tous, pas, tous, tous, pas, pas
-Tous, tous, tous, pas, tous, pas, pas (les Français)
-Tous, pas, tous, tous, pas, pas
-Tous, tous, tous, pas, tous, tous, pas, pas
-Tous, tous, pas, tous, tous, pas, pas
-Tous, tous, tous-tous, tous-tous, pas, pas
-Tous, tous-tous, tous-tous, pas, pas
-Un État-tat-tat-tat vigoureux
-Un État-tat-tat-tat impartial
-Un État-tat-tat-tat exigeant
-Un État-tat-tat-tat
-Je serai le président de tous les Français
-
-*/

public/styles/theme/dark-theme.css

@@ -1,49 +0,0 @@
-body.dark {
-  /* Couleurs générales */
-  --background-color: #121212;               /* noir/gris très foncé */
-  --default-text-color: #e0e0e0;             /* texte clair */
-  --subtitle-color: #2196f3;                 /* bleu accent */
-  --mp3-text-color: #f5f5f5;                 /* texte checkbox */
-
-  /* Formulaire */
-  --form-bg-color: #1e1e1e;                  /* fond formulaire */
-  --form-input-bg-color: #2a2a2a;            /* fond inputs */
-  --form-input-border-color: #444444;        /* bordure */
-  --form-input-border-focus-color: #2196f3;  /* focus bleu */
-  --form-input-text-color: #f5f5f5;          /* texte clair */
-  --form-input-placeholder-color: #888888;   /* placeholder gris */
-  --form-button-bg-color: #2196f3;           /* bouton bleu */
-  --form-button-text-color: #ffffff;         /* texte bouton */
-  --form-button-bg-hover-color: #1976d2;     /* hover bleu plus foncé */
-
-  /* Checkbox */
-  --checkbox-bg-default: #555555;             /* gris moyen */
-  --checkbox-bg-checked: #2196f3;             /* bleu accent */
-  --checkbox-checkmark-border-color: #ffffff; /* blanc */
-  --checkbox-pulse-color: rgba(33, 150, 243, 0.5);
-
-  /* Download status */
-  --download-status-color: #2196f3;
-
-  /* Video Info Box */
-  --infos-box-color: #1a1a1a;
-  --video-info-text-color: #e0e0e0;
-  --video-info-heading-color: #2196f3;
-  --video-info-list-color: #cccccc;
-  --video-info-list-strong-color: #ffffff;
-  --video-info-link-color: #2196f3;
-  --video-info-link-hover-color: #1976d2;
-
-  /* Playlist Color */
-  --playlist-background-color: #303030;
-
-  /* Settings */
-  --settings-button-bg-color: #1e1e1e;
-  --settings-button-text-color: var(--default-text-color);  
-
-  --settings-bg-primary-color: #1e1e1e;
-  --settings-bg-secondary-color: #2a2a2a;
-  --settings-text-color: var(--default-text-color); 
-  --settings-subtitle-color: #aaa;
-
-}

public/styles/theme/drift-theme.css

@@ -1,61 +0,0 @@
-body.drift {
-
-    background-image: url('../../assets/images/Drift.jpg');
-    background-size: cover;
-    background-position: center;
-    background-attachment: fixed;
-
-    /* Palette principale */
-    --background-color: #0f1218;
-    --default-text-color: #3d4b61;
-    --subtitle-color: #1a1a1a;
-    --mp3-text-color: #c0d4ff;
-
-    /* Formulaire */
-    --form-bg-color: #1e222a;         
-    --form-input-bg-color: #13171d; 
-    --form-input-border-color: #3b4b6d;
-    --form-input-border-focus-color: #6ea8ff; 
-    --form-input-text-color: #f0f4ff;
-    --form-input-placeholder-color: #7a8fae;
-    --form-button-bg-color: #2a2979;
-    --form-button-text-color: #ffffff;
-    --form-button-bg-hover-color: #353393;
-
-    /* Checkbox */
-    --checkbox-bg-default: #2a2e38;
-    --checkbox-bg-checked: #2a2979;
-    --checkbox-checkmark-border-color: #ffffff;
-    --checkbox-pulse-color: rgba(76,108,255,0.3);
-
-    /* Download status */
-    --download-status-color: #ff8e8e;
-
-    /* Video Info Box */
-    --infos-box-color: #1e222ad0;
-    --video-info-text-color: #e8e8f0;
-    --video-info-heading-color: #9ab6ff;
-    --video-info-list-color: #c0d4ff;
-    --video-info-list-strong-color: #ffffff;
-    --video-info-link-color: #4c6cff;
-    --video-info-link-hover-color: #6c8dff;
-
-    /* Playlist Color */
-    --playlist-background-color: #424b5cc2;
-
-    /* Settings */
-    --settings-button-bg-color: #1e222ace;
-    --settings-button-text-color: #b3b3b4;  
-
-    --settings-bg-primary-color: #1e222a;
-    --settings-bg-secondary-color: #272d38;
-
-    --settings-text-color: #bababa; 
-    --settings-subtitle-color: #cacaca;
-}
-
-
-
-body.drift .download-path{
-    color: #ededed;
-}

public/styles/theme/fanatic-theme.css

@@ -1,49 +0,0 @@
-body.fanatic{
-  /* Couleurs générales */
-  --background-color: #121212;
-  --default-text-color: #eee;
-  --subtitle-color: #FF5900;
-  --mp3-text-color: #ffffff;
-
-  /* Formulaire */
-  --form-bg-color: #1e1e1e;
-  --form-input-bg-color: #2b2b2b;
-  --form-input-border-color: #333333;
-  --form-input-border-focus-color: #FF5900;
-  --form-input-text-color: #eeeeee;
-  --form-input-placeholder-color: #666666;
-  --form-button-bg-color: #FF5900;
-  --form-button-text-color: #121212;
-  --form-button-bg-hover-color: #e65500;
-
-  /* Checkbox */
-  --checkbox-bg-default: #555555;
-  --checkbox-bg-checked: #ff6600;
-  --checkbox-checkmark-border-color: #eee;
-  --checkbox-pulse-color: rgba(255, 102, 0, 0.5);
-
-  /* Download status */
-  --download-status-color: #FF5900;
-
-  /* Video Info Box */
-  --infos-box-color: #222222;
-  --video-info-text-color: #eee;
-  --video-info-heading-color: #FF5900;
-  --video-info-list-color: #ccc;
-  --video-info-list-strong-color: #fff;
-  --video-info-link-color: #FF5900;
-  --video-info-link-hover-color: #e65500;
-
-  /* Playlist Color */
-  --playlist-background-color: #2b2b2b;
-
-  /* Settings */
-  --settings-button-bg-color: #1e1e1e;
-  --settings-button-text-color: #dcdcdc;  
-
-  --settings-bg-primary-color: #1e1e1e;
-  --settings-bg-secondary-color: #2d2d2d;
-
-  --settings-text-color: #cecece; 
-  --settings-subtitle-color: #adadad;
-}

public/styles/theme/light-theme.css

@@ -1,48 +0,0 @@
-body.light {
-  /* Couleurs générales */
-  --background-color: #dadada;
-  --default-text-color: #222222;
-  --subtitle-color: #007bff;
-  --mp3-text-color: #000000;
-
-  /* Formulaire */
-  --form-bg-color: #ffffff;
-  --form-input-bg-color: #fafafa;
-  --form-input-border-color: #cccccc;
-  --form-input-border-focus-color: #007bff;
-  --form-input-text-color: #333333;
-  --form-input-placeholder-color: #888888;
-  --form-button-bg-color: #007bff;
-  --form-button-text-color: #ffffff;
-  --form-button-bg-hover-color: #0056b3;
-
-  /* Checkbox */
-  --checkbox-bg-default: #cccccc;
-  --checkbox-bg-checked: #007bff;
-  --checkbox-checkmark-border-color: #ffffff;
-  --checkbox-pulse-color: rgba(0, 123, 255, 0.4);
-
-  /* Download status */
-  --download-status-color: #007bff;
-
-  /* Video Info Box */
-  --infos-box-color: #ffffff;
-  --video-info-text-color: #222222;
-  --video-info-heading-color: #007bff;
-  --video-info-list-color: #444444;
-  --video-info-list-strong-color: #000000;
-  --video-info-link-color: #007bff;
-  --video-info-link-hover-color: #0056b3;
-
-  /* Playlist Color */
-  --playlist-background-color: #c5c5c5b2;
-
-  /* Settings */
-  --settings-button-bg-color: #e4e4e4;
-  --settings-button-text-color: var(--default-text-color);  
-
-  --settings-bg-primary-color: #cbcbcb;
-  --settings-bg-secondary-color: #cbcbcb;
-  --settings-text-color: var(--default-text-color); 
-  --settings-subtitle-color: #656565; 
-}

public/styles/theme/neon-theme.css

@@ -1,59 +0,0 @@
-body.neon {
-
-    background: (url("../../assets/images/drift.jpg"));
-    background-image: linear-gradient(135deg, #0f0c29, #302b63, #24243e); /* dégradé sombre violet/bleu */
-    background-size: cover;
-    background-position: center;
-    background-attachment: fixed;
-
-    /* Couleurs générales */
-    --background-color: #1b1b2f;
-    --default-text-color: #e0e0ff;
-    --subtitle-color: #a3a3ff;
-    --mp3-text-color: #c0c0ff;
-
-    /* Formulaire */
-    --form-bg-color: #2c2c4a;
-    --form-input-bg-color: #1f1f3a;
-    --form-input-border-color: #5858f0;
-    --form-input-border-focus-color: #a3a3ff;
-    --form-input-text-color: #ffffff;
-    --form-input-placeholder-color: #8888ff;
-    --form-button-bg-color: #5858f0;
-    --form-button-text-color: #ffffff;
-    --form-button-bg-hover-color: #7a7aff;
-
-    /* Checkbox */
-    --checkbox-bg-default: #302b63;
-    --checkbox-bg-checked: #5858f0;
-    --checkbox-checkmark-border-color: #ffffff;
-    --checkbox-pulse-color: rgba(88,88,240,0.3);
-
-    /* Download status */
-    --download-status-color: #a3a3ff;
-
-    /* Video Info Box */
-    --infos-box-color: #2c2c4a;
-    --video-info-text-color: #e0e0ff;
-    --video-info-heading-color: #a3a3ff;
-    --video-info-list-color: #c0c0ff;
-    --video-info-list-strong-color: #ffffff;
-    --video-info-link-color: #5858f0;
-    --video-info-link-hover-color: #7a7aff;
-
-    /* Playlist Color */
-    --playlist-background-color: #3e3e64;
-
-    /* Settings */
-    --settings-button-bg-color: #202038;
-    --settings-button-text-color: var(--default-text-color);  
-
-    --settings-bg-primary-color: #242454;
-    --settings-bg-secondary-color: #2f2f6f;
-    --settings-text-color: var(--default-text-color); 
-    --settings-subtitle-color: #d2d2d2; 
-}
-
-body.neon .download-path {
-  color: var(--default-text-color);
-}

public/styles/theme/nf-theme.css

@@ -1,58 +0,0 @@
-body.nf {
-
-  background-image: url('../../assets/images/NF.jpg');
-  background-size: cover;
-  background-position: 70% center; 
-  background-attachment: fixed;
-
-  /* Couleurs générales */
-  --background-color: #1a1a1a;
-  --default-text-color: #e6dfd5;
-  --subtitle-color: #f5f0e6;
-  --mp3-text-color: #d8cfc2;
-
-  /* Formulaire */
-  --form-bg-color: #2a2a2a;
-  --form-input-bg-color: #222222;
-  --form-input-border-color: #4a4036;
-  --form-input-border-focus-color: #cbb89d;
-  --form-input-text-color: #f0e8dd;
-  --form-input-placeholder-color: #9a8f80;
-  --form-button-bg-color: #cbb89d;
-  --form-button-text-color: #1a1a1a;
-  --form-button-bg-hover-color: #b7a588;
-
-  /* Checkbox */
-  --checkbox-bg-default: #4a4036;
-  --checkbox-bg-checked: #cbb89d;
-  --checkbox-checkmark-border-color: #1a1a1a;
-  --checkbox-pulse-color: rgba(203,184,157,0.3);
-
-  /* Download status */
-  --download-status-color: #cbb89d;
-
-  /* Video Info Box */
-  --infos-box-color: #2a2a2a;
-  --video-info-text-color: #e6dfd5;
-  --video-info-heading-color: #f5f0e6;
-  --video-info-list-color: #d8cfc2;
-  --video-info-list-strong-color: #ffffff;
-  --video-info-link-color: #cbb89d;
-  --video-info-link-hover-color: #b7a588;
-
-  /* Playlist Color */
-  --playlist-background-color: #4f4f4f;
-
-  /* Settings */
-  --settings-button-bg-color: #2a2a2a;
-  --settings-button-text-color: var(--default-text-color);  
-
-  --settings-bg-primary-color: #2a2a2a;
-  --settings-bg-secondary-color: #313131;
-  --settings-text-color: var(--default-text-color); 
-  --settings-subtitle-color: #7a7979; 
-}
-
-body.nf .download-path {
-  color: var(--default-text-color);
-}

public/styles/theme/songbird-theme.css

@@ -1,58 +0,0 @@
-body.songbird {
-
-  background-image: url('../../assets/images/Songbird.webp');
-  background-size: cover;
-  background-position: center center;
-  background-attachment: fixed;
-
-  /* Couleurs générales */
-  --background-color: #0a0a0a; /* noir profond */
-  --default-text-color: #ff2a2a; /* rouge néon */
-  --subtitle-color: #f2f2f2; /* rouge sombre */
-  --mp3-text-color: #ff4d4d; /* rouge un peu plus clair */
-
-  /* Formulaire */
-  --form-bg-color: rgba(20,0,0,0.85); /* noir semi-transparent avec rouge */
-  --form-input-bg-color: #1a0a0a;
-  --form-input-border-color: #ff2a2a;
-  --form-input-border-focus-color: #b30000;
-  --form-input-text-color: #ffffff;
-  --form-input-placeholder-color: #950404;
-  --form-button-bg-color: #b30000;
-  --form-button-text-color: #ffffff;
-  --form-button-bg-hover-color: #ff2a2a;
-
-  /* Checkbox */
-  --checkbox-bg-default: #630000;
-  --checkbox-bg-checked: #ff2a2a;
-  --checkbox-checkmark-border-color: #ffffff;
-  --checkbox-pulse-color: rgba(255,42,42,0.3);
-
-  /* Download status */
-  --download-status-color: #ff2a2a;
-
-  /* Video Info Box */
-  --infos-box-color: rgba(30,0,0,0.9);
-  --video-info-text-color: #ff4d4d;
-  --video-info-heading-color: #ff2a2a;
-  --video-info-list-color: #b30000;
-  --video-info-list-strong-color: #ffffff;
-  --video-info-link-color: #ff2a2a;
-  --video-info-link-hover-color: #b30000;
-
-  /* Playlist Color */
-  --playlist-background-color: #3f0000;
-  
-  /* Settings */
-  --settings-button-bg-color: rgba(29, 0, 0, 0.784);
-  --settings-button-text-color: var(--default-text-color);  
-
-  --settings-bg-primary-color: #121212;
-  --settings-bg-secondary-color: #1a1a1a;
-  --settings-text-color: var(--default-text-color); 
-  --settings-subtitle-color: #7a7979; 
-}
-
-body.cyberpunk .download-path {
-  color: var(--default-text-color);
-}

public/styles/theme/spicy-theme.css

@@ -1,59 +0,0 @@
-body.spicy {
-    /* Couleurs générales */
-    --background-color: #121212;             /* fond noir profond */
-    --default-text-color: #ffffff;           /* texte clair */
-    --subtitle-color: #f87918;               /* accent rouge piment */
-    --mp3-text-color: #ffffff;               /* texte checkbox inline */
-
-    /* Formulaire */
-    --form-bg-color: #1a1a1a;                /* fond formulaire gris très foncé */
-    --form-input-bg-color: #2b2b2b;          /* fond inputs gris foncé */
-    --form-input-border-color: #444444;      /* bordure gris */
-    --form-input-border-focus-color: #ff1a1a; /* focus rouge piment */
-    --form-input-text-color: #eeeeee;        /* texte inputs */
-    --form-input-placeholder-color: #888888; /* placeholder gris moyen */
-    --form-button-bg-color: #ff1a1a;         /* bouton rouge vif */
-    --form-button-text-color: #ffffff;       /* texte bouton blanc */
-    --form-button-bg-hover-color: #cc0000;   /* hover rouge foncé */
-
-    /* Checkbox */
-    --checkbox-bg-default: #555555;            /* gris moyen */
-    --checkbox-bg-checked: #ff1a1a;            /* rouge piment */
-    --checkbox-checkmark-border-color: #f5f5f5; /* blanc cassé */
-    --checkbox-pulse-color: rgba(255, 26, 26, 0.5); /* pulse rouge translucide */
-
-    /* Download status */
-    --download-status-color: #ffffff;          /* rouge vif */
-
-    /* Video Info Box */
-    --infos-box-color: #1a1a1a;                /* fond infos gris foncé */
-    --video-info-text-color: #f5f5f5;          /* texte clair */
-    --video-info-heading-color: #ff1a1a;       /* titres rouges */
-    --video-info-list-color: #cccccc;          /* texte liste gris clair */
-    --video-info-list-strong-color: #ffffff;   /* texte important blanc */
-    --video-info-link-color: #ff1a1a;          /* liens rouges */
-    --video-info-link-hover-color: #cc0000;    /* liens hover rouge foncé */
-
-    /* Playlist Color */
-    --playlist-background-color: #353232;
-
-    /* Settings */ 
-    --settings-button-bg-color: #1a1a1a;
-    --settings-button-text-color: #dcdcdc;  
-
-    --settings-bg-primary-color: #1a1a1a;
-    --settings-bg-secondary-color: #292929;
-
-    --settings-text-color: #cecece; 
-    --settings-subtitle-color: #adadad;
-
-}
-
-/* Optionnel: background piments */
-body.spicy {
-  background-image: url('../../assets/images/Spicy.png');  
-  background-size:cover;
-  background-position: center;
-  background-attachment: fixed;
-  background-repeat: no-repeat;
-}

public/styles/theme/themeimport.css

@@ -1,9 +0,0 @@
-@import url("chirac-theme.css");
-@import url("dark-theme.css");
-@import url("fanatic-theme.css");
-@import url("light-theme.css");
-@import url("nf-theme.css");
-@import url("drift-theme.css");
-@import url("neon-theme.css");
-@import url("songbird-theme.css");
-@import url("spicy-theme.css")

public/styles/variables.css

@@ -3,7 +3,7 @@
   --background-color: #001224;
   --default-text-color: #eee;
   --subtitle-color: #007bff;
-  --mp3-text-color: #000000;
+  --audio-only-label-color: #000000;
 
   /* Formulaire */
   --form-bg-color: #ffffff;
@@ -15,18 +15,23 @@
   --form-button-bg-color: #007bff;
   --form-button-text-color: #ffffff;
   --form-button-bg-hover-color: #0056b3;
+  --paste-button-icon-color: #ffffff;
 
   /* Checkbox */
-  --checkbox-bg-default: #cccccc;
-  --checkbox-bg-checked: #3B82F6;
+  --checkbox-unchecked-bg-color: #cccccc;
+  --checkbox-checked-bg-color: #3B82F6;
   --checkbox-checkmark-border-color: #E0E0E2;
   --checkbox-pulse-color: rgba(59, 130, 246, 0.5);
 
   /* Download status */
   --download-status-color: #007bff;
 
+  /* Progress bar */
+  --progress-bar-bg-color: #cccccc;
+  --progress-bar-fill-color: #007bff;
+
   /* Video Info Box */
-  --infos-box-color: #f0f0f0;
+  --video-info-bg-color: #f0f0f0;
   --video-info-text-color: #222222;
   --video-info-heading-color: #007bff;
   --video-info-list-color: #444444;
@@ -34,12 +39,15 @@
   --video-info-link-color: #007bff;
   --video-info-link-hover-color: #0056b3;
 
+  /* Playlist */
+  --playlist-background-color: #4f4f4f;
+
   /* Settings */
   --settings-button-bg-color: var(--form-bg-color);
   --settings-button-text-color: var(--default-text-color);  
 
-  --settings-bg-primary-color: var(--form-bg-color);
-  --settings-bg-secondary-color: var(--form-bg-color);
+  --settings-modal-bg-color: var(--form-bg-color);
+  --settings-section-bg-color: var(--form-bg-color);
   --settings-text-color: var(--default-text-color);  
   --settings-subtitle-color: #aaa;
 

server/controller/download.controller.js

@@ -1,11 +1,50 @@
-const { fetchDownload } = require("../services/download.services");
+const { fetchDownload, cancelDownload } = require("../services/download.services");
 const { logger } = require("../logger");
 const { isValidUrl, isSafePath } = require("../helpers/validation.helpers");
 const { notifyDownloadFinished } = require("../helpers/notify.helpers");
+const { configFeatures } = require("../../config");
 
-const listeners = [];
+/**
+ * Active Server-Sent Event subscribers receiving
+ * download progress updates.
+ *
+ * Each listener receives a percentage value between
+ * 0 and 100 during the download lifecycle.
+ */
+const progressListeners = [];
+
+/**
+ * Active Server-Sent Event subscribers receiving
+ * download speed updates.
+ */
 const speedListeners = [];
 
+/**
+ * Active Server-Sent Event subscribers receiving
+ * download stage updates.
+ */
+const stageListeners = [];
+
+/**
+ * Active Server-Sent Event subscribers receiving
+ * playlist progress information.
+ */
+const playlistListeners = [];
+
+/**
+ * Handles download requests and starts a yt-dlp download.
+ *
+ * Validates user input, prepares download options and
+ * delegates the download process to the download service.
+ *
+ * Once the download completes successfully, a desktop
+ * notification may be displayed depending on the
+ * application configuration.
+ *
+ * @param {import("express").Request} req
+ * @param {import("express").Response} res
+ * @returns {Promise<void>}
+ */
 async function downloadController(req, res) {
   try {
     const options = {
@@ -13,25 +52,39 @@ async function downloadController(req, res) {
       audioOnly: req.body.audioOnly === "1",
       quality: req.body.quality || "best",
       outputFolder: req.body.savePath || undefined,
+      playlistTitle: req.body.playlistTitle || undefined,
     };
 
-    if (!options.url || !isValidUrl(options.url)) return res.status(400).send("❌ Invalid URL !");
+    if (!options.url || !isValidUrl(options.url)) return res.status(400).send("Invalid URL !");
     if (options.outputFolder && !isSafePath(options.outputFolder)) {
       logger.warn(`Unsafe download path rejected: ${options.outputFolder}`);
-      return res.status(400).send("❌ Save Path Not Allowed.");
+      return res.status(400).send("Save Path Not Allowed.");
     }
 
-    // Get output folder when the download is finished
-    const outputFolder = await fetchDownload(options, listeners, speedListeners);
-    notifyDownloadFinished(outputFolder);
-    res.send("✅ Download Done !");
+    const outputFolder = await fetchDownload(
+      options,
+      progressListeners,
+      speedListeners,
+      stageListeners,
+      playlistListeners
+    );
+    
+    notifyDownloadFinished(outputFolder, configFeatures.notifySystem);
+    res.send("Download Done !");
     
   } catch (err) {
-    logger.error(`Server Error in /download : ${err.message}`);
-    res.status(500).send(`❌ Server Error`);
+    logger.error(`Server Error in /download: ${err?.message ?? err}`);
+    res.status(500).send("Server Error");
   }
 }
 
+/**
+ * Opens a Server-Sent Events (SSE) connection used to
+ * stream download progress updates to the client.
+ *
+ * @param {import("express").Request} req
+ * @param {import("express").Response} res
+ */
 function progressController(req, res) {
   res.set({
     'Content-Type': 'text/event-stream',
@@ -40,14 +93,21 @@ function progressController(req, res) {
   });
 
   const sendProgress = percent => res.write(`data: ${percent}\n\n`);
-  listeners.push(sendProgress);
+  progressListeners.push(sendProgress);
 
   req.on('close', () => {
-    listeners.splice(listeners.indexOf(sendProgress), 1);
+    progressListeners.splice(progressListeners.indexOf(sendProgress), 1);
     res.end();
   });
 }
 
+/**
+ * Opens a Server-Sent Events (SSE) connection used to
+ * stream download speed updates to the client.
+ *
+ * @param {import("express").Request} req
+ * @param {import("express").Response} res
+ */
 function speedController(req, res) {
   res.set({
     'Content-Type': 'text/event-stream',
@@ -64,5 +124,75 @@ function speedController(req, res) {
   });
 }
 
+/**
+ * Opens a Server-Sent Events (SSE) connection used to
+ * stream download stage updates such as downloading,
+ * merging, extracting audio or embedding metadata.
+ *
+ * @param {import("express").Request} req
+ * @param {import("express").Response} res
+ */
+function stageController(req, res) {
+  res.set({
+    'Content-Type': 'text/event-stream',
+    'Cache-Control': 'no-cache',
+    'Connection': 'keep-alive',
+  });
 
-module.exports = { downloadController, progressController, speedController};
+  const sendStage = stage => res.write(`data: ${stage}\n\n`);
+  stageListeners.push(sendStage);
+
+  req.on('close', () => {
+    stageListeners.splice(stageListeners.indexOf(sendStage), 1);
+    res.end();
+  });
+}
+
+/**
+ * Cancels the currently running download process.
+ *
+ * Returns an error response if no download is active.
+ *
+ * @param {import("express").Request} req
+ * @param {import("express").Response} res
+ */
+function cancelDownloadController(req, res) {
+  const cancelled = cancelDownload();
+  if (cancelled) {
+    logger.info("Download and queue cancelled by user");
+    res.send("Download stopped! Queue cleared.");
+  } else {
+    logger.warn("No download to cancel");
+    res.status(400).send("No download in progress !");
+  }
+}
+
+/**
+ * Opens a Server-Sent Events (SSE) connection used to
+ * stream playlist progress information to the client.
+ *
+ * Example:
+ * - Item 1 of 20
+ * - Item 12 of 20
+ * - Item 20 of 20
+ *
+ * @param {import("express").Request} req
+ * @param {import("express").Response} res
+ */
+function playlistInfoController(req, res) {
+  res.set({
+    'Content-Type': 'text/event-stream',
+    'Cache-Control': 'no-cache',
+    'Connection': 'keep-alive',
+  });
+
+  const sendPlaylistInfo = info => res.write(`data: ${info}\n\n`);
+  playlistListeners.push(sendPlaylistInfo);
+
+  req.on('close', () => {
+    playlistListeners.splice(playlistListeners.indexOf(sendPlaylistInfo), 1);
+    res.end();
+  });
+}
+
+module.exports = { downloadController, progressController, speedController, stageController, cancelDownloadController, playlistInfoController};

server/controller/info.controller.js

@@ -3,45 +3,114 @@ const { parseVideo, parsePlaylist } = require("../helpers/parseInfo.helpers");
 const { logger } = require("../logger");
 const { isValidUrl } = require("../helpers/validation.helpers");
 
-async function infoController(req, res){
+/**
+ * Handles metadata retrieval for a video or playlist.
+ *
+ * This controller:
+ * - Validates incoming URL (query or body)
+ * - Calls yt-dlp metadata extraction service
+ * - Detects playlist vs single video context
+ * - Applies fallback strategy if playlist extraction fails
+ * - Returns normalized parsed response (video or playlist)
+ *
+ * @param {import("express").Request} req
+ * @param {import("express").Response} res
+ */
+async function infoController(req, res) {
 
-    const url = req.body.url || req.query.url; // POST et GET
+    const url = req.body.url || req.query.url; // Supports POST and GET requests
 
-
-    // If no url, non-string url or invalid url
-
-    if (!url || typeof url !== "string" || !isValidUrl(url)) return res.status(400).send("❌ Invalid URL Or Missing");
-
-    logger.info(`/Info Request receive by the Info Controller. URL: ${url}`);
-
-    if (url.includes("&list") || url.includes("?list")) {
-        logger.info("Estimated Data Type: Playlist")
-
-    } else{
-        logger.info("Estimated Data Type: Video")
+    /**
+     * Basic validation:
+     * - URL must exist
+     * - Must be a string
+     * - Must pass custom URL validation
+     */
+    if (!url || typeof url !== "string" || !isValidUrl(url)) {
+        return res.status(400).send("Invalid URL Or Missing");
     }
 
+    logger.info(`Info request received. URL: ${url}`);
+
+    // Lightweight heuristic to detect playlist URLs
+    const isPlaylistUrl = url.includes("&list") || url.includes("?list");
+
+    logger.info(
+        isPlaylistUrl
+            ? "Estimated Data Type: Playlist"
+            : "Estimated Data Type: Video"
+    );
+
     try {
-    const data = await fetchInfo(url);
+        let data;
 
-    if (data._type === "playlist") {
+        /**
+         * Primary metadata fetch attempt
+         */
+        try {
+            data = await fetchInfo(url);
+        } catch (err) {
 
-        const playlist = parsePlaylist(data);
-        logger.info(`Playlist : ${playlist.title} (${playlist.count} vidéos)`);
-        return res.json(playlist);
+            /**
+             * Fallback strategy:
+             * If playlist extraction fails, retry as single video
+             */
+            if (isPlaylistUrl) {
 
-    } else{
-        const video = parseVideo(data);
-        logger.info(`Unique Video: ${video.title}`);
-        return res.json(video);
-    }
+                logger.info(
+                    `Playlist fetch failed: ${err.message}. Retrying as single video...`
+                );
 
+                // Remove playlist query parameter (best-effort cleanup)
+                const singleVideoUrl = url.split("&list")[0].split("?list")[0];
+
+                try {
+                    data = await fetchInfo(singleVideoUrl);
+                    logger.info("Single video fetch succeeded after playlist failure");
+                } catch (retryErr) {
+                    logger.error(
+                        `Single video fetch also failed: ${retryErr.message}`
+                    );
+
+                    // Preserve original error context
+                    throw err;
+                }
+
+            } else {
+                throw err;
+            }
+        }
+
+        /**
+         * Normalize response based on yt-dlp output type
+         */
+        if (data._type === "playlist") {
+
+            const playlist = parsePlaylist(data);
+
+            logger.info(
+                `Playlist fetched: ${playlist.title} (${playlist.count} videos)`
+            );
+
+            return res.json(playlist);
+
+        } else {
+
+            const video = parseVideo(data);
+
+            logger.info(`Video fetched: ${video.title}`);
+
+            return res.json(video);
+        }
 
     } catch (err) {
-        logger.error(`Info controller error: ${err && err.message ? err.message : err}`);
-        return res.status(500).send(`❌ Unable to fetch info`);
+
+        logger.error(
+            `Info controller error: ${err && err.message ? err.message : err}`
+        );
+
+        return res.status(500).send("Unable to fetch info");
     }
-    
 }
 
-module.exports = {infoController};
+module.exports = { infoController };

server/discordRPC.js

@@ -1,47 +0,0 @@
-const config = require('../config');
-const RPC = require("discord-rpc");
-const { logger } = require("./logger");
-
-const clientId = `${config.DiscordRPCID}`;
-const rpc = new RPC.Client({ transport: "ipc" });
-
-let intervalId;
-
-function startRPC() {
-  rpc.on("ready", () => {
-    const presence = {
-      largeImageKey: "icon",
-      smallImageKey: "acnolo_pfp",
-      smallImageText: "By MasterAcnolo",
-      startTimestamp: new Date(),
-      details: `Open Source Download Tools - ${config.version}`,
-      state: "masteracnolo.github.io/FreedomLoader",
-    };
-    rpc.clearActivity()
-    rpc.setActivity(presence);
-
-  });
-
-  rpc.login({ clientId }).catch(err => {
-    logger.error("Unable to connect to the RPC:", err);
-  });
-}
-
-async function stopRPC(){
-    try {
-      if (intervalId) clearInterval(intervalId);
-
-      if (rpc && rpc.transport) {
-        await rpc.clearActivity()
-        await rpc.destroy();
-      } else{
-        logger.error("Not Able to close RPC")
-      }
-      
-    } catch (err) {
-      logger.error("Error while closing the RPC:", err);
-    }
-  }
-
-
-module.exports = { startRPC, stopRPC};

server/helpers/buildArgs.helpers.js

@@ -5,6 +5,26 @@ const { ffmpegPath, denoPath} = require("./path.helpers.js");
 const { configFeatures } = require("../../config.js");
 const { logger } = require("../logger.js");
 
+/**
+ * Validates whether the provided codec is supported by the application.
+ *
+ * If the codec is supported, it is returned unchanged.
+ * Otherwise, a warning is logged and the default codec ("h264")
+ * is returned as a fallback.
+ *
+ * Supported codecs:
+ * - av01
+ * - vp9.2
+ * - vp9
+ * - h265
+ * - h264
+ * - vp8
+ * - h263
+ * - theora
+ *
+ * @param {string} codec - Codec identifier to validate.
+ * @returns {string} A valid codec identifier.
+ */
 function validateCodec(codec){
 
   const validCodec = [
@@ -20,6 +40,28 @@ function validateCodec(codec){
   }
 }
 
+/**
+ * Builds the complete yt-dlp argument list based on the
+ * application configuration and download options.
+ *
+ * The generated arguments include:
+ * - Browser cookie extraction
+ * - FFmpeg integration
+ * - Deno runtime configuration
+ * - Metadata and thumbnail embedding
+ * - Playlist handling
+ * - Video/audio format selection
+ * - Quality filtering
+ * - Output file destination
+ *
+ * @param {Object} options - Download configuration.
+ * @param {string} options.url - Video or playlist URL.
+ * @param {boolean} options.audioOnly - Whether to extract audio only.
+ * @param {string} options.quality - Requested quality preset.
+ * @param {string} options.outputFolder - Download destination folder.
+ *
+ * @returns {string[]} Array of arguments ready to be passed to yt-dlp.
+ */
 function buildYtDlpArgs({ url, audioOnly, quality, outputFolder }) {
 
   logger.info("--- CONFIGURATION ---");

server/helpers/getBrowser.helpers.js

@@ -4,12 +4,36 @@ const path = require("path");
 const notify = require("./notify.helpers")
 const { logger } = require("../logger");
 
+/**
+ * Detects the first supported browser installed on the system.
+ *
+ * The detected browser is used by yt-dlp to import authentication
+ * cookies when required by certain platforms.
+ *
+ * Currently, Firefox is the only browser officially supported
+ * by the application.
+ *
+ * If no supported browser is found:
+ * - A warning is logged
+ * - A notification is displayed to the user
+ * - "firefox" is returned as a fallback to allow yt-dlp to
+ *   handle the error gracefully without crashing the application
+ *
+ * @returns {string} The detected browser identifier.
+ */
 function getUserBrowser() {
-  const userProfile = os.homedir();
+  //const userProfile = os.homedir();
+  const firefoxPath = getFirefoxProfilePath();
 
-  // List of browsers supported by yt-dlp (Currently I can only guarantee Firefox, Sorry)
+  /**
+   * Browsers supported by yt-dlp cookie extraction.
+   *
+   * Only Firefox is currently enabled and tested.
+   * Additional browsers can be enabled in the future
+   * once compatibility has been verified.
+   */
   const browsers = [
-    { name: "firefox", path: path.join(userProfile, "AppData", "Roaming", "Mozilla", "Firefox", "Profiles") },
+    { name: "firefox", path: firefoxPath },
     // { name: "chrome", path: path.join(userProfile, "AppData", "Local", "Google", "Chrome", "User Data", "Default") },
     // { name: "brave", path: path.join(userProfile, "AppData", "Local", "BraveSoftware", "Brave-Browser", "User Data", "Default") },
     // { name: "edge", path: path.join(userProfile, "AppData", "Local", "Microsoft", "Edge", "User Data", "Default") },
@@ -19,21 +43,60 @@ function getUserBrowser() {
     // { name: "whale", path: path.join(userProfile, "AppData", "Local", "Naver", "Naver Whale", "User Data", "Default") }
   ];
 
-  // Search for an available browser
+  // Search for the first available browser profile.
   for (const browser of browsers) {
-    if (fs.existsSync(browser.path)) {
+    if (browser.path && fs.existsSync(browser.path)) {
       logger.info(`Browser found: ${browser.name}`);
       return browser.name;
     }
   }
 
-  // No browser found - notify user
+  // No supported browser found => Notify User
   logger.warn("No supported browser found on the system");
-  notify.notifyFirefoxBrowserMissing();
-  
-  // Fallback: return "Firefox" to let YT-DLP manage error
-  // this avoid app crash
+
+  // If you somehow managed to live without Firefox and need help installing it. - Don't applied to my Linux chad
+  if (process.platform === "win32") {
+    notify.notifyFirefoxBrowserMissing();
+  }
+
+  // Fallback to Firefox and let yt-dlp handle the error gracefully.
+  // This prevents the application from crashing
   return "firefox";
 }
 
+function getFirefoxProfilePath() {
+  const home = os.homedir();
+
+  if (process.platform === "win32") {
+    return path.join(
+      home,
+      "AppData",
+      "Roaming",
+      "Mozilla",
+      "Firefox",
+      "Profiles"
+    );
+  }
+
+  if (process.platform === "linux") {
+    return path.join(
+      "usr",
+      "bin",
+      "firefox"
+    );
+  }
+
+  if (process.platform === "darwin") {
+    return path.join(
+      home,
+      "Library",
+      "Application Support",
+      "Firefox",
+      "Profiles"
+    );
+  }
+
+  return null;
+}
+
 module.exports = getUserBrowser

server/helpers/notify.helpers.js

@@ -1,7 +1,20 @@
 const { Notification, shell } = require("electron");
 const { iconPaths } = require("./path.helpers");
+const { logger } = require("../logger");
 
-function notifyDownloadFinished(folder) {
+/**
+ * Displays a system notification when a download completes successfully.
+ *
+ * If enabled, clicking the notification opens the download folder
+ * using the system file explorer.
+ *
+ * @param {string} folder - Path to the completed download folder.
+ * @param {boolean} notifyEnabled - Whether notifications are enabled in config.
+ */
+function notifyDownloadFinished(folder, notifyEnabled = true) {
+  if (!notifyEnabled) return;
+  if (!folder) return;
+  
   const notif = new Notification({
     title: "Freedom Loader",
     body: "Your download is complete, click here to open it.",
@@ -12,6 +25,15 @@ function notifyDownloadFinished(folder) {
   notif.show();
 }
 
+/**
+ * Displays a notification when browser cookies cannot be extracted.
+ *
+ * This usually indicates:
+ * - User is not logged in to the browser
+ * - Browser profile is inaccessible
+ *
+ * Clicking the notification opens a tutorial link.
+ */
 function notifyCookiesBrowserError(){
   const notif = new Notification({
     title: "Cookies Error",
@@ -19,23 +41,41 @@ function notifyCookiesBrowserError(){
     icon: iconPaths.error,
   });
 
-  notif.on("click", () => shell.openExternal("https://youtube.com/shorts/cN9f4s1Mf88?si=519QCVd_-fzJqRf1"));
+  notif.on("click", () =>
+    shell.openExternal(
+      "https://youtube.com/shorts/cN9f4s1Mf88?si=519QCVd_-fzJqRf1"
+    )
+  );
+
   notif.show();
 }
 
-function notifyFirefoxBrowserMissing(){
+/**
+ * Displays a notification when Firefox is not detected
+ * on the user system.
+ *
+ * This is required for cookie extraction via yt-dlp.
+ *
+ * Clicking the notification opens an installation guide.
+ */
+function notifyFirefoxBrowserMissing() {
   const notif = new Notification({
     title: "Firefox Missing",
     body: "Firefox was not found on your system. Click here to follow the installation guide",
     icon: iconPaths.error,
   });
 
-  notif.on("click", () => shell.openExternal("https://youtube.com/shorts/cN9f4s1Mf88?si=519QCVd_-fzJqRf1"))
+  notif.on("click", () =>
+    shell.openExternal(
+      "https://youtube.com/shorts/cN9f4s1Mf88?si=519QCVd_-fzJqRf1"
+    )
+  );
+
   notif.show();
 }
 
 module.exports = {
-  notifyDownloadFinished, 
+  notifyDownloadFinished,
   notifyCookiesBrowserError,
-  notifyFirefoxBrowserMissing
+  notifyFirefoxBrowserMissing,
 };

server/helpers/parseInfo.helpers.js

@@ -1,27 +1,38 @@
+/**
+ * Normalizes a video payload by attaching the resource type.
+ *
+ * @param {Object} data - Raw video metadata.
+ * @returns {Object} Normalized video object.
+ */
 function parseVideo(data) {
-
-    return {
-        type: "video",
-        ...data
-    };
+  return {
+    type: "video",
+    ...data
+  };
 }
 
+/**
+ * Transforms a raw playlist payload into a normalized structure
+ * containing playlist metadata and a simplified list of videos.
+ *
+ * @param {Object} data - Raw playlist metadata.
+ * @returns {Object} Normalized playlist object.
+ */
 function parsePlaylist(data) {
-    
-    return {
-        type: "playlist",
-        title: data.title || data.id,
-        channel: data.uploader,
-        count: data.entries.length,
-        videos: (data.entries || []).map(v => ({
-            id: v.id,
-            title: v.title,
-            url: v.webpage_url,
-            duration: v.duration,
-            thumbnail: v.thumbnail,
-            uploader: v.uploader
-        }))
-    };
+  return {
+    type: "playlist",
+    title: data.title || data.id,
+    channel: data.uploader,
+    count: data.entries.length,
+    videos: (data.entries || []).map(v => ({
+      id: v.id,
+      title: v.title,
+      url: v.webpage_url,
+      duration: v.duration,
+      thumbnail: v.thumbnail,
+      uploader: v.uploader
+    }))
+  };
 }
 
-module.exports = { parseVideo, parsePlaylist };
+module.exports = { parseVideo, parsePlaylist };

server/helpers/path.helpers.js

@@ -1,57 +1,256 @@
 const path = require("path");
 const fs = require("fs");
-const os = require("os");
 const { app } = require("electron");
 const config = require("../../config.js");
 
 const { logger } = require("../logger.js");
 
-// Centralized resource paths
-const resourcesPath = config.localMode 
-  ? path.join(__dirname, "../../ressources")
+/**
+ * Is the OS windows
+ */
+const isWindows = process.platform === 'win32'
+
+/**
+ * On windows the binaries are name.exe on Linux/macOS no
+ */
+const ext = isWindows ? '.exe' : ''
+
+/**  Centralized resource paths */
+const resourcesPath = config.devMode
+  ? path.join(__dirname, "../../resources")
   : process.resourcesPath;
 
-// Default download folder (centralized)
-const defaultDownloadFolder = path.join(os.homedir(), "Downloads", "Freedom Loader");
+/**  Default download folder (centralized) */
+const defaultDownloadFolder = path.join(app.getPath("downloads"), "Freedom Loader");
+
+/**
+ * Current platform:
+ * win32 | linux | darwin
+ */
+const platform = process.platform;
+
+/**
+ * Dev source tree uses platform-named subfolders (matches resources/binaries/{win-32,linux,darwin}).
+ * Packaged builds flatten everything directly under binaries/, since each
+ * platform build only ships its own binaries — no subfolder needed.
+ */
+const devPlatformFolder = {
+  win32: "win-32",
+  linux: "linux",
+  darwin: "darwin"
+}[platform];
+
+const binariesPath = config.devMode
+    ? path.join(resourcesPath, "binaries", devPlatformFolder)
+    : path.join(resourcesPath, "binaries");
+
+
+/**
+ * Runtime-resolved binary paths.
+ * These values differ between development and production builds.
+ */
 
-// Binary paths
 let userYtDlp;
 let ffmpegPath;
 let denoPath;
 
-const sourceYtDlp = path.join(resourcesPath, "binaries","yt-dlp.exe");
+/** Source binary bundled inside application resources (used for first-time copy) */
+const sourceYtDlp = path.join(
+  binariesPath,
+  `yt-dlp${ext}`
+);
 
-if (config.localMode) {
-  userYtDlp = path.join(__dirname, "../../ressources/yt-dlp.exe");
-  ffmpegPath = path.join(__dirname, "../../ressources/"); // <- has ffmpeg.exe and ffprobe.exe
-  denoPath = path.join(__dirname, "../../ressources/deno.exe"); 
+/**
+ * Resolve binary locations depending on environment:
+ * - dev: local resources folder
+ * - prod: extracted userData + packaged resources
+ */
+if (config.devMode) {
+  userYtDlp = path.join(
+    binariesPath,
+    `yt-dlp${ext}`
+  );
+
+  ffmpegPath = path.join(
+    binariesPath,
+    `ffmpeg${ext}`
+  );
+
+  denoPath = path.join(
+    binariesPath,
+    `deno${ext}`
+  );
 } else {
-  userYtDlp = path.join(app.getPath("userData"),"yt-dlp.exe");
-  ffmpegPath = path.join(resourcesPath, "binaries","ffmpeg.exe"); 
-  denoPath = path.join(resourcesPath, "binaries","deno.exe");
+  userYtDlp = path.join(
+    app.getPath("userData"),
+    `yt-dlp${ext}`
+  );
 
-  if (!fs.existsSync(userYtDlp)) {
+  ffmpegPath = path.join(
+    binariesPath,
+    `ffmpeg${ext}`
+  );
+
+  denoPath = path.join(
+    binariesPath,
+    `deno${ext}`
+  );
+
+  if (!fs.existsSync(userYtDlp) && fs.existsSync(sourceYtDlp)) {
     fs.copyFileSync(sourceYtDlp, userYtDlp);
+
+    // Linux/macOS executable permission
+    if (!isWindows) {
+      try {
+        fs.chmodSync(userYtDlp, 0o755);
+      } catch (err) {
+        logger.warn(`Failed to chmod yt-dlp: ${err.message}`);
+      }
+    }
   }
 }
 
-// Notification icon paths
+/**
+ * Centralized notification and UI icon paths.
+ * Used by Electron notifications and UI components.
+ */
 const iconPaths = {
   confirm: path.join(resourcesPath, "confirm-icon.png"),
   error: path.join(resourcesPath, "error.png"),
   app: path.join(resourcesPath, "app-icon.ico")
 };
 
-// Binary paths for verification
+/**
+ * Static reference paths to bundled binaries.
+ * Used mainly for verification and diagnostics.
+ */
 const binaryPaths = {
-  ytDlp: path.join(resourcesPath, "binaries", "yt-dlp.exe"),
-  ffmpeg: path.join(resourcesPath, "binaries", "ffmpeg.exe"),
-  ffprobe: path.join(resourcesPath, "binaries", "ffprobe.exe"),
-  deno: path.join(resourcesPath, "binaries", "deno.exe")
+  ytDlp: path.join(
+    binariesPath,
+    `yt-dlp${ext}`
+  ),
+
+  ffmpeg: path.join(
+    binariesPath,
+    `ffmpeg${ext}`
+  ),
+
+  ffprobe: path.join(
+    binariesPath,
+    `ffprobe${ext}`
+  ),
+
+  deno: path.join(
+    binariesPath,
+    `deno${ext}`
+  )
 };
 
-if (!userYtDlp){ logger.error("Missing YT-DLP")}
-if (!ffmpegPath){ logger.error("Missing FFMPEG")}
-if (!denoPath){ logger.error("Missing DENO")}
+/**
+ * Theme storage system:
+ * - default themes come from app resources
+ * - user themes are persisted in userData to survive updates
+ */
+const userThemesPath = path.join(app.getPath("userData"), "themes");
+const defaultThemesSourcePath = path.join(resourcesPath, "theme");
 
-module.exports = { userYtDlp, ffmpegPath, denoPath, iconPaths, binaryPaths, resourcesPath, defaultDownloadFolder };
+/**
+ * Initializes user theme directory and ensures default themes exist.
+ *
+ * - Creates user themes folder if missing
+ * - Copies bundled themes from resources if not present
+ * - Applies permissive permissions for runtime modification
+ */
+function initUserThemes() {
+  try {
+    if (!fs.existsSync(userThemesPath)) {
+      fs.mkdirSync(userThemesPath, { recursive: true });
+      // Ensure folder is writable
+      fs.chmodSync(userThemesPath, 0o777);
+      logger.info("Created user themes directory");
+    }
+
+    // Copy default themes from resources to user directory if they don't exist
+    if (fs.existsSync(defaultThemesSourcePath)) {
+      const defaultThemes = fs.readdirSync(defaultThemesSourcePath);
+      for (const theme of defaultThemes) {
+        const srcPath = path.join(defaultThemesSourcePath, theme);
+        const destPath = path.join(userThemesPath, theme);
+        if (!fs.existsSync(destPath)) {
+          try {
+            copyDirectory(srcPath, destPath);
+            fs.chmodSync(destPath, 0o777);
+            logger.info(`Copied default theme: ${theme}`);
+          } catch (copyErr) {
+            logger.warn(
+              `Failed to copy theme ${theme}: ${copyErr.message}. Theme folder will be created, add theme files manually.`
+            );
+
+            try {
+              fs.mkdirSync(destPath, { recursive: true });
+              fs.chmodSync(destPath, 0o777);
+            } catch (mkdirErr) {
+              logger.warn(
+                `Could not create theme directory ${theme}: ${mkdirErr.message}`
+              );
+            }
+          }
+        }
+      }
+    } else {
+      logger.warn(
+        `Default themes source path not found: ${defaultThemesSourcePath}`
+      );
+    }
+  } catch (err) {
+    logger.error(`Failed to initialize user themes: ${err.message}`);
+  }
+}
+
+/**
+ * Recursively copies a directory and its contents.
+ *
+ * @param {string} src - Source directory
+ * @param {string} dest - Destination directory
+ * @throws Error If copy operation fails
+ */
+function copyDirectory(src, dest) {
+  try {
+    if (!fs.existsSync(dest)) {
+      fs.mkdirSync(dest, {
+        recursive: true,
+        mode: 0o777
+      });
+    }
+
+    const files = fs.readdirSync(src);
+
+    for (const file of files) {
+      const srcFile = path.join(src, file);
+      const destFile = path.join(dest, file);
+
+      if (fs.statSync(srcFile).isDirectory()) {
+        copyDirectory(srcFile, destFile);
+      } else {
+        fs.copyFileSync(srcFile, destFile);
+      }
+    }
+  } catch (err) {
+    throw new Error(`Copy error: ${err.message}`);
+  }
+}
+
+// Runtime validation of critical binaries
+if (!userYtDlp) {
+  logger.error("Missing yt-dlp binary");
+}
+
+if (!ffmpegPath) {
+  logger.error("Missing ffmpeg binary");
+}
+
+if (!denoPath) {
+  logger.error("Missing deno binary");
+}
+
+module.exports = { userYtDlp, ffmpegPath, denoPath, iconPaths, binaryPaths, resourcesPath, defaultDownloadFolder, userThemesPath, initUserThemes, isWindows };

server/helpers/rateLimit.helpers.js

@@ -1,14 +1,24 @@
 const RateLimit = require("express-rate-limit");
 
 
-/* Rate Limite */
-const rateLimite = RateLimit({
+/**
+ * Rate limiter middleware used to protect public endpoints
+ * against abusive or excessive requests.
+ *
+ * Restrictions:
+ * - 5 requests per IP address
+ * - 15-minute sliding window
+ *
+ * When the limit is exceeded, a HTTP 429 (Too Many Requests)
+ * response is returned.
+ */
+const rateLimit = RateLimit({
   windowMs: 15 * 60 * 1000, // 15 minutes
-  max: 5, // limit each IP to 100 requests per windowMs on the root path
+  max: 5,
   message: "Too many requests, please try again later.",
-  statusCode: 429, // HTTP status code for "Too Many Requests"
+  statusCode: 429,
 });
 
 module.exports = {
-    rateLimite
+    rateLimit
 }

server/helpers/validation.helpers.js

@@ -1,21 +1,43 @@
 const path = require("path");
 
-function isValidUrl(url) { 
-  try { 
-      new URL(url); 
-      return true; 
-      
-    } catch { 
-      return false; 
-    } 
+/**
+ * Validates whether the provided string is a well-formed URL.
+ *
+ * The validation relies on the native URL constructor and
+ * returns `true` only if the value can be successfully parsed.
+ *
+ * @param {string} url - URL to validate.
+ * @returns {boolean} True if the URL is valid, otherwise false.
+ */
+function isValidUrl(url) {
+  try {
+    new URL(url);
+    return true;
 
+  } catch {
+    return false;
+  }
 }
 
+/**
+ * Validates whether a folder path is considered safe for
+ * file operations.
+ *
+ * Security checks:
+ * - Rejects empty or very short paths.
+ * - Resolves the absolute path before validation.
+ * - Prevents access to sensitive Windows system directories.
+ *
+ * @param {string} folder - Folder path to validate.
+ * @returns {boolean} True if the path is considered safe, otherwise false.
+ */
 function isSafePath(folder) {
   if (!folder || folder.length < 3) return false;
+
   const unsafe = ["System32", "\\Windows"];
   const resolved = path.resolve(folder);
+
   return !unsafe.some(u => resolved.includes(u));
 }
 
-module.exports = { isValidUrl, isSafePath };
+module.exports = { isValidUrl, isSafePath };

server/logger.js

@@ -4,9 +4,10 @@ const fs = require("fs");
 const path = require("path");
 const os = require("os");
 const config = require("../config");
+const {isWindows} = require("./helpers/path.helpers");
 
 // Logs folder in Windows
-const logDir = path.join(os.homedir(), "AppData", "Local", "FreedomLoader", "logs");
+const logDir = isWindows ? path.join(os.homedir(), "AppData", "Local", "FreedomLoader", "logs") : path.join(process.env.XDG_DATA_HOME || path.join(os.homedir(), ".local", "share"),  "FreedomLoader", "logs");
 
 // Create "Logs" folder if needed
 try {
@@ -20,7 +21,15 @@ const logFormat = format.combine(
   format.printf(({ timestamp, level, message }) => `${timestamp} | ${level.toUpperCase()} |  ${message}`)
 );
 
-// Logger configuration
+/**
+ * Logger Instance with differents types
+ *  - info
+ *  - error
+ *  - warn 
+ * 
+ * You need to specify the text that need to be displayed
+ * @param string
+ */
 const logger = createLogger({
   level: "info",
   format: logFormat,
@@ -40,11 +49,17 @@ const logger = createLogger({
   ],
 });
 
+/**
+ * Start Log Session 
+ */
 function logSessionStart() {
   logger.info(`--- Starting session: ${new Date().toISOString()} ---`);
   logger.info(`Application Version: ${config.version}`)
 }
 
+/**
+ * Stop Log Session
+ */
 function logSessionEnd() {
   logger.info(`--- Ending session: ${new Date().toISOString()} ---`);
 }

server/routes/download.route.js

@@ -1,11 +1,14 @@
 const express = require("express");
 const router = express.Router();
-const { downloadController, progressController, speedController } = require("../controller/download.controller");
+const { downloadController, progressController, speedController, stageController, cancelDownloadController, playlistInfoController } = require("../controller/download.controller");
 
 router.post("/", downloadController);
+router.post("/cancel", cancelDownloadController);
 
 // SSE for download progress
 router.get("/progress", progressController);
 router.get("/speed", speedController);
+router.get("/stage", stageController);
+router.get("/playlist-info", playlistInfoController);
 
 module.exports = router;

server/server.js

@@ -2,33 +2,30 @@ const express = require("express");
 const path = require("path");
 const { logger, logSessionEnd } = require("./logger");
 const config = require("../config");
-const { execFile } = require("child_process");
-const { userYtDlp } = require("./helpers/path.helpers");
-const { rateLimite } = require("./helpers/rateLimit.helpers")
+const { rateLimit } = require("./helpers/rateLimit.helpers");
 
 const app = express();
 
-app.use(express.json());
-
-// Update YT-DLP on Startup
-execFile(userYtDlp, ["-U"], (err, stdout, stderr) => {
-  if (err) logger.warn("yt-dlp update error:", err);
-  else logger.info(`Update yt-dlp : ${stdout}`);
-});
-
 // Middlewares
+app.use(express.json());
 app.use(express.urlencoded({ extended: true }));
 app.use(express.static(path.join(__dirname, "../public")));
 
 // Routes
 app.use("/download", require("./routes/download.route"));
-app.use("/info", require("./routes/info.route"));
-
-// When we get API Root, it return the front pages.
-app.get("/",  rateLimite ,(req, res) => {
+app.use("/info",     require("./routes/info.route"));
+app.get("/", rateLimit, (req, res) => {
   res.sendFile(path.join(__dirname, "../public/index.html"));
 });
 
+/**
+ * Initializes and starts the Express HTTP server.
+ * 
+ * - Binds the server to `config.applicationPort`
+ * - Resolves with the HTTP server instance on successful startup
+ * - Rejects on server binding or runtime errors
+ * - Registers SIGINT/SIGTERM handlers for graceful shutdown
+ */
 async function startServer() {
   return new Promise((resolve, reject) => {
     const server = app.listen(config.applicationPort, () => {
@@ -37,19 +34,25 @@ async function startServer() {
     });
 
     server.on("error", (err) => {
-      logger.error("Express Server Error :", err);
+      logger.error("Express server error:", err);
       reject(err);
     });
 
+    /**
+     * Clean exit function
+     *  - Stop Log 
+     *  - Stop Express Server
+     *  - Stop Electron App 
+     */
     const gracefulExit = () => {
       logSessionEnd();
       server.close(() => {
-        logger.info("Express Server close cleanly.");
+        logger.info("Express server closed cleanly.");
         process.exit();
       });
     };
 
-    process.on("SIGINT", gracefulExit);
+    process.on("SIGINT",  gracefulExit);
     process.on("SIGTERM", gracefulExit);
   });
 }

server/services/download.services.js

@@ -6,11 +6,138 @@ const { buildYtDlpArgs } = require("../helpers/buildArgs.helpers");
 const notify = require("../helpers/notify.helpers");
 const path = require("path");
 const { isSafePath } = require("../helpers/validation.helpers");
+const { configFeatures } = require("../../config.js");
 
-function fetchDownload(options, listeners, speedListeners) {
+/**
+ * Reference to the currently running yt-dlp process.
+ *
+ * Used to support download cancellation and lifecycle
+ * management.
+ *
+ * @type {import("child_process").ChildProcess|null}
+ */
+let currentDownloadProcess = null;
+
+/**
+ * Determines whether a URL targets a playlist.
+ *
+ * The detection is based on the presence of the YouTube
+ * playlist query parameter (`list`).
+ *
+ * @param {string} url - URL to inspect.
+ * @returns {boolean} True if the URL appears to be a playlist.
+ */
+function isPlaylistUrl(url) {
+  return url.includes("?list=") || url.includes("&list=");
+}
+
+/**
+ * Creates a dedicated download folder for a playlist.
+ *
+ * The playlist title is sanitized to ensure it can be safely
+ * used as a filesystem path. If the target folder already
+ * exists, an incremented suffix is appended until a unique
+ * folder name is found.
+ *
+ * If folder creation fails, a fallback folder named
+ * "Untitled Playlist X" is generated.
+ *
+ * @param {string} basePath - Parent download directory.
+ * @param {string} playlistTitle - Playlist title returned by yt-dlp.
+ * @returns {string} Absolute path of the created playlist folder.
+ * @throws {Error} If no valid folder can be created.
+ */
+function createPlaylistFolder(basePath, playlistTitle) {
+  const sanitizedTitle = playlistTitle
+    .replace(/[<>:"|?*]/g, '') 
+    .replace(/\s+/g, ' ') 
+    .trim()
+    .substring(0, 200);
+
+  const playlistPath = path.join(basePath, sanitizedTitle);
+  
+  try {
+    if (!fs.existsSync(playlistPath)) {
+      fs.mkdirSync(playlistPath, { recursive: true });
+      logger.info(`Playlist folder created: ${playlistPath}`);
+      return playlistPath;
+    }
+    
+    let counter = 1;
+    let newPath;
+    
+    while (counter <= 1000) {
+      newPath = path.join(basePath, `${sanitizedTitle} ${counter}`);
+      if (!fs.existsSync(newPath)) {
+        fs.mkdirSync(newPath, { recursive: true });
+        logger.info(`Playlist folder created with increment: ${newPath}`);
+        return newPath;
+      }
+      counter++;
+    }
+    
+    logger.error(`Could not find available playlist folder after 1000 attempts`);
+    throw new Error("Unable to create playlist folder");
+    
+  } catch (err) {
+    logger.warn(`Failed to create playlist folder with title "${sanitizedTitle}": ${err.message}`);
+    
+    // Fallback: create folder "Untitled Playlist X"
+    let counter = 1;
+    let fallbackPath;
+    
+    while (counter <= 1000) {
+      fallbackPath = path.join(basePath, `Untitled Playlist ${counter}`);
+      if (!fs.existsSync(fallbackPath)) {
+        try {
+          fs.mkdirSync(fallbackPath, { recursive: true });
+          logger.info(`Fallback playlist folder created: ${fallbackPath}`);
+          return fallbackPath;
+        } catch (mkErr) {
+          counter++;
+          continue;
+        }
+      }
+      counter++;
+    }
+    
+    logger.error(`Could not create playlist folder after 1000 attempts`);
+    throw new Error("Unable to create playlist folder");
+  }
+}
+
+/**
+ * Starts a yt-dlp download process and monitors its progress.
+ *
+ * Responsibilities:
+ * - Validates and prepares the output directory
+ * - Creates playlist folders when enabled
+ * - Builds yt-dlp command arguments
+ * - Spawns the yt-dlp process
+ * - Parses progress, speed and stage information
+ * - Notifies listeners about download events
+ * - Handles download completion and failures
+ *
+ * @param {Object} options - Download options.
+ * @param {string} options.url - Video or playlist URL.
+ * @param {string} [options.outputFolder] - Destination folder.
+ * @param {string} [options.playlistTitle] - Playlist title.
+ *
+ * @param {Function[]} listeners - Progress listeners.
+ * @param {Function[]} speedListeners - Download speed listeners.
+ * @param {Function[]} stageListeners - Processing stage listeners.
+ * @param {Function[]} playlistInfoListeners - Playlist progress listeners.
+ *
+ * @returns {Promise<string>}
+ * Resolves with the final output folder path once the
+ * download has completed successfully.
+ */
+function fetchDownload(options, listeners, speedListeners, stageListeners, playlistInfoListeners) {
 
   return new Promise((resolve, reject) => {
-    const outputFolder = options.outputFolder || defaultDownloadFolder;
+    logger.info(`CONFIG createPlaylistFolders: ${configFeatures.createPlaylistFolders}`);
+    
+    let outputFolder = options.outputFolder || defaultDownloadFolder;
     
     // Normalize path and validate it's safe (within Users folder)
     let safeOutputFolder = path.resolve(outputFolder);
@@ -29,16 +156,35 @@ function fetchDownload(options, listeners, speedListeners) {
       return reject(new Error(`Unable to create download folder: ${err.message}`));
     }
 
+    // Détecte si c'est une playlist et crée un dossier approprié
+    const isPlaylist = options.playlistTitle || isPlaylistUrl(options.url);
+    
+    if (isPlaylist && configFeatures.createPlaylistFolders) {
+      try {
+        const playlistName = options.playlistTitle || "Untitled Playlist";
+        safeOutputFolder = createPlaylistFolder(safeOutputFolder, playlistName);
+        logger.info(`Playlist detected, using folder: ${safeOutputFolder}`);
+      } catch (err) {
+        logger.error(`Failed to create playlist folder: ${err.message}`);
+        return reject(err);
+      }
+    } else if (isPlaylist && !configFeatures.createPlaylistFolders) {
+      logger.info(`Playlist detected but createPlaylistFolders is disabled, using base folder`);
+    }
+
     const args = buildYtDlpArgs({ ...options, outputFolder: safeOutputFolder });
     logger.info(`[yt-dlp args] ${args.join(" ")}`);
 
     const child = execFile(userYtDlp, args);
+    currentDownloadProcess = child;
 
     child.on("error", err => reject(new Error(`YT-DLP Error : ${err.message}`)));
 
     child.on("close", code => {
+      currentDownloadProcess = null;
       listeners.forEach(fn => fn("done"));
       if (code === 0) resolve(safeOutputFolder);
+      else if (code === null) reject(new Error(`Download cancelled by user`));
       else reject(new Error(`YT-DLP failed with code : ${code}`));
     });
 
@@ -49,7 +195,10 @@ function fetchDownload(options, listeners, speedListeners) {
         logger.info(`[yt-dlp] ${line}`);
 
         // Progress Bar 
-        if (line.startsWith("[download] Destination:")) listeners.forEach(fn => fn("reset"));
+        if (line.startsWith("[download] Destination:")) {
+          listeners.forEach(fn => fn("reset"));
+          stageListeners.forEach(fn => fn("Downloading..."));
+        }
         const match = line.match(/\[download\]\s+(\d+\.\d+)%/);
         if (match) listeners.forEach(fn => fn(parseFloat(match[1])));
 
@@ -61,6 +210,30 @@ function fetchDownload(options, listeners, speedListeners) {
             }
         }
 
+        // Playlist item tracking
+        const itemMatch = line.match(/Downloading\s+(?:item|video)?\s*(\d+)\s+of\s+(\d+)/i);
+        if (itemMatch) {
+          const itemInfo = `Item ${itemMatch[1]} of ${itemMatch[2]}`;
+          playlistInfoListeners.forEach(fn => fn(itemInfo));
+        }
+
+        // Stage messages
+        if (line.includes("[Merger]")) {
+          stageListeners.forEach(fn => fn("Merging formats..."));
+        }
+        if (line.includes("[ExtractAudio]")) {
+          stageListeners.forEach(fn => fn("Extracting audio..."));
+        }
+        if (line.includes("[Metadata]")) {
+          stageListeners.forEach(fn => fn("Adding metadata..."));
+        }
+        if (line.includes("[ThumbnailsConvertor]")) {
+          stageListeners.forEach(fn => fn("Converting thumbnail..."));
+        }
+        if (line.includes("[EmbedThumbnail]")) {
+          stageListeners.forEach(fn => fn("Embedding thumbnail..."));
+        }
+
         if (line.match(/ERROR: Could not copy .* cookie database/i)) {
           notify.notifyCookiesBrowserError();
         }
@@ -76,4 +249,41 @@ function fetchDownload(options, listeners, speedListeners) {
   });
 }
 
-module.exports = { fetchDownload };
+/**
+ * Cancels the currently running yt-dlp process.
+ *
+ * Attempts to terminate the entire process tree to ensure
+ * that yt-dlp and any spawned FFmpeg processes are stopped.
+ *
+ * @returns {boolean}
+ * True if a download process was cancelled,
+ * otherwise false.
+ */
+function cancelDownload() {
+  if (currentDownloadProcess) {
+    logger.info("Cancelling download and killing all child processes...");
+    
+    // Force kill the process and all its children with SIGKILL
+    try {
+      // Try to kill with SIGKILL on Windows (process group) or Unix
+      if (process.platform === 'win32') {
+        // On Windows, kill the process tree
+        require('child_process').execSync(`taskkill /PID ${currentDownloadProcess.pid} /T /F`, { stdio: 'ignore' });
+      } else {
+        // On Unix, send SIGKILL to process group
+        process.kill(-currentDownloadProcess.pid, 'SIGKILL');
+      }
+    } catch (err) {
+      logger.warn(`Error killing process: ${err.message}`);
+      // Fallback to regular kill
+      currentDownloadProcess.kill('SIGKILL');
+    }
+    
+    currentDownloadProcess = null;
+    logger.info("Download cancelled successfully");
+    return true;
+  }
+  return false;
+}
+
+module.exports = { fetchDownload, cancelDownload };

server/services/info.services.js

@@ -3,8 +3,30 @@ const { userYtDlp, denoPath } = require("../helpers/path.helpers");
 const getUserBrowser = require("../helpers/getBrowser.helpers");
 const { logger } = require("../logger");
 
+/**
+ * Retrieves metadata for a video or playlist using yt-dlp.
+ *
+ * The command executes yt-dlp in JSON mode and returns the
+ * parsed response object without downloading any media.
+ *
+ * Features:
+ * - Supports videos and playlists
+ * - Imports browser cookies when available
+ * - Uses Deno for JavaScript extraction
+ * - Applies a 30-second timeout
+ * - Limits response size to 10 MB
+ *
+ * @param {string} url - Video or playlist URL to inspect.
+ * @returns {Promise<Object>} Resolves with the metadata returned by yt-dlp.
+ *
+ */
 function fetchInfo(url) {
-    const args = [
+
+    /**
+     * Base yt-dlp arguments used to retrieve metadata
+     * without downloading media files.
+     */
+    const metadataArgs  = [
         "--js-runtimes", `deno:${denoPath}`,
         "--dump-single-json",
         "--ignore-errors",
@@ -16,9 +38,9 @@ function fetchInfo(url) {
 
     return new Promise((resolve, reject) => {
 
-        execFile(userYtDlp,[...args, url],
+        execFile(userYtDlp,[...metadataArgs , url],
             {   timeout: 30_000, // 30s, if more timeout
-                maxBuffer: 10 * 1024 * 1024 },  // 10MO max response (Default: 200ko)
+                maxBuffer: 10 * 1024 * 1024 },  // Maximum response size: 10 MB (Node.js default is much smaller)
                 
                 (error, stdout, stderr) => {
 

server/update.js

@@ -1,47 +0,0 @@
-const { autoUpdater } = require("electron-updater");
-const { app, Notification, shell} = require("electron");
-const { logger } = require("./logger");
-
-function AutoUpdater() {
-
-  autoUpdater.on("update-available", (info) => {
-    logger.info(`New Version Available : ${info.version}`);
-    new Notification({
-      title: "Freedom Loader",
-      body: `New Version Available : ${info.version}. Application will restart`
-    }).show();
-  });
-
-  autoUpdater.on("update-downloaded", (info) => {
-    logger.info(`Update Downloaded : ${info.version}`);
-    new Notification({
-      title: "Freedom Loader",
-      body: `Update ${info.version} downloaded.`
-    }).on("click", () =>
-      shell.openExternal("https://github.com/MasterAcnolo/Freedom-Loader/releases/latest")
-    ).show();
-
-    setTimeout(() => {
-      autoUpdater.quitAndInstall();
-    }, 5000);
-  });
-
-  autoUpdater.on("error", (err) => {
-    logger.error("Auto Update Error :", err.message);
-    new Notification({
-      title: "Freedom Loader - Update Error",
-      body: err.message
-    }).show();
-  });
-
-  app.whenReady().then(async () => {
-    try {
-      await autoUpdater.checkForUpdates();
-      logger.info("Update check completed");
-    } catch (err) {
-      logger.error("Error during update check :", err.message);
-    }
-  });
-}
-
-module.exports = { AutoUpdater };

theme/template.theme.json

@@ -0,0 +1,96 @@
+{
+  "meta": {
+    "name": "",
+    "author": "",
+    "version": "1.0.0",
+    "formatVersion": "1.0"
+  },
+
+  "style": {
+    "background": {
+      "image": "",
+      "size": "cover",
+      "position": "center",
+      "attachment": "fixed"
+    },
+
+    "colors": {
+      "background": "",
+      "text": {
+        "default": "",
+        "subtitle": "",
+        "audioOnly": ""
+      }
+    },
+
+    "form": {
+      "background": "",
+      "input": {
+        "background": "",
+        "border": "",
+        "borderFocus": "",
+        "text": "",
+        "placeholder": ""
+      },
+      "button": {
+        "background": "",
+        "text": "",
+        "hover": ""
+      },
+      "pasteButtonIcon": ""
+    },
+
+    "checkbox": {
+      "background": {
+        "unchecked": "",
+        "checked": ""
+      },
+      "checkmarkBorder": "",
+      "pulse": ""
+    },
+
+    "download": {
+      "status": ""
+    },
+
+    "progressBar": {
+      "background": "",
+      "fill": ""
+    },
+
+    "videoInfo": {
+      "background": "",
+      "text": "",
+      "heading": "",
+      "list": "",
+      "strong": "",
+      "link": "",
+      "linkHover": ""
+    },
+
+    "playlist": {
+      "background": ""
+    },
+
+    "settings": {
+      "button": {
+        "background": "",
+        "text": ""
+      },
+      "openThemeButton": {
+        "background": "",
+        "text": ""
+      },
+      "openJsonButton": {
+        "background": "",
+        "text": ""
+      },
+      "background": {
+        "modal": "",
+        "section": ""
+      },
+      "text": "",
+      "subtitle": ""
+    }
+  }
+}