Merge pull request #46 from MasterAcnolo/1.6.1

1.6.1

.gitignore

@@ -4,6 +4,7 @@
 # Build Output Folder
 /dist
 /out
+/srpm-out
 
 # Config JSON File. Create it and fill it if you want to have dev only settings
 config/config.dev.json

BINARIES.md

@@ -0,0 +1,96 @@
+# External binaries
+
+This project depends on three external tools that are **not bundled in the repository**.  
+You must download them manually and place each binary in the correct folder before building or running the app locally.
+
+---
+
+## Required tools
+
+| Tool    | Role                                        |
+|---------|---------------------------------------------|
+| yt-dlp  | Video and audio download engine             |
+| ffmpeg  | Media encoding, transcoding, muxing         |
+| ffprobe | Media file analysis and metadata extraction |
+| deno    | JavaScript / TypeScript runtime             |
+
+---
+
+## Folder structure
+
+Place the binaries exactly as shown below.  
+Do not rename them — the application resolves them by these exact names.
+
+```
+resources/
+└── binaries/
+    ├── linux/
+    │   ├── yt-dlp
+    │   ├── ffmpeg
+    │   ├── ffprobe
+    │   └── deno
+    └── win-32/
+        ├── yt-dlp.exe
+        ├── ffmpeg.exe
+        ├── ffprobe.exe
+        └── deno.exe
+```
+
+---
+
+## Download links
+
+### yt-dlp
+
+| Platform | URL                                                                  |
+|----------|----------------------------------------------------------------------|
+| Windows  | https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp.exe |
+| Linux    | https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp     |
+
+Rename the downloaded file to `yt-dlp` (or `yt-dlp.exe` on Windows).
+
+---
+
+### ffmpeg and ffprobe
+
+**Windows and Linux** — both binaries are included in the same archive.
+
+| Platform    | URL                                                                                                       |
+|-------------|-----------------------------------------------------------------------------------------------------------|
+| Windows x64 | https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-win64-gpl.zip         |
+| Linux x64   | https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-linux64-gpl.tar.xz    |
+| Linux arm64 | https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-linuxarm64-gpl.tar.xz |
+
+Extract the archive and copy `ffmpeg` and `ffprobe` from the `bin/` subfolder.
+
+---
+
+### deno
+
+| Platform    | URL                                                                                          |
+|-------------|----------------------------------------------------------------------------------------------|
+| Windows x64 | https://github.com/denoland/deno/releases/latest/download/deno-x86_64-pc-windows-msvc.zip    |
+| Linux x64   | https://github.com/denoland/deno/releases/latest/download/deno-x86_64-unknown-linux-gnu.zip  |
+| Linux arm64 | https://github.com/denoland/deno/releases/latest/download/deno-aarch64-unknown-linux-gnu.zip |
+
+Each archive contains a single binary. Rename it to `deno` (or `deno.exe` on Windows).
+
+---
+
+## Permissions (Linux )
+
+After placing the binaries, make them executable:
+
+```bash
+chmod +x resources/binaries/linux/yt-dlp
+chmod +x resources/binaries/linux/ffmpeg
+chmod +x resources/binaries/linux/ffprobe
+chmod +x resources/binaries/linux/deno
+```
+
+---
+
+## Notes
+
+- These binaries are excluded from version control via `.gitignore`.
+- Always use the latest stable release of each tool.

README.md

@@ -5,9 +5,9 @@
     alt="Banner"
     style="width: 50%;"/></a>
 
-### **A clean, open-source multimedia downloader for Windows**
+### **A clean, open-source multimedia downloader for Windows and Linux**
 
-[![Release](https://img.shields.io/badge/Release-1.5.1-blue?style=for-the-badge)](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+[![Release](https://img.shields.io/github/v/release/MasterAcnolo/Freedom-Loader?style=for-the-badge&color=blue)](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/Freedom-Loader-Site/)
 [![Workshop](https://img.shields.io/badge/Worshop-Visit-0E05A1?style=for-the-badge)](https://masteracnolo.github.io/Freedom-Loader-Workshop/)
@@ -86,35 +86,82 @@ The primary goal is to make media downloading accessible to users who want offli
 
 ## Installation
 
+[![Fedora Copr](https://img.shields.io/badge/Fedora-Copr-294172?style=for-the-badge&logo=fedora&logoColor=white)](https://copr.fedorainfracloud.org/coprs/masteracnolo/freedom-loader/)
+[![Debian/Ubuntu](https://img.shields.io/badge/.deb-Debian%2FUbuntu-A81D33?style=for-the-badge&logo=debian&logoColor=white)](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+[![Snap Store](https://img.shields.io/badge/Snap-Store-82BEA0?style=for-the-badge&logo=snapcraft&logoColor=white)](https://snapcraft.io/freedom-loader)
+[![AppImage](https://img.shields.io/badge/AppImage-Universal-1E88E5?style=for-the-badge&logo=linux&logoColor=white)](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+
 ### Requirements
 
-- **Operating System**: Windows 10 or later
+- **Windows**: Windows 10 or later
-- **Browser**: Mozilla Firefox (required for cookie extraction)
+- **Linux**: any modern x86_64 distribution
-  - [Download Firefox](https://www.firefox.com)
+- **Browser**: Mozilla Firefox ([download](https://www.firefox.com)) required for cookie extraction, on both platforms
 
-### Standard Installation
+### Windows
 
-1. Download the latest release from the [Releases page](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+1. Download the latest `.exe` from the [Releases page](https://github.com/MasterAcnolo/Freedom-Loader/releases)
-2. Run the downloaded `.exe` installer
+2. Run the installer (click "More info" → "Run anyway" if Windows Defender warns you)
-3. If Windows Defender shows a warning, click "More info" then "Run anyway"
+3. Follow the installation wizard
-4. Follow the installation wizard
+
+### Linux
+
+#### Fedora (via Copr — recommended)
+
+Installing via Copr lets `dnf` handle future updates automatically:
+
+```bash
+sudo dnf copr enable masteracnolo/freedom-loader
+sudo dnf install freedom-loader
+```
+
+#### Debian / Ubuntu (.deb)
+
+```bash
+# Download the latest .deb from the Releases page, then:
+sudo apt install ./freedom-loader_1.x.x_amd64.deb
+```
+
+#### Snap (any distro with snapd)
+
+```bash
+sudo snap install freedom-loader
+```
+
+#### RPM (Fedora/RHEL/openSUSE, without Copr)
+
+```bash
+# Download the latest .rpm from the Releases page, then:
+sudo dnf install ./freedom-loader-1.x.y.x86_64.rpm
+```
+
+#### AppImage (any distro, no installation needed)
+
+```bash
+# Download the latest .AppImage from the Releases page, then:
+chmod +x Freedom-Loader-1.x.y.AppImage
+./Freedom-Loader-1.x.y.AppImage
+```
+
+Once installed via any method, launch Freedom Loader from your application menu, or from a terminal with:
+```bash
+freedom-loader
+```
 
 ### File Locations
 
-Downloaded files are stored in:
+|               | Windows                                                 | Linux                                |
-```
+|---------------|---------------------------------------------------------|--------------------------------------|
-C:\Users\[USERNAME]\Downloads\Freedom Loader
+| **Downloads** | `C:\Users\[USERNAME]\Downloads\Freedom Loader`          | `~/Downloads/Freedom Loader`         |
-```
+| **Logs**      | `C:\Users\[USERNAME]\AppData\Local\FreedomLoader\logs\` | `~/.local/share/FreedomLoader/logs/` |
-> [!NOTE]
-> *You can change it whenever you want. Just click the "Edit" button in the UI.*
 
-Application logs can be found at:
+> [!NOTE]
-```
+> The download folder can be changed anytime via the "Edit" button in the UI, on both platforms.
-C:\Users\[USERNAME]\AppData\Local\FreedomLoader\logs\
-```
 
 ## Usage
 
+> [!TIP] 
+> On Linux, you can start Freedom Loader using `freedom-loader` command
+
 ### Basic Download
 
 1. Launch Freedom Loader
@@ -138,7 +185,7 @@ The application supports various configuration options:
 If you encounter issues:
 
 1. Restart the application
-2. Check the logs in `AppData\Local\FreedomLoader\logs\`
+2. Check the logs in `AppData\Local\FreedomLoader\logs\` or `~/.local/share/FreedomLoader/logs`
 3. Open the developer console: `CTRL + SHIFT + I` → "Toggle Developer Tools"
 4. Create an issue on GitHub with logs and reproduction steps
 
@@ -164,10 +211,17 @@ If you encounter issues:
 Freedom Loader can be configured either through the settings panel in the UI or by directly editing the `config.json` file located in the application data directory.
 
 ### Configuration File Location
+
+#### Windows
 ```
 %APPDATA%\Freedom Loader\config.json
 ```
 
+#### Linux
+```
+~/.config/Freedom\ Loader/config.json
+```
+
 ### Available Options
 ```json
 {
@@ -179,6 +233,7 @@ Freedom Loader can be configured either through the settings panel in the UI or
   "addMetadata": true,
   "verboseLogs": false,
   "autoDownloadPlaylist": true,
+  "keepPlaylistOrder": false,
   "createPlaylistFolders": true,
   "customCodec": "h264",
   "logSystem": true,
@@ -193,7 +248,7 @@ Freedom Loader can be configured either through the settings panel in the UI or
 ### Configuration Options
 
 | Option                       | Type    | Default  | Description                                                |
-|--------|------|---------|-------------|
+|------------------------------|---------|----------|------------------------------------------------------------|
 | `autoUpdate`                 | boolean | `true`   | Enable automatic application updates                       |
 | `discordRPC`                 | boolean | `true`   | Enable Discord Rich Presence integration                   |
 | `customTopBar`               | boolean | `true`   | Use custom application top bar                             |
@@ -202,6 +257,7 @@ Freedom Loader can be configured either through the settings panel in the UI or
 | `addMetadata`                | boolean | `true`   | Add metadata tags to downloaded files                      |
 | `verboseLogs`                | boolean | `false`  | Enable detailed logging for debugging                      |
 | `autoDownloadPlaylist`       | boolean | `true`   | Automatically download entire playlists                    |
+| `keepPlaylistOrder`          | boolean | `false`  | Add index before title, usefull for album                  |
 | `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                                 |
@@ -222,7 +278,7 @@ Freedom Loader can be configured either through the settings panel in the UI or
 - `theora` - Theora (legacy open codec)
 
 > [!NOTE]
-> Configuration changes may require an application restart to take effect.
+> Some configuration changes may require an application restart to take effect.
 
 ## Project Structure
 
@@ -423,7 +479,7 @@ resources/
 - Write clear commit messages
 - Test thoroughly before submitting changes
 - Update documentation when adding features
-- Maintain compatibility with Windows 10+
+- Maintain compatibility with Windows 10+ and Linux
 
 ## Roadmap
 
@@ -445,7 +501,7 @@ Use the GitHub Issues system and include:
 - Clear description of the issue
 - Steps to reproduce
 - Expected vs actual behavior
-- Relevant logs from `AppData\Local\FreedomLoader\logs\`
+- Relevant logs from `AppData\Local\FreedomLoader\logs\` or `~/.local/share/FreedomLoader/logs/`
 - Screenshots if applicable
 
 ### Feature Requests
@@ -485,7 +541,7 @@ You are free to use, modify, and redistribute this software under the terms of t
 
 - [yt-dlp](https://github.com/yt-dlp/yt-dlp) for the robust download engine
 - [FFmpeg](https://ffmpeg.org/) for media processing capabilities
-- [Deno](https://deno.com/) for helping me bypassing challenges
+- [Deno](https://deno.com/) for helping me to bypass challenges
 - [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

SECURITY.md

@@ -2,15 +2,14 @@
 
 ## Supported Versions
 
-We actively maintain and provide security updates for the following versions of Freedom Loader:
+Freedom Loader follows a **latest-only** support model. Security fixes are applied to the current release only — no backports to older versions.
 
 | Version       | Supported          |
-|---------|--------------------|
+| ------------- | ------------------ |
-| 1.4.x   | :white_check_mark: |
+| Latest stable | :white_check_mark: |
-| 1.3.x   | :white_check_mark: |
+| Older versions | :x:               |
-| < 1.3.0 | :x:                |
 
-**Note**: We recommend always using the latest version to benefit from the most recent security patches and features.
+I recommend always running the latest version. The built-in auto-updater will notify you when a new release is available. Older versions will not receive security patches regardless of severity.
 
 ## Reporting a Vulnerability
 
@@ -32,37 +31,40 @@ Instead, please report security issues privately by:
 
 ### What to Expect
 
-- **Acknowledgment**: We will acknowledge receipt of your report within 48 hours
+- **Acknowledgment**: I will acknowledge receipt of your report within 48 hours
-- **Assessment**: We will assess the vulnerability and determine its severity
+- **Assessment**: I will assess the vulnerability and determine its severity
-- **Updates**: We will keep you informed of our progress
+- **Updates**: I will keep you informed of our progress
-- **Resolution**: We aim to release a fix within 7-14 days for critical vulnerabilities
+- **Resolution**: I aim to release a fix within 7-14 days for critical vulnerabilities
-- **Credit**: We will credit you in the release notes (unless you prefer to remain anonymous)
+- **Credit**: I will credit you in the release notes (unless you prefer to remain anonymous)
 
 ## Security Best Practices for Users
 
-When using Freedom Loader, we recommend:
+When using Freedom Loader, I recommend:
 
 ### General Security
 
-- **Keep Updated**: Always use the latest version of Freedom Loader
+- **Keep Updated**: Always use the latest version of Freedom Loader — older versions receive no security patches
-- **Official Sources**: Download only from official releases on [GitHub](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+- **Official Sources**: Download only from official sources:
-- **Verify Downloads**: Check that installers are properly signed (Windows SmartScreen may show warnings for new releases)
+    - [GitHub Releases](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+    - [Fedora COPR](https://copr.fedorainfracloud.org/coprs/masteracnolo/freedom-loader/)
+    - [Snap Store](https://snapcraft.io/freedom-loader)
+- **Verify Downloads**: Check that installers are from one of the above sources
 - **Antivirus**: Keep your antivirus software up to date
 
 ### Configuration Security
 
-- **Download Path**: Only set download paths within your user directory (`C:\Users\[USERNAME]\...`)
+- **Download Path**: Only set download paths within your user directory
-- **Cookies**: Be aware that Firefox cookies are used for authentication—keep Firefox secure
+- **Cookies**: Be aware that Firefox cookies are used for authentication — keep Firefox secure
-- **Logs**: Logs may contain sensitive information—avoid sharing them publicly without review
+- **Logs**: Logs may contain sensitive information such as URLs or local paths — avoid sharing them publicly without review
 
 ### Privacy Considerations
 
 Freedom Loader respects your privacy:
 
-- **No Data Collection**: We don't collect, store, or transmit your personal data
+- **No Data Collection**: I don't collect, store, or transmit your personal data
 - **No Telemetry**: No usage tracking or analytics
 - **Local Operation**: All downloads are processed locally on your machine
-- **Optional Features**: Discord RPC is optional and can be disabled
+- **Optional Features**: Discord RPC is optional and can be disabled in settings
 
 ## Known Security Considerations
 
@@ -71,16 +73,16 @@ Freedom Loader respects your privacy:
 Freedom Loader accesses Firefox cookies to download protected content. This is:
 
 - **By Design**: Required for age-restricted or member-only content
-- **Local Only**: Cookies are read locally and never transmitted
+- **Local Only**: Cookies are read locally and never transmitted outside your machine
-- **User Controlled**: You can control what content you download
+- **User Controlled**: You control what content you download
 
 ### Native Dependencies
 
-Freedom Loader bundles native binaries:
+Freedom Loader bundles the following official binaries:
 
-- **yt-dlp**: Official builds from [yt-dlp/yt-dlp](https://github.com/yt-dlp/yt-dlp)
+- **yt-dlp**: Official builds from [yt-dlp/yt-dlp](https://github.com/yt-dlp/yt-dlp) — auto-updated on each launch
 - **FFmpeg**: Official builds from [FFmpeg.org](https://ffmpeg.org/)
-- **Deno**: Official builds from [Deno.land](https://deno.land/)
+- **Deno**: Official builds from [Deno.com](https://deno.com/)
 
 These dependencies are verified and updated regularly.
 
@@ -91,13 +93,13 @@ New releases may trigger Windows Defender warnings because:
 - The application is not yet widely distributed
 - Code signing certificates are expensive for open-source projects
 
-This is expected behavior for new releases. The warning will decrease as more users download the software.
+This is expected behavior for new releases and will diminish as more users download the software.
 
 ## Vulnerability Disclosure Policy
 
 ### Our Commitment
 
-We are committed to:
+I am committed to:
 
 - Responding promptly to security reports
 - Working with security researchers to verify and address issues
@@ -107,9 +109,9 @@ We are committed to:
 ### Disclosure Timeline
 
 1. **Day 0**: Vulnerability reported privately
-2. **Day 1-2**: Acknowledgment sent to reporter
+2. **Day 1–2**: Acknowledgment sent to reporter
-3. **Day 3-7**: Vulnerability assessed and fix developed
+3. **Day 3–7**: Vulnerability assessed and fix developed
-4. **Day 7-14**: Fix released (critical vulnerabilities prioritized)
+4. **Day 7–14**: Fix released (critical vulnerabilities prioritized)
 5. **Day 14+**: Public disclosure (coordinated with reporter)
 
 ### Scope
@@ -129,16 +131,16 @@ The following are generally not considered security vulnerabilities:
 - Issues requiring physical access to the user's machine
 - Social engineering attacks
 - Denial of service against third-party services
-- Issues in third-party dependencies (report to upstream projects)
+- Issues in third-party dependencies (report to upstream projects directly)
-- Missing security headers on local HTTP server (no remote access)
+- Missing security headers on the local HTTP server (not exposed remotely)
 
 ## Security Updates
 
 Security updates are released as:
 
-- **Patch Releases**: For critical security fixes (e.g., 1.4.1 → 1.4.2)
+- **Patch Releases**: For critical security fixes (e.g., 1.6.0 → 1.6.1)
 - **Automatic Updates**: Users are notified via the built-in update system
-- **Release Notes**: Security fixes are clearly marked in changelog
+- **Release Notes**: Security fixes are clearly marked in the changelog
 
 ## Additional Resources
 
@@ -150,6 +152,7 @@ Security updates are released as:
 
 For security-related questions or concerns:
 
+- **Email**: masteracnolo25@gmail.com
 - **GitHub**: [@MasterAcnolo](https://github.com/MasterAcnolo)
 
 ---

app/autoUpdater.js

@@ -96,8 +96,20 @@ function initAutoUpdater(mainWindow) {
    * Logs failure and displays an error dialog to user.
    */
   autoUpdater.on("error", (err) => {
-    logger.error("Auto update error:", err.message);
+    const msg = err?.message || "";
-    dialog.showErrorBox("Update Error", err.message);
+
+    /**
+     * If no update is available, I put this because there is no Linux version before 1.6.0
+     * @type {boolean}
+     */
+    const isNoUpdateAvailable = /404/.test(msg) || /Cannot find latest.*\.yml/i.test(msg);
+
+    if (isNoUpdateAvailable) {
+      logger.warn("Auto update: no update metadata found (probably no previous release), ignoring", msg);
+      return;
+    }
+
+    logger.error("Auto update error:", msg);
   });
 
   checkForUpdates();
@@ -109,6 +121,11 @@ function initAutoUpdater(mainWindow) {
  */
 async function checkForUpdates() {
 
+  if (process.env.SNAP) {
+    logger.info("Running as Snap, update managed by snapd, skipping electron-updater");
+    return;
+  }
+
   if (!require("electron").app.isPackaged) return ;
 
   try {

app/ipcHandlers.js

@@ -34,6 +34,7 @@ const FEATURE_WHITELIST = new Set([
   "addMetadata",
   "verboseLogs",
   "autoDownloadPlaylist",
+  "keepPlaylistOrder",
   "customCodec",
   "theme",
   "createPlaylistFolders",

config.js

@@ -7,7 +7,7 @@ const path = require("path");
  * Indicates whether the application is running in development mode.
  * Determined by Electron's packaging state.
  */
-const devMode = !app.isPackaged;
+const devMode = process.env.NODE_ENV === "test" || !app?.isPackaged;
 
 /**
  * Resolves the configuration file path depending on runtime environment.
@@ -68,13 +68,30 @@ function loadFeatures() {
   return JSON.parse(raw);
 }
 
+/**
+ * Reloads feature flags from disk.
+ * Use this instead of the cached configFeatures snapshot
+ * when you need the latest user settings at call time.
+ *
+ * @returns {Object} Fresh feature flags from config file
+ */
+function reloadFeatures() {
+  try {
+    const raw = fs.readFileSync(featuresPath, "utf-8");
+    return JSON.parse(raw);
+  } catch (err) {
+    // Fallback to cached snapshot if file read fails
+    return configFeatures;
+  }
+}
+
 /**
  * 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();
+let configFeatures = loadFeatures();
 
 module.exports = {
   /**
@@ -102,6 +119,11 @@ module.exports = {
    */
   configFeatures,
 
+  /**
+   * Function to reload the config
+   */
+  reloadFeatures,
+
   /**
    * Path to the active configuration file
    */

config/config.default.json

@@ -7,6 +7,7 @@
   "addMetadata": true,
   "verboseLogs": false,
   "autoDownloadPlaylist": true,
+  "keepPlaylistOrder": false,
   "createPlaylistFolders": true,
   "customCodec": "h264",
   "logSystem": true,

jest.config.js

@@ -0,0 +1,21 @@
+module.exports = {
+    testEnvironment: "node",
+    testMatch: ["**/test/unit/**/*.test.js"],
+    collectCoverageFrom: [
+        "server/**/*.js",
+        "app/**/*.js",
+        "!app/autoUpdater.js",
+    ],
+
+    modulePathIgnorePatterns: [
+        "<rootDir>/dist",
+        "<rootDir>/release",
+        "<rootDir>/build",
+    ],
+
+    watchPathIgnorePatterns: [
+        "<rootDir>/dist",
+        "<rootDir>/release",
+        "<rootDir>/build",
+    ],
+};

main.js

@@ -37,7 +37,7 @@ app.setAppUserModelId("com.masteracnolo.freedomloader");
 /**
  * Load the app dependencies for hardware choice
  */
-const { logger, logSessionStart, logSessionEnd } = require("./server/logger");
+const { logger, logSessionStart, logSessionEnd, logDir } = require("./server/logger");
 const { configFeatures } = require("./config");
 
 /**
@@ -79,7 +79,7 @@ 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");
+const { userThemesPath, initUserThemes, isWindows, validateBinaries, defaultDownloadFolder } = require("./server/helpers/path.helpers");
 
 
 /**
@@ -99,7 +99,7 @@ app.on("second-instance", () => {
 });
 
 app.whenReady().then(async () => {
-  logSessionStart();
+  logSessionStart(logDir, defaultDownloadFolder);
 
   createSplashWindow();
 
@@ -117,14 +117,10 @@ app.whenReady().then(async () => {
 
     setSplashProgress(2); // Loading themes
 
-    // TODO: Patch this, i disable this features for the moment
+    validateBinaries();
-    // 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();

package.json

@@ -1,17 +1,34 @@
 {
   "name": "freedom-loader",
   "productName": "Freedom Loader",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "author": "MasterAcnolo <MasterAcnolo@users.noreply.github.com>",
-  "description": "Freedom Loader",
+  "description": "Free and open-source GUI for yt-dlp — download video and audio from hundreds of platforms",
+  "homepage": "https://masteracnolo.github.io/Freedom-Loader-Site/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MasterAcnolo/Freedom-Loader.git"
+  },
+  "license": "GPL-3.0-only",
+  "bugs": {
+    "url": "https://github.com/MasterAcnolo/Freedom-Loader/issues"
+  },
   "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:rpm": "bash scripts/create-copr-package.sh",
     "build:all": "electron-builder -wl",
+    "release": "bash scripts/release.sh",
+    "release:publish": "bash scripts/release.sh --publish",
+    "release:dry-run": "bash scripts/release.sh --dry-run",
+
+    "test": "jest",
+    "test:unit": "jest test/unit",
+
     "update": "npm update"
   },
   "dependencies": {
@@ -27,9 +44,13 @@
     "winston-daily-rotate-file": "^5.0.0"
   },
   "devDependencies": {
-    "electron": "^41.2.0",
+    "@electron/devtron": "^2.1.1",
-    "electron-builder": "^26.8.1",
+    "@jest/globals": "^30.4.1",
-    "@electron/devtron": "^2.1.1"
+    "@playwright/test": "^1.62.1",
+    "electron": "^43.3.0",
+    "electron-builder": "^26.15.3",
+    "jest": "^30.4.2",
+    "playwright": "^1.62.1"
   },
   "build": {
     "appId": "com.masteracnolo.freedomloader",
@@ -38,7 +59,8 @@
       {
         "provider": "github",
         "owner": "MasterAcnolo",
-        "repo": "Freedom-Loader"
+        "repo": "Freedom-Loader",
+        "releaseType": "draft"
       }
     ],
     "files": [
@@ -52,22 +74,52 @@
     },
     "asar": true,
     "extraResources": [
-      { "from": "theme", "to": "theme" },
+      {
-      { "from": "build/confirm-icon.png", "to": "confirm-icon.png" },
+        "from": "theme",
-      { "from": "build/banner.bmp", "to": "banner.bmp" },
+        "to": "theme"
-      { "from": "build/banner.png", "to": "banner.png" },
+      },
-      { "from": "build/error.png", "to": "error.png" },
+      {
-      { "from": "config/config.default.json", "to": "config/config.default.json" }
+        "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",
-      "artifactName": "${productName}-Setup-${version}.${ext}",
+      "artifactName": "Freedom-Loader-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/yt-dlp.exe",
-        { "from": "resources/binaries/win-32/ffprobe.exe", "to": "binaries/ffprobe.exe" },
+          "to": "binaries/yt-dlp.exe"
-        { "from": "resources/binaries/win-32/deno.exe", "to": "binaries/deno.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": {
@@ -82,21 +134,49 @@
       "shortcutName": "Freedom Loader"
     },
     "linux": {
-      "target": ["AppImage", "deb","rpm"],
+      "target": [
+        "AppImage",
+        "deb",
+        "snap"
+      ],
       "category": "Utility",
       "icon": "build/app-icon.png",
+      "executableName": "freedom-loader",
       "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",
+          "from": "resources/binaries/linux/yt-dlp",
-          "to": "usr/share/metainfo/com.masteracnolo.freedomloader.metainfo.xml"
+          "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"
         }
       ]
+    },
+    "deb": {
+      "fpm": [
+        "./package/com.masteracnolo.freedomloader.metainfo.xml=/usr/share/metainfo/com.masteracnolo.freedomloader.metainfo.xml"
+      ]
+    },
+    "rpm": {
+      "fpm": [
+        "./package/com.masteracnolo.freedomloader.metainfo.xml=/usr/share/metainfo/com.masteracnolo.freedomloader.metainfo.xml"
+      ]
+    },
+    "snap": {
+      "confinement": "strict",
+      "plugs": [
+        "default",
+        "removable-media"
+      ]
     }
   }
 }

package/com.masteracnolo.freedomloader.metainfo.xml

@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<component type="desktop-application">
+    <id>com.masteracnolo.freedomloader</id>
+
+    <name>Freedom Loader</name>
+
+    <summary>GUI for yt-dlp to download video and audio with metadata</summary>
+
+    <metadata_license>CC0-1.0</metadata_license>
+    <project_license>GPL-3.0-only</project_license>
+
+    <developer id="com.masteracnolo">
+        <name>MasterAcnolo</name>
+    </developer>
+
+    <description>
+        <p>
+            Freedom Loader is a free and open-source graphical interface built
+            around yt-dlp, the powerful command-line media downloader. It lets
+            you download video and audio from hundreds of supported websites
+            without ever touching a terminal, with no ads, no tracking, and
+            no questionable third-party services.
+        </p>
+        <p>
+            Under the hood, Freedom Loader bundles yt-dlp and ffmpeg directly,
+            so there is nothing extra to install: paste a link, choose a
+            format and quality, and the app handles fetching, converting
+            and tagging the file for you.
+        </p>
+        <p>Features include:</p>
+        <ul>
+            <li>MP4 video or MP3 audio downloads with embedded metadata and thumbnails</li>
+            <li>Quality selection from best to specific resolutions (1080p, 720p, 480p)</li>
+            <li>Codec choice: H.264, H.265, AV1, VP9 and Theora</li>
+            <li>Playlist downloads with automatic per-playlist folders</li>
+            <li>Cookie-based access to age-restricted and member-only content</li>
+            <li>Custom theme system with a web-based theme creator</li>
+            <li>Real-time download progress with network speed indicator</li>
+            <li>Optional Discord Rich Presence integration</li>
+            <li>Automatic application and download-engine updates</li>
+        </ul>
+        <p>
+            DRM-protected content is not supported and cannot be downloaded.
+        </p>
+    </description>
+
+    <launchable type="desktop-id">freedom-loader.desktop</launchable>
+
+    <url type="homepage">https://github.com/MasterAcnolo/Freedom-Loader</url>
+    <url type="bugtracker">https://github.com/MasterAcnolo/Freedom-Loader/issues</url>
+    <url type="vcs-browser">https://github.com/MasterAcnolo/Freedom-Loader</url>
+
+    <categories>
+        <category>AudioVideo</category>
+        <category>Utility</category>
+        <category>Network</category>
+    </categories>
+
+    <releases>
+        <release version="1.6.0" date="2026-06-23">
+            <description>
+                <p>Latest stable release.</p>
+            </description>
+        </release>
+    </releases>
+
+    <content_rating type="oars-1.1"/>
+
+    <provides>
+        <binary>freedom-loader</binary>
+    </provides>
+</component>

package/copr-build.sh

@@ -0,0 +1,9 @@
+#!/bin/sh -xe
+git clone --depth 1 https://github.com/MasterAcnolo/Freedom-Loader.git src
+cd src
+npm ci
+npx electron-builder --linux dir
+
+VERSION=$(node -p "require('./package.json').version")
+tar czf "$resultdir/freedom-loader-$VERSION.tar.gz" -C dist linux-unpacked
+sed "s/__VERSION__/$VERSION/" package/freedom-loader.spec > "$resultdir/freedom-loader.spec"

package/freedom-loader.spec

@@ -0,0 +1,25 @@
+Name:           freedom-loader
+Version:        __VERSION__
+Release:        1%{?dist}
+Summary:        GUI for yt-dlp media downloads
+License:        GPL-3.0-only
+Source0:        freedom-loader-__VERSION__.x86_64.rpm
+BuildArch:      x86_64
+Requires:       glibc, gtk3, nss, libXScrnSaver
+
+%description
+GUI for yt-dlp media downloads.
+
+%install
+rpm2cpio %{SOURCE0} | (cd %{buildroot} && cpio -idmv)
+mkdir -p %{buildroot}/usr/bin
+ln -sf "/opt/Freedom Loader/freedom-loader" %{buildroot}/usr/bin/freedom-loader
+
+%files
+/opt/*
+/usr/bin/freedom-loader
+/usr/share/applications/*
+/usr/share/metainfo/*
+/usr/share/icons/hicolor
+
+%changelog

public/index.html

@@ -106,10 +106,10 @@
                 </div>
 
                 <div class="setting-item">
-                    <input type="checkbox" data-key="autoCheckInfo" id="autoCheckInfo">
+                    <input data-key="keepPlaylistOrder" id="keepPlaylistOrder" type="checkbox">
                     <div class="setting-info">
-                    <span class="setting-title">Auto Fetch Info</span>
+                        <span class="setting-title">Keep Playlist Order</span>
-                    <small>Automatically fetch information for new downloads.</small>
+                        <small>Add index before output file, to keep the order.</small>
                     </div>
                 </div>
             </div>
@@ -135,6 +135,14 @@
                     </div>
                 </div> -->
 
+                    <div class="setting-item">
+                        <input data-key="autoCheckInfo" id="autoCheckInfo" type="checkbox">
+                        <div class="setting-info">
+                            <span class="setting-title">Auto Fetch Info</span>
+                            <small>Automatically fetch information for new downloads.</small>
+                        </div>
+                    </div>
+
                     <div class="setting-item">
                     <input type="checkbox" data-key="addMetadata" id="addMetadata">
                     <div class="setting-info">

public/script/customConfiguration.js

@@ -25,6 +25,3 @@ async function initPlatformRestrictions() {
   }
 }
 
-document.addEventListener('DOMContentLoaded', function(){
-    initPlatformRestrictions();
-})

public/script/fetchinfo.js

@@ -30,15 +30,15 @@ function formatSize(bytes) {
  */
 async function fetchVideoInfo(url) {
   try {
-    const res = await fetch("/info", {
+    const res = await fetch(`/info?url=${encodeURIComponent(url)}`, {
-      method: "POST",
+      method: "GET",
-      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+      headers: {"Accept": "application/json"}
-      body: new URLSearchParams({ url }),
     });
 
-    if (!res.ok) return { error: `An Error occured when fetching info` };
-
     const data = await res.json();
+
+    if (!res.ok) return {error: `An Error occured when fetching info`};
+
     if (!data) return { error: "Data is Missing" };
 
     return data;

scripts/create-copr-package.sh

@@ -0,0 +1,116 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+VERSION=$(node -p "require('$ROOT_DIR/package.json').version")
+RPM_OUT="$ROOT_DIR/dist/freedom-loader-${VERSION}.x86_64.rpm"
+
+# ------------------------------------------------------------
+# Resolve fpm from electron-builder cache
+# Excludes Ruby gem wrappers, targets standalone binaries only
+# Prefers fpm@2.x over legacy fpm-1.9.x
+# ------------------------------------------------------------
+FPM=$(find ~/.cache/electron-builder -name "fpm" -type f 2>/dev/null \
+    | grep -v "/gems/bin/fpm" \
+    | grep -v "/gems/gems/" \
+    | grep -v "/lib/app/bin/fpm" \
+    | grep "fpm@" \
+    | head -1)
+
+# Fallback to legacy fpm-1.9.x if fpm@2.x not found
+if [ -z "$FPM" ]; then
+    FPM=$(find ~/.cache/electron-builder -name "fpm" -type f 2>/dev/null \
+        | grep -v "/gems/" \
+        | grep -v "/lib/app/bin/fpm" \
+        | head -1)
+fi
+
+if [ -z "$FPM" ]; then
+    echo "Error: fpm not found in electron-builder cache. Run 'npm run build:linux' once first to download it."
+    exit 1
+fi
+
+echo "Using fpm: $FPM"
+
+# Check that linux-unpacked exists
+if [ ! -d "$ROOT_DIR/dist/linux-unpacked" ]; then
+    echo "Error: dist/linux-unpacked not found. Run 'npm run build:linux' first."
+    exit 1
+fi
+
+# ------------------------------------------------------------
+# Prepare staging files
+# fpm requires exact file-to-destination mappings to avoid
+# scanning system directories (which causes permission errors)
+# ------------------------------------------------------------
+
+# Shell wrapper for /usr/bin/freedom-loader
+TMP_WRAPPER="$ROOT_DIR/.rpm-pkg-tmp-wrapper"
+mkdir -p "$TMP_WRAPPER"
+cat > "$TMP_WRAPPER/freedom-loader" << 'EOF'
+#!/bin/sh
+exec /opt/freedom-loader/freedom-loader "$@"
+EOF
+chmod +x "$TMP_WRAPPER/freedom-loader"
+
+# Desktop entry file
+TMP_DESKTOP="$ROOT_DIR/.rpm-pkg-tmp-desktop"
+mkdir -p "$TMP_DESKTOP"
+cat > "$TMP_DESKTOP/freedom-loader.desktop" << 'EOF'
+[Desktop Entry]
+Name=Freedom Loader
+Exec=/opt/freedom-loader/freedom-loader %U
+Icon=freedom-loader
+Type=Application
+Categories=AudioVideo;Utility;Network;
+Comment=Free and open-source GUI for yt-dlp
+StartupWMClass=Freedom Loader
+EOF
+
+# ------------------------------------------------------------
+# Step 1 - Build .rpm from linux-unpacked via fpm
+# ------------------------------------------------------------
+echo "Building RPM..."
+"$FPM" -s dir -t rpm --force \
+    --rpm-use-file-permissions \
+    --name freedom-loader \
+    --version "$VERSION" \
+    --architecture x86_64 \
+    --description "Free and open-source GUI for yt-dlp" \
+    --url "https://masteracnolo.github.io/Freedom-Loader-Site/" \
+    --maintainer "MasterAcnolo <MasterAcnolo@users.noreply.github.com>" \
+    --license "GPL-3.0-only" \
+    --depends gtk3 \
+    --depends nss \
+    --depends libXScrnSaver \
+    --depends at-spi2-core \
+    --rpm-attr "4755,root,root:/opt/freedom-loader/chrome-sandbox" \
+    --package "$RPM_OUT" \
+    "$ROOT_DIR/dist/linux-unpacked/=/opt/freedom-loader" \
+    "$TMP_WRAPPER/freedom-loader=/usr/bin/freedom-loader" \
+    "$TMP_DESKTOP/freedom-loader.desktop=/usr/share/applications/freedom-loader.desktop" \
+    "$ROOT_DIR/build/app-icon.png=/usr/share/icons/hicolor/512x512/apps/freedom-loader.png" \
+    "$ROOT_DIR/package/com.masteracnolo.freedomloader.metainfo.xml=/usr/share/metainfo/com.masteracnolo.freedomloader.metainfo.xml"
+
+rm -rf "$TMP_WRAPPER" "$TMP_DESKTOP"
+echo "RPM built: $RPM_OUT"
+
+# ------------------------------------------------------------
+# Step 2 - Build SRPM for COPR
+# Wraps the .rpm above into a source RPM for COPR submission
+# ------------------------------------------------------------
+echo "Building SRPM for COPR..."
+mkdir -p "$ROOT_DIR/srpm-out"
+
+TMP_DIR="$ROOT_DIR/.copr-build-tmp"
+mkdir -p "$TMP_DIR"
+TMP_SPEC="$TMP_DIR/freedom-loader.spec"
+sed "s/__VERSION__/$VERSION/g" "$ROOT_DIR/package/freedom-loader.spec" > "$TMP_SPEC"
+
+rpmbuild -bs "$TMP_SPEC" \
+    --define "_sourcedir $ROOT_DIR/dist" \
+    --define "_srcrpmdir $ROOT_DIR/srpm-out"
+
+rm -rf "$TMP_DIR"
+echo "SRPM built: $ROOT_DIR/srpm-out/freedom-loader-$VERSION-1*.src.rpm"

scripts/release.sh

@@ -0,0 +1,187 @@
+#!/bin/bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+VERSION=$(node -p "require('$ROOT_DIR/package.json').version")
+TAG="v$VERSION"
+
+# Parse arguments
+PUBLISH_SNAP=false
+PUBLISH_COPR=false
+DRY_RUN=false
+
+for arg in "$@"; do
+    case $arg in
+        --snap)    PUBLISH_SNAP=true ;;
+        --copr)    PUBLISH_COPR=true ;;
+        --publish) PUBLISH_SNAP=true; PUBLISH_COPR=true ;;
+        --dry-run) DRY_RUN=true ;;
+        *) echo "⚠️ Argument inconnu : $arg" ; exit 1 ;;
+    esac
+done
+
+echo ""
+echo "============================================"
+echo "  Freedom Loader - Release Pipeline"
+echo "  Version  : $VERSION"
+echo "  Tag      : $TAG"
+echo "  Snap     : $PUBLISH_SNAP"
+echo "  COPR     : $PUBLISH_COPR"
+echo "  Dry run  : $DRY_RUN"
+echo "============================================"
+echo ""
+
+# ------------------------------------------------------------
+# Step 0.1 - Check Dependencies
+# ------------------------------------------------------------
+echo "[0/5] Checking dependencies..."
+
+command -v gh >/dev/null 2>&1 || { echo "'gh' CLI missing, need to be installed (https://cli.github.com/)."; exit 1; }
+
+if [ "$PUBLISH_SNAP" = true ] && [ "$DRY_RUN" = false ]; then
+    command -v snapcraft >/dev/null 2>&1 || { echo "'snapcraft' missing, need to be installed."; exit 1; }
+fi
+
+if [ "$PUBLISH_COPR" = true ] && [ "$DRY_RUN" = false ]; then
+    command -v copr-cli >/dev/null 2>&1 || { echo "'copr-cli' missing, need to be installed."; exit 1; }
+fi
+
+echo "All dependencies found"
+
+# ------------------------------------------------------------
+# Step 0.2 - Clean Workspace
+# ------------------------------------------------------------
+echo "[0/5] Cleaning workspace..."
+# On supprime les dossiers générés lors des builds précédents
+rm -rf "$ROOT_DIR/dist" "$ROOT_DIR/srpm-out"
+echo "Workspace cleaned (dist/ and srpm-out/ removed)"
+
+# ------------------------------------------------------------
+# Step 1 - Build Linux packages (AppImage, deb, snap)
+# ------------------------------------------------------------
+echo "[1/5] Building Linux packages..."
+cd "$ROOT_DIR"
+npm run build:linux
+echo "Linux packages built"
+
+# ------------------------------------------------------------
+# Step 2 - Build RPM binary + SRPM for COPR
+# Uses the create-copr-package.sh script which handles:
+# - fpm binary resolution from electron-builder cache
+# - .rpm generation from linux-unpacked
+# - .src.rpm generation for COPR submission
+# ------------------------------------------------------------
+echo "[2/5] Building RPM and SRPM..."
+bash "$ROOT_DIR/scripts/create-copr-package.sh"
+echo "RPM and SRPM built"
+
+# ------------------------------------------------------------
+# Step 3 - Build Windows installer
+# Note: requires Windows binaries to be present locally under
+# resources/binaries/win-32/ (not committed to the repo)
+# ------------------------------------------------------------
+echo "[3/5] Building Windows installer..."
+npm run build:win
+echo " Windows installer built"
+
+# ------------------------------------------------------------
+# Step 4 - Create a draft release on GitHub
+# Release notes are pre-filled with the standard template.
+# Edit and publish manually from the GitHub web interface.
+# Requires gh CLI to be installed and authenticated.
+# ------------------------------------------------------------
+echo "[4/5] Creating GitHub draft release $TAG..."
+
+# Utilise une méthode un peu plus robuste pour trouver l'ancien tag (ignore le HEAD actuel s'il est déjà tagué)
+PREV_TAG=$(git rev-list --tags --skip=1 --max-count=1 | xargs git describe --tags 2>/dev/null || echo "previous")
+
+RELEASE_NOTES="# Freedom Loader - $VERSION
+
+## Found a bug or issue?
+Please report it in the [GitHub Issues](https://github.com/MasterAcnolo/Freedom-Loader/issues) section.
+
+## Next Release (non-exhaustive roadmap)
+- More format options
+- Subtitle support
+- Improved UI / UX
+- Language selection
+- Download specific parts of videos
+- File renaming options
+- Parallel downloads
+- Skip sponsored parts automatically
+
+**Full Changelog**: https://github.com/MasterAcnolo/Freedom-Loader/compare/${PREV_TAG}...${TAG}"
+
+if [ "$DRY_RUN" = false ]; then
+    gh release create "$TAG" \
+        --title "$TAG" \
+        --notes "$RELEASE_NOTES" \
+        --draft \
+        "$ROOT_DIR/dist/Freedom-Loader-Setup-${VERSION}.exe" \
+        "$ROOT_DIR/dist/Freedom-Loader-Setup-${VERSION}.exe.blockmap" \
+        "$ROOT_DIR/dist/freedom-loader-${VERSION}.x86_64.rpm" \
+        "$ROOT_DIR/dist/freedom-loader_${VERSION}_amd64.deb" \
+        "$ROOT_DIR/dist/Freedom Loader-${VERSION}.AppImage" \
+        "$ROOT_DIR/dist/freedom-loader_${VERSION}_amd64.snap" \
+        "$ROOT_DIR/dist/latest.yml" \
+        "$ROOT_DIR/dist/latest-linux.yml"
+    echo "Draft release created: https://github.com/MasterAcnolo/Freedom-Loader/releases"
+else
+    echo "  [DRY RUN] gh release create $TAG (skipped)"
+fi
+
+# ------------------------------------------------------------
+# Step 5 - Publish to package stores
+# Snap and COPR are opt-in via --snap, --copr, or --publish.
+# Without these flags, this step is skipped entirely.
+# Run after the GitHub release is published (not the draft),
+# so store users always get the same version as GitHub users.
+# ------------------------------------------------------------
+echo "[5/5] Publishing to package stores..."
+
+if [ "$PUBLISH_SNAP" = true ]; then
+    echo "  Publishing to Snap Store..."
+    if [ "$DRY_RUN" = false ]; then
+        export PATH=$PATH:/var/lib/snapd/snap/bin
+        snapcraft upload \
+            "$ROOT_DIR/dist/freedom-loader_${VERSION}_amd64.snap" \
+            --release=stable
+        echo " Snap published"
+    else
+        echo "  [DRY RUN] snapcraft upload (skipped)"
+    fi
+else
+    echo "  Snap: skipped (use --snap or --publish to enable)"
+fi
+
+if [ "$PUBLISH_COPR" = true ]; then
+    echo "  Publishing to COPR..."
+    if [ "$DRY_RUN" = false ]; then
+        copr-cli build freedom-loader \
+            "$ROOT_DIR/srpm-out/freedom-loader-${VERSION}-1"*.src.rpm
+        echo "COPR build triggered"
+    else
+        echo "  [DRY RUN] copr-cli build (skipped)"
+    fi
+else
+    echo "  COPR: skipped (use --copr or --publish to enable)"
+fi
+
+# ------------------------------------------------------------
+# Done - Summary
+# ------------------------------------------------------------
+echo ""
+echo "============================================"
+echo "  Release pipeline complete."
+echo ""
+echo "  Next steps:"
+echo "  1. Fill in the release notes on GitHub"
+echo "  2. Publish the draft release"
+if [ "$PUBLISH_SNAP" = false ] || [ "$PUBLISH_COPR" = false ]; then
+echo ""
+echo "  Store publishing (not done yet):"
+[ "$PUBLISH_SNAP" = false ] && echo "  - Snap  : bash scripts/release.sh --snap"
+[ "$PUBLISH_COPR" = false ] && echo "  - COPR  : bash scripts/release.sh --copr"
+fi
+echo "============================================"

server/controller/info.controller.js

@@ -18,7 +18,9 @@ const { isValidUrl } = require("../helpers/validation.helpers");
  */
 async function infoController(req, res) {
 
-    const url = req.body.url || req.query.url; // Supports POST and GET requests
+    // Previously, i support both POST and GET element, but it's kinda weird. So now it only support GET.
+    const url = req.query.url;
+    const encodedUrl = encodeURIComponent(url)
 
     /**
      * Basic validation:
@@ -30,9 +32,10 @@ async function infoController(req, res) {
         return res.status(400).send("Invalid URL Or Missing");
     }
 
-    logger.info(`Info request received. URL: ${url}`);
+    logger.info(`Info request received. RAW URL: ${url}`);
+    logger.info(`Info request received. ENCODED: ${encodedUrl}`);
 
-    // Lightweight heuristic to detect playlist URLs
+    // Lightweight heuristic to detect playlist URLs. It works for Youtube.
     const isPlaylistUrl = url.includes("&list") || url.includes("?list");
 
     logger.info(
@@ -86,6 +89,16 @@ async function infoController(req, res) {
          */
         if (data._type === "playlist") {
 
+            // If the playlist got only one video, show it as a video.
+            if (data.entries && data.entries.length === 1) {
+
+                const singleVideo = parseVideo(data.entries[0]);
+
+                logger.info(`Playlist with 1 item converted to video: ${singleVideo.title}`);
+
+                return res.json(singleVideo);
+            }
+
             const playlist = parsePlaylist(data);
 
             logger.info(

server/helpers/buildArgs.helpers.js

@@ -62,7 +62,7 @@ function validateCodec(codec){
  *
  * @returns {string[]} Array of arguments ready to be passed to yt-dlp.
  */
-function buildYtDlpArgs({ url, audioOnly, quality, outputFolder }) {
+function buildYtDlpArgs({url, audioOnly, quality, outputFolder, isPlaylist}) {
 
   logger.info("--- CONFIGURATION ---");
 
@@ -70,6 +70,7 @@ function buildYtDlpArgs({ url, audioOnly, quality, outputFolder }) {
   logger.info(`CONFIG discordRPC: ${configFeatures.discordRPC}`);
   logger.info(`CONFIG customTopBar: ${configFeatures.customTopBar}`);
   logger.info(`CONFIG autoCheckInfo: ${configFeatures.autoCheckInfo}`);
+  logger.info(`CONFIG keepPlaylistOrder: ${configFeatures.keepPlaylistOrder}`);
   logger.info(`CONFIG addThumbnail: ${configFeatures.addThumbnail}`);
   logger.info(`CONFIG addMetadata: ${configFeatures.addMetadata}`);
   logger.info(`CONFIG verboseLogs: ${configFeatures.verboseLogs}`);
@@ -117,7 +118,19 @@ function buildYtDlpArgs({ url, audioOnly, quality, outputFolder }) {
   };
 
   args.push("-f", qualityMap[quality] || "best");
-  args.push("-o", path.join(outputFolder, "%(title)s.%(ext)s"));
+
+  /**
+   * Default title output template
+   * @type {string}
+   */
+  let outputTemplate = "%(title)s.%(ext)s";
+
+  // If it's a playlist, and we want to keep the playlist order. Add an index before the title.
+  if (isPlaylist && configFeatures.keepPlaylistOrder && configFeatures.autoDownloadPlaylist) {
+    outputTemplate = "%(playlist_index)02d - %(title)s.%(ext)s";
+  }
+
+  args.push("-o", path.join(outputFolder, outputTemplate));
   args.push(url);
 
   return args.filter(Boolean);

server/helpers/notify.helpers.js

@@ -2,6 +2,12 @@ const { Notification, shell } = require("electron");
 const { iconPaths } = require("./path.helpers");
 const { logger } = require("../logger");
 
+/**
+ * Set that is holding all notifications. Used to avoid Race Condition and notification crash
+ * @type {Set<any>}
+ */
+const activeNotifications = new Set();
+
 /**
  * Displays a system notification when a download completes successfully.
  *
@@ -21,7 +27,27 @@ function notifyDownloadFinished(folder, notifyEnabled = true) {
     icon: iconPaths.confirm,
   });
 
-  notif.on("click", () => shell.openPath(folder));
+  // Protect notification to garbage collection and race condition, by adding a 150ms timeout before trying to open the folder
+  activeNotifications.add(notif);
+
+  notif.on("click", () => {
+    activeNotifications.delete(notif);
+
+    setTimeout(() => {
+      shell.openPath(folder).then((errorMessage) => {
+        if (errorMessage) {
+          logger.error(`Impossible d'ouvrir le dossier : ${errorMessage}`);
+        }
+      }).catch(err => {
+        logger.error(`Erreur inattendue de shell.openPath : ${err}`);
+      });
+    }, 150);
+  });
+
+  notif.on("close", () => {
+    activeNotifications.delete(notif);
+  });
+
   notif.show();
 }
 
@@ -41,11 +67,16 @@ function notifyCookiesBrowserError(){
     icon: iconPaths.error,
   });
 
-  notif.on("click", () =>
+  activeNotifications.add(notif);
-    shell.openExternal(
+
-      "https://youtube.com/shorts/cN9f4s1Mf88?si=519QCVd_-fzJqRf1"
+  notif.on("click", () => {
-    )
+    shell.openExternal("https://www.firefox.com/en-US/download/");
-  );
+    activeNotifications.delete(notif);
+  });
+
+  notif.on("close", () => {
+    activeNotifications.delete(notif);
+  });
 
   notif.show();
 }
@@ -65,11 +96,16 @@ function notifyFirefoxBrowserMissing() {
     icon: iconPaths.error,
   });
 
-  notif.on("click", () =>
+  activeNotifications.add(notif);
-    shell.openExternal(
+
-      "https://youtube.com/shorts/cN9f4s1Mf88?si=519QCVd_-fzJqRf1"
+  notif.on("click", () => {
-    )
+    shell.openExternal("https://www.firefox.com/en-US/download/");
-  );
+    activeNotifications.delete(notif);
+  });
+
+  notif.on("close", () => {
+    activeNotifications.delete(notif);
+  });
 
   notif.show();
 }

server/helpers/path.helpers.js

@@ -3,8 +3,6 @@ const fs = require("fs");
 const { app } = require("electron");
 const config = require("../../config.js");
 
-const { logger } = require("../logger.js");
-
 /**
  * Is the OS windows
  */
@@ -104,7 +102,7 @@ if (config.devMode) {
       try {
         fs.chmodSync(userYtDlp, 0o755);
       } catch (err) {
-        logger.warn(`Failed to chmod yt-dlp: ${err.message}`);
+          getLogger().warn(`Failed to chmod yt-dlp: ${err.message}`);
       }
     }
   }
@@ -165,48 +163,48 @@ 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");
+      getLogger().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)) {
+        const srcIsFile = !fs.statSync(srcPath).isDirectory();
-          try {
+
-            copyDirectory(srcPath, destPath);
+        if (fs.existsSync(destPath)) {
-            fs.chmodSync(destPath, 0o777);
+          const destIsDir = fs.statSync(destPath).isDirectory();
-            logger.info(`Copied default theme: ${theme}`);
+          if (srcIsFile && destIsDir) {
-          } catch (copyErr) {
+            getLogger().warn(`Corrupted theme entry: ${theme}, fixing...`);
-            logger.warn(
+            fs.rmSync(destPath, { recursive: true, force: true });
-              `Failed to copy theme ${theme}: ${copyErr.message}. Theme folder will be created, add theme files manually.`
+
-            );
+          } else {
+            continue;
+          }
+        }
 
         try {
-              fs.mkdirSync(destPath, { recursive: true });
+          if (srcIsFile) {
+            fs.copyFileSync(srcPath, destPath);
+            fs.chmodSync(destPath, 0o666);
+          } else {
+            copyDirectory(srcPath, destPath);
             fs.chmodSync(destPath, 0o777);
-            } catch (mkdirErr) {
-              logger.warn(
-                `Could not create theme directory ${theme}: ${mkdirErr.message}`
-              );
-            }
           }
+          getLogger().info(`Copied default theme: ${theme}`);
+        } catch (copyErr) {
+          getLogger().warn(`Failed to copy theme ${theme}: ${copyErr.message}`);
         }
       }
     } else {
-      logger.warn(
+      getLogger().warn(`Default themes source path not found: ${defaultThemesSourcePath}`);
-        `Default themes source path not found: ${defaultThemesSourcePath}`
-      );
     }
   } catch (err) {
-    logger.error(`Failed to initialize user themes: ${err.message}`);
+    getLogger().error(`Failed to initialize user themes: ${err.message}`);
   }
 }
-
 /**
  * Recursively copies a directory and its contents.
  *
@@ -241,16 +239,31 @@ function copyDirectory(src, dest) {
 }
 
 // Runtime validation of critical binaries
-if (!userYtDlp) {
+// if (!userYtDlp) {
-  logger.error("Missing yt-dlp binary");
+//     getLogger().error("Missing yt-dlp binary");
+// }
+
+// if (!ffmpegPath) {
+//     getLogger().error("Missing ffmpeg binary");
+// }
+
+// if (!denoPath) {
+//     getLogger().error("Missing deno binary");
+// }
+
+
+function validateBinaries() {
+  if (!userYtDlp) getLogger().error("Missing yt-dlp binary");
+  if (!ffmpegPath) getLogger().error("Missing ffmpeg binary");
+  if (!denoPath) getLogger().error("Missing deno binary");
 }
 
-if (!ffmpegPath) {
+/**
-  logger.error("Missing ffmpeg binary");
+ * Helper to lazy load logger, avoid circular import
+ * @returns {winston.Logger}
+ */
+function getLogger() {
+    return require("../logger.js").logger;
 }
 
-if (!denoPath) {
+module.exports = { userYtDlp, ffmpegPath, denoPath, iconPaths, binaryPaths, resourcesPath, defaultDownloadFolder, userThemesPath, initUserThemes, isWindows, validateBinaries };
-  logger.error("Missing deno binary");
-}
-
-module.exports = { userYtDlp, ffmpegPath, denoPath, iconPaths, binaryPaths, resourcesPath, defaultDownloadFolder, userThemesPath, initUserThemes, isWindows };

server/logger.js

@@ -5,6 +5,7 @@ const path = require("path");
 const os = require("os");
 const config = require("../config");
 const {isWindows} = require("./helpers/path.helpers");
+const { logSystemInfo } = require("./sysinfo");
 
 // Logs folder in Windows
 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");
@@ -52,9 +53,11 @@ const logger = createLogger({
 /**
  * Start Log Session 
  */
-function logSessionStart() {
+function logSessionStart(logDir, downloadPath) {
   logger.info(`--- Starting session: ${new Date().toISOString()} ---`);
+  logger.info("============================================================")
   logger.info(`Application Version: ${config.version}`)
+  logSystemInfo(logger, logDir, downloadPath)
 }
 
 /**

server/routes/info.route.js

@@ -2,6 +2,6 @@ const express = require("express");
 const router = express.Router();
 const { infoController } = require("../controller/info.controller");
 
-router.post("/", infoController);
+router.get("/", infoController);
 
 module.exports = router;

server/server.js

@@ -14,6 +14,8 @@ app.use(express.static(path.join(__dirname, "../public")));
 // Routes
 app.use("/download", require("./routes/download.route"));
 app.use("/info", require("./routes/info.route"));
+
+// Interface
 app.get("/", rateLimit, (req, res) => {
   res.sendFile(path.join(__dirname, "../public/index.html"));
 });

server/services/download.services.js

@@ -6,7 +6,7 @@ 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");
+const {reloadFeatures} = require("../../config");
 
 /**
  * Reference to the currently running yt-dlp process.
@@ -135,7 +135,10 @@ function createPlaylistFolder(basePath, playlistTitle) {
 function fetchDownload(options, listeners, speedListeners, stageListeners, playlistInfoListeners) {
 
   return new Promise((resolve, reject) => {
-    logger.info(`CONFIG createPlaylistFolders: ${configFeatures.createPlaylistFolders}`);
+
+    const userConfig = reloadFeatures();
+
+    logger.info(`CONFIG createPlaylistFolders: ${userConfig.createPlaylistFolders}`);
     
     let outputFolder = options.outputFolder || defaultDownloadFolder;
     
@@ -159,7 +162,7 @@ function fetchDownload(options, listeners, speedListeners, stageListeners, playl
     // Détecte si c'est une playlist et crée un dossier approprié
     const isPlaylist = options.playlistTitle || isPlaylistUrl(options.url);
 
-    if (isPlaylist && configFeatures.createPlaylistFolders) {
+    if (isPlaylist && userConfig.createPlaylistFolders) {
       try {
         const playlistName = options.playlistTitle || "Untitled Playlist";
         safeOutputFolder = createPlaylistFolder(safeOutputFolder, playlistName);
@@ -168,11 +171,16 @@ function fetchDownload(options, listeners, speedListeners, stageListeners, playl
         logger.error(`Failed to create playlist folder: ${err.message}`);
         return reject(err);
       }
-    } else if (isPlaylist && !configFeatures.createPlaylistFolders) {
+    } else if (isPlaylist && !userConfig.createPlaylistFolders) {
       logger.info(`Playlist detected but createPlaylistFolders is disabled, using base folder`);
     }
 
-    const args = buildYtDlpArgs({ ...options, outputFolder: safeOutputFolder });
+    const args = buildYtDlpArgs({
+      ...options,
+      outputFolder: safeOutputFolder,
+      isPlaylist
+    });
+
     logger.info(`[yt-dlp args] ${args.join(" ")}`);
 
     const child = execFile(userYtDlp, args);

server/sysinfo.js

@@ -0,0 +1,142 @@
+const os = require("os");
+const fs = require("fs");
+const { execSync } = require("child_process");
+const { app } = require("electron");
+
+/**
+ * Reads /etc/os-release to get the Linux distribution name
+ */
+function getLinuxDistro() {
+    try {
+        const content = fs.readFileSync("/etc/os-release", "utf-8");
+        const pretty = content.match(/^PRETTY_NAME="?(.+?)"?$/m);
+        if (pretty) return pretty[1];
+        const name = content.match(/^NAME="?(.+?)"?$/m);
+        return name ? name[1] : "Unknown Linux";
+    } catch {
+        return "Unknown Linux";
+    }
+}
+
+/**
+ * Reads the package-type file written by electron-builder
+ * to determine how the app was distributed (rpm, snap, AppImage, deb...)
+ */
+function getPackageType() {
+    try {
+        const pkgTypePath = require("path").join(process.resourcesPath, "package-type");
+        if (fs.existsSync(pkgTypePath)) {
+            return fs.readFileSync(pkgTypePath, "utf-8").trim();
+        }
+    } catch { /* ignore */ }
+    return "unknown";
+}
+
+/**
+ * Checks if Firefox is installed on the current platform
+ */
+function detectFirefox() {
+    const platform = process.platform;
+
+    if (platform === "win32") {
+        const paths = [
+            "C:\\Program Files\\Mozilla Firefox\\firefox.exe",
+            "C:\\Program Files (x86)\\Mozilla Firefox\\firefox.exe",
+            `${process.env.LOCALAPPDATA}\\Mozilla Firefox\\firefox.exe`,
+        ];
+        return paths.some(p => fs.existsSync(p));
+    }
+
+    if (platform === "linux") {
+        const paths = [
+            "/usr/bin/firefox",
+            "/usr/bin/firefox-esr",
+            "/usr/local/bin/firefox",
+            "/snap/bin/firefox",
+            "/var/lib/flatpak/exports/bin/org.mozilla.firefox",
+            `${os.homedir()}/.local/share/flatpak/exports/bin/org.mozilla.firefox`,
+        ];
+        if (paths.some(p => fs.existsSync(p))) return true;
+        try { execSync("which firefox", { stdio: "ignore" }); return true; } catch { return false; }
+    }
+
+    return false;
+}
+
+/**
+ * Builds the system info object logged at startup
+ * 
+ * @param {string} logDir - path to the log directory
+ * @param {string} downloadPath - current configured download path
+ */
+function getSystemInfo(logDir, downloadPath) {
+    const platform = process.platform;
+    const cpus = os.cpus();
+    const totalMem = (os.totalmem() / 1024 / 1024 / 1024).toFixed(1);
+    const freeMem  = (os.freemem()  / 1024 / 1024 / 1024).toFixed(1);
+
+    let platformLabel;
+    if (platform === "win32") {
+        platformLabel = `Windows (${os.release()})`;
+    } else if (platform === "linux") {
+        platformLabel = `Linux — ${getLinuxDistro()}`;
+    } else {
+        platformLabel = `${platform} ${os.release()} (unsupported)`;
+    }
+
+    const info = {
+        "Platform":        platformLabel,
+        "Architecture":    os.arch(),
+        "CPU":             cpus.length ? `${cpus[0].model.trim()} (${cpus.length} cores)` : "Unknown",
+        "Memory":          `${freeMem} GB free / ${totalMem} GB total`,
+        "Locale":          app.getLocale(),
+        "Electron":        process.versions.electron,
+        "Node":            process.versions.node,
+        "Packaged":        String(app.isPackaged),
+        "Package type":    app.isPackaged ? getPackageType() : "dev",
+        "Firefox present": detectFirefox() ? "Yes" : "No — cookie features unavailable",
+        "Log directory":   logDir,
+        "Download path":   downloadPath,
+    };
+
+    // Linux-specific extras
+    if (platform === "linux") {
+        const sessionType = process.env.XDG_SESSION_TYPE || "unknown";
+        const waylandDisplay = process.env.WAYLAND_DISPLAY;
+        const x11Display = process.env.DISPLAY;
+
+        info["Display server"]  = waylandDisplay
+            ? `Wayland (${waylandDisplay})`
+            : x11Display
+            ? `X11 (${x11Display})`
+            : sessionType !== "unknown"
+            ? sessionType
+            : "unknown";
+
+        info["Desktop env"] = process.env.XDG_CURRENT_DESKTOP || process.env.DESKTOP_SESSION || "unknown";
+    }
+
+    return info;
+}
+
+/**
+ * Logs system info at application startup
+ *
+ * @param {object} logger - winston logger instance
+ * @param {string} logDir - path to the log directory
+ * @param {string} downloadPath - current configured download path
+ */
+function logSystemInfo(logger, logDir, downloadPath) {
+    const info = getSystemInfo(logDir, downloadPath);
+    const maxKeyLen = Math.max(...Object.keys(info).map(k => k.length));
+
+    logger.info("=".repeat(60));
+    logger.info("SYSTEM INFO");
+    logger.info("=".repeat(60));
+    for (const [key, val] of Object.entries(info)) {
+        logger.info(`  ${key.padEnd(maxKeyLen)} : ${val}`);
+    }
+    logger.info("=".repeat(60));
+}
+
+module.exports = { logSystemInfo };

test/unit/buildArgs.test.js

@@ -0,0 +1,182 @@
+const path = require("path");
+
+jest.mock("../../server/helpers/getBrowser.helpers.js", () =>
+    jest.fn(() => "firefox")
+);
+
+jest.mock("../../server/helpers/path.helpers.js", () => ({
+    ffmpegPath: "/mock/ffmpeg",
+    denoPath: "/mock/deno",
+}));
+
+jest.mock("../../config.js", () => ({
+    configFeatures: {
+        autoUpdate: false,
+        discordRPC: false,
+        customTopBar: false,
+        autoCheckInfo: false,
+        addThumbnail: true,
+        addMetadata: true,
+        verboseLogs: false,
+        autoDownloadPlaylist: false,
+        customCodec: "h264",
+    },
+}));
+
+jest.mock("../../server/logger.js", () => ({
+    logger: {
+        info: jest.fn(),
+        error: jest.fn(),
+    },
+}));
+
+const { buildYtDlpArgs } = require("../../server/helpers/buildArgs.helpers");
+const { configFeatures } = require("../../config");
+const { logger } = require("../../server/logger");
+
+describe("buildYtDlpArgs", () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+
+    test("builds default video arguments", () => {
+        const args = buildYtDlpArgs({
+            url: "https://youtube.com/watch?v=123",
+            audioOnly: false,
+            quality: "best",
+            outputFolder: "/downloads",
+        });
+
+        expect(args).toContain("--cookies-from-browser");
+        expect(args).toContain("firefox");
+
+        expect(args).toContain("--ffmpeg-location");
+        expect(args).toContain("/mock/ffmpeg");
+
+        expect(args).toContain("--js-runtimes");
+        expect(args).toContain("deno:/mock/deno");
+
+        expect(args).toContain("--merge-output");
+        expect(args).toContain("mp4");
+
+        expect(args).toContain("-f");
+        expect(args).toContain("bestvideo+bestaudio/best/mp4");
+
+        expect(args).toContain(
+            path.join("/downloads", "%(title)s.%(ext)s")
+        );
+
+        expect(args.at(-1)).toBe("https://youtube.com/watch?v=123");
+    });
+
+    test("builds audio-only arguments", () => {
+        const args = buildYtDlpArgs({
+            url: "https://youtube.com/watch?v=123",
+            audioOnly: true,
+            quality: "best",
+            outputFolder: "/downloads",
+        });
+
+        expect(args).toContain("--extract-audio");
+        expect(args).toContain("--audio-format");
+        expect(args).toContain("mp3");
+        expect(args).toContain("bestaudio");
+
+        expect(args).not.toContain("--merge-output");
+    });
+
+    test("uses requested quality", () => {
+        const args = buildYtDlpArgs({
+            url: "https://youtube.com/watch?v=123",
+            audioOnly: false,
+            quality: "720",
+            outputFolder: "/downloads",
+        });
+
+        expect(args).toContain(
+            "bestvideo[height<=720]+bestaudio/best[height<=720]/mp4"
+        );
+    });
+
+    test("falls back to best for unknown quality", () => {
+        const args = buildYtDlpArgs({
+            url: "https://youtube.com/watch?v=123",
+            audioOnly: false,
+            quality: "unknown",
+            outputFolder: "/downloads",
+        });
+
+        expect(args).toContain("best");
+    });
+
+    test("uses --no-playlist by default", () => {
+        const args = buildYtDlpArgs({
+            url: "https://youtube.com/watch?v=123",
+            audioOnly: false,
+            quality: "best",
+            outputFolder: "/downloads",
+        });
+
+        expect(args).toContain("--no-playlist");
+        expect(args).not.toContain("--yes-playlist");
+    });
+
+    test("uses --yes-playlist when enabled", () => {
+        configFeatures.autoDownloadPlaylist = true;
+
+        const args = buildYtDlpArgs({
+            url: "https://youtube.com/watch?v=123",
+            audioOnly: false,
+            quality: "best",
+            outputFolder: "/downloads",
+        });
+
+        expect(args).toContain("--yes-playlist");
+        expect(args).not.toContain("--no-playlist");
+
+        configFeatures.autoDownloadPlaylist = false;
+    });
+
+    test("embeds thumbnail and metadata when enabled", () => {
+        const args = buildYtDlpArgs({
+            url: "https://youtube.com/watch?v=123",
+            audioOnly: false,
+            quality: "best",
+            outputFolder: "/downloads",
+        });
+
+        expect(args).toContain("--embed-thumbnail");
+        expect(args).toContain("--add-metadata");
+    });
+
+    test("logs codec validation", () => {
+        buildYtDlpArgs({
+            url: "https://youtube.com/watch?v=123",
+            audioOnly: false,
+            quality: "best",
+            outputFolder: "/downloads",
+        });
+
+        expect(logger.info).toHaveBeenCalledWith("Codec Valid: h264");
+    });
+
+    test("falls back to h264 when codec is invalid", () => {
+        configFeatures.customCodec = "invalid";
+
+        const args = buildYtDlpArgs({
+            url: "https://youtube.com/watch?v=123",
+            audioOnly: false,
+            quality: "best",
+            outputFolder: "/downloads",
+        });
+
+        expect(logger.error).toHaveBeenCalledWith(
+            "Codec not valid: invalid. Using default codec"
+        );
+
+        const sortIndex = args.indexOf("-S");
+        expect(args[sortIndex + 1]).toContain("vcodec:h264");
+
+        configFeatures.customCodec = "h264";
+    });
+});

test/unit/notify.helpers.test.js

@@ -0,0 +1,133 @@
+const mockShow = jest.fn();
+const mockOn = jest.fn();
+const mockOpenPath = jest.fn();
+const mockOpenExternal = jest.fn();
+
+jest.mock("electron", () => ({
+    Notification: jest.fn().mockImplementation(() => ({
+        show: mockShow,
+        on: mockOn,
+    })),
+    shell: {
+        openPath: mockOpenPath,
+        openExternal: mockOpenExternal,
+    },
+}));
+
+jest.mock("../../server/helpers/path.helpers", () => ({
+    iconPaths: {
+        confirm: "/icons/confirm.png",
+        error: "/icons/error.png",
+    },
+}));
+
+jest.mock("../../server/logger", () => ({
+    logger: {
+        info: jest.fn(),
+        error: jest.fn(),
+    },
+}));
+
+const { Notification, shell } = require("electron");
+
+const {
+    notifyDownloadFinished,
+    notifyCookiesBrowserError,
+    notifyFirefoxBrowserMissing,
+} = require("../../server/helpers/notify.helpers");
+
+describe("notify.helpers", () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+
+    describe("notifyDownloadFinished", () => {
+        test("does nothing when notifications are disabled", () => {
+            notifyDownloadFinished("/downloads", false);
+
+            expect(Notification).not.toHaveBeenCalled();
+        });
+
+        test("does nothing when folder is missing", () => {
+            notifyDownloadFinished(undefined, true);
+
+            expect(Notification).not.toHaveBeenCalled();
+        });
+
+        test("creates and shows notification", () => {
+            notifyDownloadFinished("/downloads");
+
+            expect(Notification).toHaveBeenCalledWith({
+                title: "Freedom Loader",
+                body: "Your download is complete, click here to open it.",
+                icon: "/icons/confirm.png",
+            });
+
+            expect(mockOn).toHaveBeenCalledWith(
+                "click",
+                expect.any(Function)
+            );
+
+            expect(mockShow).toHaveBeenCalled();
+        });
+
+        test("opens folder when notification is clicked", () => {
+            notifyDownloadFinished("/downloads");
+
+            const callback = mockOn.mock.calls[0][1];
+            callback();
+
+            expect(shell.openPath).toHaveBeenCalledWith("/downloads");
+        });
+    });
+
+    describe("notifyCookiesBrowserError", () => {
+        test("creates notification", () => {
+            notifyCookiesBrowserError();
+
+            expect(Notification).toHaveBeenCalledWith({
+                title: "Cookies Error",
+                body: "Unable to retrieve cookies. Please log in to your browser and click here to view the tutorial.",
+                icon: "/icons/error.png",
+            });
+
+            expect(mockShow).toHaveBeenCalled();
+        });
+
+        test("opens tutorial when clicked", () => {
+            notifyCookiesBrowserError();
+
+            const callback = mockOn.mock.calls[0][1];
+            callback();
+
+            expect(shell.openExternal).toHaveBeenCalledWith(
+                "https://youtube.com/shorts/cN9f4s1Mf88?si=519QCVd_-fzJqRf1"
+            );
+        });
+    });
+
+    describe("notifyFirefoxBrowserMissing", () => {
+        test("creates notification", () => {
+            notifyFirefoxBrowserMissing();
+
+            expect(Notification).toHaveBeenCalledWith({
+                title: "Firefox Missing",
+                body: "Firefox was not found on your system. Click here to follow the installation guide",
+                icon: "/icons/error.png",
+            });
+
+            expect(mockShow).toHaveBeenCalled();
+        });
+
+        test("opens installation guide when clicked", () => {
+            notifyFirefoxBrowserMissing();
+
+            const callback = mockOn.mock.calls[0][1];
+            callback();
+
+            expect(shell.openExternal).toHaveBeenCalledWith(
+                "https://youtube.com/shorts/cN9f4s1Mf88?si=519QCVd_-fzJqRf1"
+            );
+        });
+    });
+});