1.5.0 !!!!!!

IT'S TIME

.env.example

@@ -1,2 +0,0 @@
-BUG_REPORT_URL=
-BUG_REPORT_API_KEY=

.github/ISSUE_TEMPLATE/performance-issue.md

@@ -29,9 +29,6 @@ Clear description of the performance issue.
 - **Storage**: [e.g. SSD/HDD]
 - **Other Applications Opened**: [e.g. Discord/Opera GX]
 
-> [!INFO]
-> At the start of the application, SystemInfo is printed in the logs, so you can just copy and paste it!
-
 ## Reproduction Details
 
 - **Download URL**: [if applicable]

.github/ISSUE_TEMPLATE/question.md

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

.github/PULL_REQUEST_TEMPLATE/contribution.md

@@ -2,7 +2,7 @@
 
 Brief description of what this PR does.
 
-## Related Issue (if applicable)
+## Related Issue
 
 Fixes #(issue number)
 Closes #(issue number)
@@ -30,7 +30,7 @@ Related to #(issue number)
 - [ ] I have tested with different download scenarios (video/audio, playlists)
 - [ ] I have checked the application logs for errors
 - [ ] I have verified the UI changes (if applicable)
-- [ ] I have tested on Windows 10 and/or Windows 11 or in any Linux Distribution
+- [ ] I have tested on Windows 10 and/or Windows 11
 
 ## Screenshots (if applicable)
 

.github/workflows/codeql.yml

@@ -1,46 +0,0 @@
-name: "CodeQL PR"
-
-on:
-  pull_request:
-    branches: [ "main" ]
-  schedule:
-    - cron: '00 00 * * 1'
-
-jobs:
-  analyze:
-    name: Analyze (${{ matrix.language }})
-    runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
-    permissions:
-      security-events: write
-      packages: read
-      actions: read
-      contents: read
-
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - language: javascript-typescript
-            build-mode: none
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Initialize CodeQL
-        uses: github/codeql-action/init@v4
-        with:
-          languages: ${{ matrix.language }}
-          build-mode: ${{ matrix.build-mode }}
-
-      - name: Run manual build steps
-        if: matrix.build-mode == 'manual'
-        shell: bash
-        run: |
-          echo 'Manual build required'
-          exit 1
-
-      - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v4
-        with:
-          category: "/language:${{matrix.language}}"

.gitignore

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

BINARIES.md

@@ -1,97 +0,0 @@
-# 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.
-- **Yt-dlp** binaries don't need to be updated manually. At every startup of the application, the binary tries to update itself

CONTRIBUTING.md

@@ -6,7 +6,6 @@ Welcome! Thanks for your interest in Freedom Loader. Your contributions—bug re
 
 ## Quick Links
 
-- [Development Guide](DEVELOPMENT.md)
 - [Code of Conduct](CODE_OF_CONDUCT.md)
 - [Issue Templates](.github/ISSUE_TEMPLATE/)
 - [Pull Request Templates](.github/PULL_REQUEST_TEMPLATE/)
@@ -24,7 +23,7 @@ Found a bug or unexpected behavior? Open an [**issue**](https://github.com/Maste
 - Clear description of the bug
 - Steps to reproduce
 - App version and environment (Windows version, Firefox version if relevant)
-- Logs from: `C:\Users\[USERNAME]\AppData\Local\FreedomLoader\logs\LOGS-YYYY-MM-DD.log` (Windows) or `~/.local/share/FreedomLoader/logs/` (Linux)
+- Logs from: `C:\Users\[USERNAME]\AppData\Local\FreedomLoader\logs\LOGS-YYYY-MM-DD.log`
 - Screenshots if applicable
 
 ### 2. Request a Feature
@@ -44,11 +43,13 @@ Have an idea to improve Freedom Loader? Open a [**Feature Request**](https://git
 - Follow the project's code style and conventions
 
 **Process:**
-1. Fork the repository.
+1. Fork the repository
-2. Check out our [**Developer Guide (DEVELOPMENT.md)**](./DEVELOPMENT.md) to set up your environment.
+2. Create a feature branch: `git checkout -b feature/your-feature-name`
-3. Create a feature branch following our branching conventions.
+3. Make your changes
-4. Make your changes and test thoroughly on Windows and/or Linux.
+4. Test thoroughly on Windows 10/11
-5. Open a Pull Request using the appropriate template.
+5. Commit with clear messages: `git commit -m "Add feature X"`
+6. Push to your fork: `git push origin feature/your-feature-name`
+7. Open a Pull Request using the appropriate template
 
 **Code Guidelines:**
 - Use camelCase for variables and functions
@@ -71,9 +72,41 @@ Small contributions matter—don't hesitate to submit documentation PRs.
 
 ## Development Setup
 
-Want to write some code? Awesome! 
+### Prerequisites
+- Node.js 16.x or higher
+- npm or yarn
+- Git
+- Windows 10/11 (for testing)
 
-Please read our [**Developer Guide (DEVELOPMENT.md)**](./DEVELOPMENT.md) for instructions on how to set up your local environment, our project architecture, and our Git branching rules.
+### Setup
+```bash
+# Clone your fork
+git clone https://github.com/YOUR-USERNAME/Freedom-Loader.git
+cd Freedom-Loader
+
+# Install dependencies
+npm install
+
+# Run in development mode
+npm start
+
+# Build for production
+npm run build
+```
+
+### Project Structure
+```
+Freedom-Loader/
+├── main.js           # Electron main process
+├── preload.js        # Electron preload script
+├── config.js         # Global configuration
+├── server/           # Express backend
+│   ├── routes/       # API routes
+│   ├── controller/   # Business logic
+│   └── helpers/      # Utility functions
+├── public/           # Frontend (HTML, CSS, JS)
+└── ressources/       # Binaries (yt-dlp, ffmpeg, etc.)
+```
 
 ---
 
@@ -81,9 +114,12 @@ Please read our [**Developer Guide (DEVELOPMENT.md)**](./DEVELOPMENT.md) for ins
 
 Before submitting a PR, verify:
 - [ ] Download functionality works (video/audio)
+- [ ] Playlist downloads work
+- [ ] Settings panel functions correctly
+- [ ] Custom path selection works
 - [ ] No errors in application logs
-- [ ] Any features wasn't break during the development
+- [ ] UI changes work on all themes (if applicable)
-- [ ] Tested on Windows 10/11 and/or any Linux Distribution
+- [ ] Tested on Windows 10 and/or Windows 11
 
 ---
 
@@ -125,4 +161,4 @@ Check out his work: [IG @designmark_studio](https://www.instagram.com/designmark
 
 ---
 
-**Thank you for contributing to Freedom Loader!**
+**Thank you for contributing to Freedom Loader!**

DEVELOPMENT.md

@@ -1,388 +0,0 @@
-# Freedom Loader - Development Guide
-
-Welcome to the Developer Guide! This document explains how to set up your local environment, project architecture, Git workflow, and the release process.
-
-## Prerequisites
-
-Before you begin, ensure you have the following installed on your machine:
-
-- **Node.js** (v22 or higher recommended)
-- **npm** (comes with Node.js)
-- **Git**
-- **yt-dlp binaries**: Freedom Loader requires native binaries to function. Read [BINARIES.md](./BINARIES.md) for download instructions and placement in `resources/binaries/`.
-
-## Setup Instructions
-
-### 1. Clone the repository
-
-```bash
-git clone https://github.com/MasterAcnolo/Freedom-Loader.git
-cd Freedom-Loader
-```
-
-### 2. Install dependencies
-
-```bash
-npm install
-```
-
-### 3. Install the Binaries
-
-Follow the instructions in `BINARIES.md` to place `yt-dlp`, `ffmpeg`, `ffprobe`, and `deno` in the correct `resources/binaries/` folder for your OS.
-
-### 4. Run in Development Mode
-
-```bash
-npm start
-```
-
-**Note**: Development mode automatically enables detailed colored logs and the DevTron extension for debugging.
-
----
-
-## Available Scripts
-
-### Development
-
-- `npm start` — Start the app in development mode (no warnings)
-- `npm run start:warn` — Start with deprecation warnings visible
-- `npm run start:debug` — Start with full debug logging (Wayland, Electron logging, stack dumps)
-- `npm run dev` — Start with auto-reload on file changes (watches server/, app/, main.js, config.js)
-- `npm run dev:warn` — Dev mode with warnings
-- `npm run dev:debug` — Dev mode with full debug output and auto-reload
-
-### Building
-
-- `npm run build:linux` — Build Linux packages (AppImage, deb, snap)
-- `npm run build:win` — Build Windows installer (.exe)
-- `npm run build:rpm` — Build RPM and SRPM for COPR (Fedora)
-- `npm run build:all` — Build both Windows and Linux (not recommended because it adds both OS binaries into a single package. The output file is 2x bigger than expected).
-
-### Testing
-
-- `npm test` — Run all tests (unit + integration)
-- `npm run test:unit` — Run unit tests only
-
-### Release Pipeline
-
-- `npm run release` — Build all packages and create a draft GitHub release (no store publishing)
-- `npm run release:publish` — Build all packages and publish to Snap Store + COPR
-- `npm run release:dry-run` — Simulate the full release pipeline without publishing anything
-
-### Maintenance
-
-- `npm update` — Update npm dependencies
-
----
-
-## Project Architecture
-
-Freedom Loader is built with **Electron** (frontend) and **Node.js + Express** (backend), using a modular structure:
-
----
-
-## Git & Branching Workflow
-
-I use **Trunk-Based Development** (GitHub Flow):
-
-### Core Principles
-
-- **`main` is always deployable**: The `main` branch contains the latest stable code and must never be broken.
-- **No long-lived branches**: I no longer maintain version branches like `v1.6` or `v1.7`.
-- **Pull Requests for review**: All code changes go through PR review before merging to `main`.
-
-### How to Contribute
-
-#### 1. Create a feature branch
-
-```bash
-git checkout -b feat/add-new-button
-# or for fixes:
-git checkout -b fix/ui-bug
-```
-
-**Branch naming convention**:
-- `feat/` — New features
-- `fix/` — Bug fixes
-- `refactor/` — Code cleanup (no behavior change)
-- `docs/` — Documentation updates
-- `chore/` — Dependency updates, build config, etc.
-
-#### 2. Make commits
-
-```bash
-# Make changes
-git add .
-git commit -m "Brief, imperative description of the change"
-```
-
-**Commit message tips**:
-- Use imperative mood: "Add theme caching" not "Added theme caching"
-- Keep commits logical and focused (one feature per commit if possible)
-- Link to issues if relevant: "Fix crash on download (fixes #42)"
-
-#### 3. Push and open a PR
-
-```bash
-git push origin feat/add-new-button
-```
-
-Then open a PR on GitHub against `main`.
-
-#### 4. Review and merge
-
-- Address feedback in new commits (don't rebase — easier to review)
-- Once approved, merge via GitHub (use "Squash and merge" for clean history if many small commits and you find it relevant)
-
----
-
-## Release Process
-
-**Note**: Only project maintainers release to production. This section documents the process for transparency and for future maintainers.
-
-Releases are fully automated via the `release.sh` script. The process handles building, packaging, and publishing to **all distribution channels**:
-- **GitHub Releases** (Windows .exe, Linux packages)
-- **Fedora COPR** (automatic RPM builds for Fedora 43+)
-- **Snap Store** (universal Linux)
-
-### Before You Release
-
-1. **Ensure `main` is green**: All tests pass, features are stable.
-2. **Update `package.json` version**:
-
-```json
-   "version": "1.6.1"
-```
-3. **Commit the version bump**: `git add package.json && git commit -m "chore: v1.6.1"`
-4. **Push to `main`**: `git push origin main`
-
-### Step 1: Local Build & Draft Release
-
-```bash
-npm run release
-```
-
-This:
-1. Builds Linux packages (AppImage, deb, snap)
-2. Builds RPM and SRPM for COPR
-3. Builds Windows installer
-4. Creates a draft GitHub release
-
-### Step 2: Edit & Publish on GitHub
-
-1. Go to https://github.com/MasterAcnolo/Freedom-Loader/releases
-2. Edit the draft release — fill in changelog
-3. Click **"Publish"** to make it live
-
-### Step 3: Publish to Distribution Channels
-
-```bash
-npm run release:publish
-```
-
-This automatically:
-- **Uploads to Snap Store**: Makes the app available via `snap install freedom-loader`
-- **Submits to Fedora COPR**: Builds and publishes RPMs for Fedora 43+ (users can `dnf install freedom-loader` from the COPR repo)
-
-Both happen in parallel — users across all platforms get the release simultaneously.
-
----
-
-## Linux Development Considerations
-
-### Cross-Distribution Compatibility
-
-Freedom Loader targets **Debian-based** (Ubuntu, Debian) and **Fedora-based** (Fedora, RHEL, openSUSE) distributions. When developing features, keep this in mind:
-
-#### What to test
-
-- **Feature works on Fedora 44+** (primary Linux development environment)
-- **Feature works on Ubuntu/Debian** (via deb package or AppImage)
-- **Feature doesn't break Snap confinement** (Snap has restricted filesystem/IPC access)
-- **Feature gracefully degrades on missing system dependencies**
-
-#### Desktop Environment (DE) Compatibility
-
-Test on at least **GNOME** and **KDE** (the most common DEs). Common pain points:
-
-- **Themes**: May render differently on KDE vs GNOME — test both if possible
-- **File dialogs**: Some DEs use native file pickers, others fall back to Electron's
-- **Notifications**: System notification APIs vary (D-Bus, libnotify)
-- **Tray icons**: May not work identically across DEs
-
-#### How to check locally
-
-```bash
-# Test on Fedora (if available)
-npm run build:linux
-sudo dnf install dist/freedom-loader-*.x86_64.rpm
-freedom-loader
-
-# Test AppImage (works on any distro)
-chmod +x dist/Freedom\ Loader-*.AppImage
-./dist/Freedom\ Loader-*.AppImage
-```
-
-### CI/CD Gap
-
-**Currently**: No automated testing across distros or DEs. Releases rely on manual testing before publish.
-
-**Future improvement**: Automated tests via GitHub Actions (Ubuntu) + local testing on Fedora would catch cross-distro issues early. This is planned but not yet implemented.
-
-For now, if you fix a Linux-specific bug or add a DE-dependent feature, **please mention it in your PR description** so reviewers can test extra carefully.
-
----
-
-## Testing
-
-### Unit Tests
-
-Test individual functions in isolation (no Electron required).
-
-```bash
-npm run test:unit
-```
-
-Covered:
-
-(Tests will come soon)
-
-### End-to-End Tests (Playwright)
-
-Test the actual Electron app launching and basic UI interactions.
-
-```bash
-npm run test
-```
-
-Covered:
-
-(Tests will come soon)
-
-
-### Running All Tests
-
-```bash
-npm test
-```
-
-Or include tests before release:
-
-```bash
-npm test && npm run release
-```
-
----
-
-## Common Tasks
-
-### Add a new feature
-
-1. Create a feature branch: `git checkout -b feat/my-feature`
-2. Make changes, commit: `git add . && git commit -m "feat: my feature"`
-3. Push: `git push origin feat/my-feature`
-4. Open a PR on GitHub
-5. Once approved, merge to `main`
-6. (Later) Cut a release when ready: `npm run release`
-
-### Fix a bug
-
-Same as above, but use `fix/bug-name` branch and `git commit -m "fix: description"`.
-
-### Test the app before releasing
-
-```bash
-npm run dev        # Auto-reload on file changes
-# Make changes, test in the UI
-npm test           # Run all tests
-npm run release:dry-run   # Simulate release (builds but doesn't publish)
-```
-
-### Update dependencies
-
-```bash
-npm update
-git add package.json package-lock.json
-git commit -m "chore: update dependencies"
-git push origin main
-```
-
-### Rebuild only Linux (after quick fixes)
-
-```bash
-npm run build:linux
-# Or just the RPM:
-npm run build:rpm
-```
-
-### Publish to stores manually
-
-If `npm run release:publish` fails partway:
-
-```bash
-# Just Snap:
-snapcraft upload dist/freedom-loader_*.snap --release=stable
-
-# Just COPR:
-copr-cli build freedom-loader srpm-out/*.src.rpm
-```
-
----
-
-## Troubleshooting
-
-### App won't start in dev mode
-
-```bash
-npm run start:debug
-```
-
-Check the debug output for errors. Most common:
-- Missing binaries in `resources/binaries/`
-- Port 8787 already in use
-- A dead instance is still running — open Task Manager and kill the "Freedom Loader" process
-
-### (Linux) Binaries in the right place but app still won't launch
-
-You probably forgot to make them executable:
-
-```bash
-chmod +x resources/binaries/linux/*
-```
-
-The app will fail silently if binaries lack execute permissions.
-
-### Build fails with "permission denied"
-
-Make sure you have write access to `dist/` and `srpm-out/`:
-
-```bash
-chmod -R u+w dist srpm-out
-npm run build:linux
-```
-
-### Tests fail
-
-Check for:
-- Missing test files in `tests/unit/`
-- Node modules out of sync: `rm -rf node_modules && npm install`
-
-### GitHub release publish fails
-
-Verify `gh` CLI is installed and authenticated:
-
-```bash
-gh auth login
-gh release list
-```
-
----
-
-## Questions?
-
-For more info:
-- **Electron docs**: https://www.electronjs.org/docs
-- **electron-builder**: https://www.electron.build/
-- **This repo**: https://github.com/MasterAcnolo/Freedom-Loader
-
-Happy coding! 🎉

README.md

@@ -5,9 +5,9 @@
     alt="Banner"
     style="width: 50%;"/></a>
 
-### **A clean, open-source multimedia downloader for Windows and Linux**
+### **A clean, open-source multimedia downloader for Windows**
 
-[![Release](https://img.shields.io/github/v/release/MasterAcnolo/Freedom-Loader?style=for-the-badge&color=blue)](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+[![Release](https://img.shields.io/badge/Release-1.5.0-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/Freedom-Loader-Site/)
 [![Workshop](https://img.shields.io/badge/Worshop-Visit-0E05A1?style=for-the-badge)](https://masteracnolo.github.io/Freedom-Loader-Workshop/)
@@ -15,6 +15,8 @@
 
 </div>
 
+---
+
 ## Overview
 
 Freedom Loader is a desktop application built with Electron that provides a straightforward way to download video and audio content with full metadata support. The application focuses on reliability, transparency, and user privacy-no ads, no tracking, no questionable third-party services.
@@ -23,8 +25,8 @@ The primary goal is to make media downloading accessible to users who want offli
 
 ### See related repo:
 
-- **[Website](https://github.com/MasterAcnolo/Freedom-Loader-Site/)** - Official project website and documentation
+- **[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
+- **[Workshop](https://masteracnolo.github.io/Freedom-Loader-Workshop/)** - Theme creation tool and theme browser
 
 ## Table of Contents
 
@@ -33,12 +35,14 @@ The primary goal is to make media downloading accessible to users who want offli
 - [Usage](#usage)
 - [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)
 
 ## Features
@@ -57,9 +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)
-- **Custom themes** - ZIP-based theme system with live preview
+- **Custom themes** — ZIP-based theme system with live preview
-- **Theme Workshop** - web-based theme creator and browser
+- **Theme Workshop** — web-based theme creator and browser
-- **Toast notifications** - in-app feedback system
+- **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
@@ -76,90 +80,41 @@ 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
+- **Splash screen** — animated loading screen on startup
-- **Stop download** - ability to cancel in-progress downloads
+- **Stop download** — ability to cancel in-progress downloads
-- **Playlist folders** - dedicated folder creation per playlist
+- **Playlist folders** — dedicated folder creation per playlist
-- **Keep Playlist Order** - Add an Index before the title, could be useful for an album for example.
-- **System Tray** - Could minimize the application in the system Tray, allow it to run in the background.
 
 ## 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
 
-- **Windows**: Windows 10 or later
+- **Operating System**: Windows 10 or later
-- **Linux**: any modern x86_64 distribution
+- **Browser**: Mozilla Firefox (required for cookie extraction)
-- **Browser**: Mozilla Firefox ([download](https://www.firefox.com)) required for cookie extraction, on both platforms
+  - [Download Firefox](https://www.firefox.com)
 
-### Windows
+### Standard Installation
 
-1. Download the latest `.exe` from the [Releases page](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+1. Download the latest release from the [Releases page](https://github.com/MasterAcnolo/Freedom-Loader/releases)
-2. Run the installer (click "More info" → "Run anyway" if Windows Defender warns you)
+2. Run the downloaded `.exe` installer
-3. Follow the installation wizard
+3. If Windows Defender shows a warning, click "More info" then "Run anyway"
-
+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
 
-|               | Windows                                                 | Linux                                |
+Downloaded files are stored in:
-|---------------|---------------------------------------------------------|--------------------------------------|
+```
-| **Downloads** | `C:\Users\[USERNAME]\Downloads\Freedom Loader`          | `~/Downloads/Freedom Loader`         |
+C:\Users\[USERNAME]\Downloads\Freedom Loader
-| **Logs**      | `C:\Users\[USERNAME]\AppData\Local\FreedomLoader\logs\` | `~/.local/share/FreedomLoader/logs/` |
+```
-
 > [!NOTE]
-> The download folder can be changed anytime via the "Edit" button in the UI, on both platforms.
+> *You can change it whenever you want. Just click the "Edit" button in the UI.*
+
+Application logs can be found at:
+```
+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
@@ -176,15 +131,14 @@ The application supports various configuration options:
 - Custom download directory selection
 - Discord Rich Presence activation
 - Theme customization
-- Log level
+- Log level configuration
-- And somes to see in the list [Configuration Options](#configuration-options) available
 
 ### Troubleshooting
 
 If you encounter issues:
 
 1. Restart the application
-2. Check the logs in `AppData\Local\FreedomLoader\logs\` or `~/.local/share/FreedomLoader/logs`
+2. Check the logs in `AppData\Local\FreedomLoader\logs\`
 3. Open the developer console: `CTRL + SHIFT + I` → "Toggle Developer Tools"
 4. Create an issue on GitHub with logs and reproduction steps
 
@@ -210,22 +164,14 @@ 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
+C:\Users\[USERNAME]\AppData\Roaming\FreedomLoader\config.json
-```
-
-#### Linux
-```
-~/.config/Freedom\ Loader/config.json
 ```
 
 ### Available Options
 ```json
 {
   "autoUpdate": true,
-  "systemTray": true,
   "discordRPC": true,
   "customTopBar": true,
   "autoCheckInfo": true,
@@ -233,40 +179,31 @@ 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,
   "outputTitleCheck": true,
   "downloadSystem": true,
-  "notifySystem": true,
+  "notifySystem": true
-  "enableHardwareAcceleration": true,
-  "theme": "dark" 
 }
 ```
 
 ### Configuration Options
 
-| Option                       | Type    | Default  | Description                                                |
+| Option | Type | Default | Description |
-|------------------------------|---------|----------|------------------------------------------------------------|
+|--------|------|---------|-------------|
-| `autoUpdate`                 | boolean | `true`   | Enable automatic application updates                       |
+| `autoUpdate` | boolean | `true` | Enable automatic application updates |
-| `systemTray`                 | boolean | `false`  | Allow app to minimize on close [EXPERIMENTAL]              |
+| `discordRPC` | boolean | `true` | Enable Discord Rich Presence integration |
-| `discordRPC`                 | boolean | `true`   | Enable Discord Rich Presence integration                   |
+| `customTopBar` | boolean | `true` | Use custom application top bar |
-| `customTopBar`               | boolean | `true`   | Use custom application top bar                             |
+| `autoCheckInfo` | boolean | `true` | Automatically fetch video information on URL paste |
-| `autoCheckInfo`              | boolean | `true`   | Automatically fetch video information on URL paste         |
+| `addThumbnail` | boolean | `true` | Embed thumbnail in downloaded audio files |
-| `addThumbnail`               | boolean | `true`   | Embed thumbnail in downloaded audio files                  |
+| `addMetadata` | boolean | `true` | Add metadata tags to downloaded files |
-| `addMetadata`                | boolean | `true`   | Add metadata tags to downloaded files                      |
+| `verboseLogs` | boolean | `false` | Enable detailed logging for debugging |
-| `verboseLogs`                | boolean | `false`  | Enable detailed logging for debugging                      |
+| `autoDownloadPlaylist` | boolean | `true` | Automatically download entire playlists |
-| `autoDownloadPlaylist`       | boolean | `true`   | Automatically download entire playlists                    |
+| `customCodec` | string | `"h264"` | Video codec for encoding (supported: h264, h265, vp9, av1) |
-| `keepPlaylistOrder`          | boolean | `false`  | Add index before title, usefull for album                  |
+| `logSystem` | boolean | `true` | Enable application logging |
-| `createPlaylistFolders`      | boolean | `false`  | Automatically create a folder for a playlist               |
+| `outputTitleCheck` | boolean | `true` | Verify output file titles |
-| `customCodec`                | string  | `"h264"` | Video codec for encoding (supported: h264, h265, vp9, av1) |
+| `downloadSystem` | boolean | `true` | Enable download system |
-| `logSystem`                  | boolean | `true`   | Enable application logging                                 |
+| `notifySystem` | boolean | `true` | Enable system notifications |
-| `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
 
@@ -279,7 +216,95 @@ Freedom Loader can be configured either through the settings panel in the UI or
 - `theora` - Theora (legacy open codec)
 
 > [!NOTE]
-> Some configuration changes may require an application restart to take effect.
+> Configuration changes may require an application restart to take effect.
+
+## Project Structure
+
+```
+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
+│   ├── 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
+├── ressources/              # 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
 
@@ -304,7 +329,7 @@ Freedom Loader includes a web-based theme creator available at [Freedom Loader W
 ### 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
+3. Restart the app — your theme appears in the settings panel
 
 ## Technology Stack
 
@@ -327,35 +352,110 @@ Freedom Loader includes a web-based theme creator available at [Freedom Loader W
 
 ## Development
 
-If you are interested by running a local non compiled version of Freedom Loader or just interested by contributing, see [DEVELOPMENT](./DEVELOPMENT.md)
+### Prerequisites
+
+- Node.js 16.x or higher
+- npm or yarn
+- Git
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/MasterAcnolo/Freedom-Loader.git
+cd Freedom-Loader
+
+# Install dependencies
+npm install
+
+# Run in development mode
+npm start
+
+# Build for production
+npm run build
+```
 
 ### Additional Dependencies
 
 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 `resources` folder, using the exact filenames listed below.
+You must download the required binaries and place them in the `ressources` folder, using the exact filenames listed below.
 
 #### Required binaries
 
-See [BINARIES.md](./BINARIES.md) for how to setup the binaries.
+- **Deno**
+  - Download from: https://sourceforge.net/projects/deno.mirror/files/latest/download
+  - Rename to: `deno.exe`
+
+- **FFmpeg**
+  - Download from: https://www.ffmpeg.org/download.html
+  - Required files:
+    - `ffmpeg.exe`
+    - `ffprobe.exe`
+
+- **yt-dlp**
+  - Already bundled with the project  
+  - No manual installation required
+
+Final folder structure:
+
+```
+ressources/
+├── deno.exe
+├── ffmpeg.exe
+├── ffprobe.exe
+└── yt-dlp.exe
+```
+
+> These binaries are required for the application to start correctly.  
+> If any of them are missing, an error message will be displayed at application startup.
 
 ### Development Guidelines
 
 - Follow existing code style and conventions
-- Write clear, imperative commit messages (e.g., "Add playlist indexing" not "Added")
+- Write clear commit messages
-- Test thoroughly on both Windows and Linux before submitting changes
+- Test thoroughly before submitting changes
-- Update documentation (README, DEVELOPMENT.md) when adding features
+- Update documentation when adding features
-- Maintain compatibility with:
+- Maintain compatibility with Windows 10+
-  - Windows 10+
-  - Fedora 43+ / Debian 11+ / Ubuntu 20.04+
-  - GNOME and KDE desktop environments (when possible)
-- Consider Linux distribution differences early (see [DEVELOPMENT.md](./DEVELOPMENT.md#linux-development-considerations))
 
 ## Roadmap
 
 See the most recent Roadmap [Here](https://masteracnolo.github.io/Freedom-Loader-Site/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.~~
+- [x] ~~Custom theme system (ZIP format) ~~
+- [x] ~~Theme Workshop (web tool)~~
+- [x] ~~Splash screen~~
+- [x] ~~Download stop button~~
+- [x] ~~Config saved in AppData (preserved on update)~~
+
+### In Progress
+
+- [ ] Additional format support (WebM, OGG, etc.)
+- [ ] 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
+
 ## Contributing
 
 Contributions are welcome and appreciated. This project benefits from community involvement.
@@ -367,29 +467,13 @@ Head over to the [Freedom Loader Workshop repository](https://github.com/MasterA
 
 ### Bug Reports
 
-You can report bugs either using the built-in application system or via the GitHub Issues system.
+Use the GitHub Issues system and include:
-
-#### Using the Built-in Report Tool
-
-1. Open Freedom Loader.
-2. Trigger the bug report interface.
-3. Fill in the title and description of the issue.
-4. Choose whether to include today's logs automatically.
-5. Submit the report.
-
-> [!NOTE]
-> If you need to attach extra context like screenshots or screen recordings, it is recommended to use the GitHub Issues
-system instead.
-
-#### Using GitHub Issues
-
-Open a new issue on the GitHub repository and include:
 
 - Clear description of the issue
 - Steps to reproduce
 - Expected vs actual behavior
-- Relevant logs from `AppData\Local\FreedomLoader\logs\` or `~/.local/share/FreedomLoader/logs/`
+- Relevant logs from `AppData\Local\FreedomLoader\logs\`
-- Screenshots or recordings if applicable
+- Screenshots if applicable
 
 ### Feature Requests
 
@@ -408,7 +492,15 @@ Open a feature request issue with:
 5. Update documentation as needed
 6. Submit a pull request with a detailed description
 
-Please read [CONTRIBUTING.md](CONTRIBUTING.md), [DEVELOPMENT.md](./DEVELOPMENT.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) before contributing.
+Please read [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) before contributing.
+
+## Support
+
+If you find this project useful and want to support its development:
+
+[![PayPal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://paypal.me/axelnicolas25)
+
+Your support helps maintain infrastructure, develop new features, and keep the project free and ad-free.
 
 ## License
 
@@ -420,12 +512,12 @@ 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 to bypass challenges
+- [Deno](https://deno.com/) for helping me bypassing 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
-- [@AureCX](https://github.com/AureCX) for being the Official Windows Tester!
 - Zakaria for the website icon 
+- Jacques Chirac to love Apples
 - All users who test, report issues, and help improve the application
 
 ---
@@ -436,4 +528,4 @@ You are free to use, modify, and redistribute this software under the terms of t
 
 [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

@@ -2,14 +2,15 @@
 
 ## Supported Versions
 
-Freedom Loader follows a **latest-only** support model. Security fixes are applied to the current release only — no backports to older versions.
+We actively maintain and provide security updates for the following versions of Freedom Loader:
 
-| Version       | Supported          |
+| Version | Supported          |
-| ------------- | ------------------ |
+| ------- | ------------------ |
-| Latest stable | :white_check_mark: |
+| 1.4.x   | :white_check_mark: |
-| Older versions | :x:               |
+| 1.3.x   | :white_check_mark: |
+| < 1.3.0 | :x:                |
 
-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.
+**Note**: We recommend always using the latest version to benefit from the most recent security patches and features.
 
 ## Reporting a Vulnerability
 
@@ -31,40 +32,37 @@ Instead, please report security issues privately by:
 
 ### What to Expect
 
-- **Acknowledgment**: I will acknowledge receipt of your report within 48 hours
+- **Acknowledgment**: We will acknowledge receipt of your report within 48 hours
-- **Assessment**: I will assess the vulnerability and determine its severity
+- **Assessment**: We will assess the vulnerability and determine its severity
-- **Updates**: I will keep you informed of our progress
+- **Updates**: We will keep you informed of our progress
-- **Resolution**: I aim to release a fix within 7-14 days for critical vulnerabilities
+- **Resolution**: We aim to release a fix within 7-14 days for critical vulnerabilities
-- **Credit**: I will credit you in the release notes (unless you prefer to remain anonymous)
+- **Credit**: We will credit you in the release notes (unless you prefer to remain anonymous)
 
 ## Security Best Practices for Users
 
-When using Freedom Loader, I recommend:
+When using Freedom Loader, we recommend:
 
 ### General Security
 
-- **Keep Updated**: Always use the latest version of Freedom Loader — older versions receive no security patches
+- **Keep Updated**: Always use the latest version of Freedom Loader
-- **Official Sources**: Download only from official sources:
+- **Official Sources**: Download only from official releases on [GitHub](https://github.com/MasterAcnolo/Freedom-Loader/releases)
-    - [GitHub Releases](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+- **Verify Downloads**: Check that installers are properly signed (Windows SmartScreen may show warnings for new 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
+- **Download Path**: Only set download paths within your user directory (`C:\Users\[USERNAME]\...`)
-- **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 such as URLs or local paths — avoid sharing them publicly without review
+- **Logs**: Logs may contain sensitive information—avoid sharing them publicly without review
 
 ### Privacy Considerations
 
 Freedom Loader respects your privacy:
 
-- **No Data Collection**: I don't collect, store, or transmit your personal data
+- **No Data Collection**: We 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 in settings
+- **Optional Features**: Discord RPC is optional and can be disabled
 
 ## Known Security Considerations
 
@@ -73,16 +71,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 outside your machine
+- **Local Only**: Cookies are read locally and never transmitted
-- **User Controlled**: You control what content you download
+- **User Controlled**: You can control what content you download
 
 ### Native Dependencies
 
-Freedom Loader bundles the following official binaries:
+Freedom Loader bundles native binaries:
 
-- **yt-dlp**: Official builds from [yt-dlp/yt-dlp](https://github.com/yt-dlp/yt-dlp) — auto-updated on each launch
+- **yt-dlp**: Official builds from [yt-dlp/yt-dlp](https://github.com/yt-dlp/yt-dlp)
 - **FFmpeg**: Official builds from [FFmpeg.org](https://ffmpeg.org/)
-- **Deno**: Official builds from [Deno.com](https://deno.com/)
+- **Deno**: Official builds from [Deno.land](https://deno.land/)
 
 These dependencies are verified and updated regularly.
 
@@ -93,13 +91,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 and will diminish as more users download the software.
+This is expected behavior for new releases. The warning will decrease as more users download the software.
 
 ## Vulnerability Disclosure Policy
 
 ### Our Commitment
 
-I am committed to:
+We are committed to:
 
 - Responding promptly to security reports
 - Working with security researchers to verify and address issues
@@ -109,9 +107,9 @@ I am 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
@@ -131,16 +129,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 directly)
+- Issues in third-party dependencies (report to upstream projects)
-- Missing security headers on the local HTTP server (not exposed remotely)
+- Missing security headers on local HTTP server (no remote access)
 
 ## Security Updates
 
 Security updates are released as:
 
-- **Patch Releases**: For critical security fixes (e.g., 1.6.0 → 1.6.1)
+- **Patch Releases**: For critical security fixes (e.g., 1.4.1 → 1.4.2)
 - **Automatic Updates**: Users are notified via the built-in update system
-- **Release Notes**: Security fixes are clearly marked in the changelog
+- **Release Notes**: Security fixes are clearly marked in changelog
 
 ## Additional Resources
 
@@ -152,7 +150,6 @@ Security updates are released as:
 
 For security-related questions or concerns:
 
-- **Email**: masteracnolo25@gmail.com
 - **GitHub**: [@MasterAcnolo](https://github.com/MasterAcnolo)
 
 ---

app/autoUpdater.js

@@ -1,42 +1,11 @@
-/**
- * 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}`);
 
@@ -51,7 +20,7 @@ function initAutoUpdater(mainWindow) {
     });
 
     if (response === 0) {
-      await autoUpdater.downloadUpdate();
+      autoUpdater.downloadUpdate();
     } else {
       mainWindow?.webContents.executeJavaScript(
         `window.showUpdateBadge && window.showUpdateBadge("${info.version}")`
@@ -59,10 +28,6 @@ function initAutoUpdater(mainWindow) {
     }
   });
 
-  /**
-   * 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", {
@@ -71,10 +36,6 @@ function initAutoUpdater(mainWindow) {
     });
   });
 
-  /**
-   * 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}`);
 
@@ -91,49 +52,15 @@ function initAutoUpdater(mainWindow) {
     if (response === 0) autoUpdater.quitAndInstall();
   });
 
-  /**
-   * Handles update system errors.
-   * Logs failure and displays an error dialog to user.
-   */
   autoUpdater.on("error", (err) => {
-    const msg = err?.message || "";
+    logger.error("Auto update error:", 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();
 }
 
-/**
- * Manually triggers update check on startup.
- * Separated from init for reusability and testability.
- */
 async function checkForUpdates() {
-
-  /**
-   * Prevents electron-updater from running inside sandboxed environments.
-   * Snap and Flatpak lock the file system in read-only mode, causing the updater to crash.
-   * In these environments, updates are safely handled by snapd or the Flatpak runtime.
-   * Standalone Linux packages (.deb, .rpm, AppImage) will bypass this and update normally.
-   */
-  if (process.env.SNAP || process.env.FLATPAK_ID) {
-    logger.info("Running as Snap or Flatpak. Updates are managed by the OS store. Skipping electron-updater.");
-    return;
-  }
-
-  if (!require("electron").app.isPackaged) return ;
-
   try {
     await autoUpdater.checkForUpdates();
   } catch (err) {
@@ -141,10 +68,6 @@ async function checkForUpdates() {
   }
 }
 
-/**
- * Manually triggers update download.
- * Used when user accepts update prompt.
- */
 async function downloadUpdate() {
   try {
     await autoUpdater.downloadUpdate();
@@ -153,9 +76,6 @@ async function downloadUpdate() {
   }
 }
 
-/**
- * Immediately quits application and installs downloaded update.
- */
 function installUpdate() {
   autoUpdater.quitAndInstall();
 }

app/dependencyCheck.js

@@ -2,61 +2,26 @@ 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: "yt-dlp.exe",  path: binaryPaths.ytDlp },
-    { name: `ffmpeg${addExe}`,  path: binaryPaths.ffmpeg },
+    { name: "ffmpeg.exe",  path: binaryPaths.ffmpeg },
-    { name: `ffprobe${addExe}`, path: binaryPaths.ffprobe },
+    { name: "ffprobe.exe", path: binaryPaths.ffprobe },
-    { name: `deno${addExe}`,    path: binaryPaths.deno },
+    { name: "deno.exe",    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.`
+      `The following files are missing in the 'ressources' folder:\n${list}\n\nThe application will now exit. Try to reinstall.`
     );
     app.quit();
   });

app/discordRPC.js

@@ -1,93 +1,13 @@
 const config = require('../config');
 const RPC = require("discord-rpc");
 const { logger } = require("../server/logger");
-const fs = require("fs");
-const path = require("path");
 
-/**
- * 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;
 
-/**
- * Automagically fixes Discord RPC on Linux for Sandboxed versions (Flatpak & Snap).
- * It creates a symlink from the sandbox IPC socket to the standard system location.
- *
- * @returns {void}
- */
-function fixLinuxDiscordRPC() {
-  // Only execute on Linux
-  if (process.platform !== "linux") return;
-
-  /**
-   * Get the user's runtime directory (e.g., /run/user/1000).
-   * @type {string}
-   */
-  const xdgDir = process.env.XDG_RUNTIME_DIR || `/run/user/${process.getuid()}`;
-  const standardSocket = path.join(xdgDir, "discord-ipc-0");
-
-  // If the standard socket already exists (Native Discord), do nothing.
-  if (fs.existsSync(standardSocket)) return;
-
-  /**
-   * Paths for known sandboxed Discord IPC sockets.
-   */
-  const flatpakSocket = path.join(xdgDir, "app/com.discordapp.Discord/discord-ipc-0");
-  const snapSocket = path.join(xdgDir, "snap.discord/discord-ipc-0");
-
-  let targetSocket = null;
-
-  if (fs.existsSync(flatpakSocket)) {
-    targetSocket = flatpakSocket;
-  } else if (fs.existsSync(snapSocket)) {
-    targetSocket = snapSocket;
-  }
-
-  // If a sandboxed socket is found, create the symlink stealthily.
-  if (targetSocket) {
-    try {
-      fs.symlinkSync(targetSocket, standardSocket);
-      logger.info(`Discord RPC bridge created automatically targeting: ${targetSocket}`);
-    } catch (err) {
-      logger.warn(`Failed to create Discord RPC bridge: ${err.message}`);
-    }
-  }
-}
-
-/**
- * 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() {
-
-  /**
-   * Patch that create Simlinks for Linux environment;
-   */
-  fixLinuxDiscordRPC();
-
-  /**
-   * Rich Presence payload describing current application state
-   * shown in Discord user profile.
-   */
   rpc.on("ready", () => {
     const presence = {
       largeImageKey: "icon",
@@ -97,40 +17,31 @@ function startRPC() {
       details: `Open Source Download Tools - ${config.version}`,
       state: "masteracnolo.github.io/FreedomLoader",
     };
-    rpc.clearActivity();
+    rpc.clearActivity()
     rpc.setActivity(presence);
 
   });
 
-  rpc.login({ clientId }).catch(() => {
+  rpc.login({ clientId }).catch(err => {
-    // Since 1.6.2, it no longer print the error. This is because if discord is not opened, it will send an error.
+    logger.error("Unable to connect to the RPC:", err);
-    // logger.error("Unable to connect to the RPC:", err);
-    logger.info("Unable to connect to the Discord RPC. Discord is maybe not launched");
   });
 }
 
-/**
+async function stopRPC(){
- * Gracefully stops Discord Rich Presence connection.
- *
- * Responsibilities:
- * - Clear any running intervals
- * - Remove current activity from Discord if connected
- * - Destroy RPC transport connection
- * - Handle cleanup errors safely
- */
-async function stopRPC() {
-  if (rpc) {
     try {
       if (intervalId) clearInterval(intervalId);
 
-      await rpc.destroy();
+      if (rpc && rpc.transport) {
-
+        await rpc.clearActivity()
+        await rpc.destroy();
+      } else{
+        logger.error("Not Able to close RPC")
+      }
+      
     } catch (err) {
-      // Since 1.6.2, it no longer print the error. This is because if discord is not opened, it will send an error.
+      logger.error("Error while closing the RPC:", err);
-      // logger.error("Error while closing the RPC:", err);
     }
   }
-}
 
 
 module.exports = { startRPC, stopRPC};

app/ipcHandlers.js

@@ -1,35 +1,15 @@
-/**
- * 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 path = require("path");
 const { logger, logDir } = require("../server/logger");
-const {configFeatures, featuresPath, devMode} = require("../config");
+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");
-const { createSystemTray, destroyTray } = require("./tray");
-const {sendReport} = require("./sendReport");
 
-/**
- * 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",
-  "systemTray",
   "discordRPC",
   "customTopBar",
   "autoCheckInfo",
@@ -37,53 +17,23 @@ const FEATURE_WHITELIST = new Set([
   "addMetadata",
   "verboseLogs",
   "autoDownloadPlaylist",
-  "keepPlaylistOrder",
   "customCodec",
   "theme",
   "createPlaylistFolders",
-  "notifySystem",
+  "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) {
     
-  /**
+  // Infos générales
-   * Returns application version from config.
+  ipcMain.handle("version",  () => config.version);
-   */
-  ipcMain.handle("version", () => config.version);
-
-  /**
-   * Returns runtime feature configuration object.
-   */
   ipcMain.handle("features", () => configFeatures);
 
-  /**
+  // Sélection et validation de dossier
-   * 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) {
@@ -103,131 +53,48 @@ function registerIpcHandlers(getMainWindow) {
   ipcMain.handle("validate-download-path", (_, userPath) => validateDownloadPath(userPath));
   ipcMain.handle("get-default-download-path", () => getDefaultDownloadPath());
 
-  /**
+  // Progression dans la taskbar
-   * Updates Windows/macOS taskbar progress indicator.
-   *
-   * @param {number} percent - Progress value (0–100)
-   */
   ipcMain.on("set-progress", (_, percent) => {
     getMainWindow()?.setProgressBar(percent / 100);
   });
 
-  /**
+  // TOPBAR ACTION
-   * Window minimize request from renderer.
+  ipcMain.on("window-minimize", () => getMainWindow()?.minimize());
-   */
-  ipcMain.on("window-minimize", () => {
-        // Minimize to tray
-        if (configFeatures.systemTray) {
-          getMainWindow()?.hide();
-          logger.info("Window Minimized in SystemTray (Using Minimize Button)");
-        } else {
-          // Native minimize
-          getMainWindow()?.minimize();
-          logger.info("Window minimized normally");
-        }
-      }
-  );
-
-  /**
-   * 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));
 
-  /**
+  
-   * Front end logger
+  
-   */
+  // THEME
-  ipcMain.on("log-error", (_, message) => logger.error(`[Frontend] ${message}`));
-  ipcMain.on("log-info", (_, message) => logger.info(`[Frontend] ${message}`));
-  ipcMain.on("log-warn", (_, message) => logger.warn(`[Frontend] ${message}`));
-
-  /**
-   * 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();
   });
 
-  /**
+  // Modification des features
-   * Send bug report
-   */
-  ipcMain.handle("send-report", async (_, params) => {
-    return await sendReport(params);
-  });
-
-  /**
-   * 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)) {
@@ -239,21 +106,6 @@ function registerIpcHandlers(getMainWindow) {
             return true;
           }
 
-          /**
-           * Dynamically intercepts and applies System Tray state changes at runtime.
-           * Instantiates or destroys the tray icon immediately to prevent window 
-           * lifecycle desynchronization (e.g., minimizing a window to a non-existent tray).
-           */
-          if (key === "systemTray") {
-            if (value === true) {
-              logger.info("System Tray enabled dynamically.");
-              createSystemTray(devMode);
-            } else {
-              logger.info("System Tray disabled dynamically.");
-              destroyTray();
-            }
-          }
-
           configFeatures[key] = value;
 
           fs.writeFileSync(

app/pathValidator.js

@@ -2,84 +2,31 @@ 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 {
-      const absolutePath = path.resolve(userPath);
+    const resolved = fs.realpathSync(path.resolve(userPath));
-
+    if (!isSafePath(resolved)) {
-      if (!fs.existsSync(absolutePath)) {
+      throw new Error("Path not allowed: system folders are blocked!");
-        fs.mkdirSync(absolutePath, { recursive: true });
-        logger.info(`Download folder created: ${absolutePath}`);
-      }
-
-      const real = fs.realpathSync(absolutePath);
-
-      if (!isSafePath(real)) {
-          logger.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}`);
     }
+    return resolved;
+  } catch (err) {
+    logger.error(`Invalid download path: ${userPath} — ${err.message}`);
+    throw new Error(`Invalid or inaccessible path: ${err.message}`);
+  }
 }
 
 module.exports = { validateDownloadPath, getDefaultDownloadPath };

app/sendReport.js

@@ -1,54 +0,0 @@
-const fs = require("fs");
-const path = require("path");
-const {logger, logDir} = require("../server/logger");
-
-async function sendReport(params) {
-    try {
-        const {title, description, includeLogs} = params;
-
-        if (!title || !description) {
-            throw new Error("Title and description are required.");
-        }
-
-        const formData = new FormData();
-        formData.append("title", title);
-        formData.append("context", description);
-
-        if (includeLogs === "yes" && logDir) {
-            // YYYY-MM-DD
-            const today = new Date().toISOString().split("T")[0];
-
-            const logFilePath = path.join(logDir, `LOGS-${today}.log`);
-
-            if (fs.existsSync(logFilePath)) {
-                const logFileContent = fs.readFileSync(logFilePath);
-                const blob = new Blob([logFileContent], {type: "text/plain"});
-                formData.append("file", blob, `LOGS-${today}.log`);
-                logger.info("Logs attached to bug report.");
-            } else {
-                logger.warn(`Log file not found for today: ${logFilePath}`);
-            }
-        }
-
-        const response = await fetch(process.env.BUG_REPORT_URL, {
-            method: "POST",
-            headers: {
-                "X-Api-Key": process.env.BUG_REPORT_API_KEY
-            },
-            body: formData
-        });
-
-        if (!response.ok) {
-            logger.error(`Server returned an error: ${response.status}`);
-            throw new Error(`Server responded with status ${response.status}`);
-        }
-
-        logger.info("Bug report successfully sent.");
-        return true;
-    } catch (err) {
-        logger.error(`Failed to send bug report: ${err.message}`);
-        throw err;
-    }
-}
-
-module.exports = {sendReport};

app/splashManager.js

@@ -1,28 +1,11 @@
 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() {
 
-  /**
+const splashOptions = {
-   * Configuration for splash screen BrowserWindow.
-   * Optimized for minimal UI and fast startup display.
-   */
-  const splashOptions = {
     width: 400,
     height: 300,
     frame: false,
@@ -36,29 +19,13 @@ function createSplashWindow() {
     },
   };
 
-  /**
-   * 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);
 
-  /**
+  // Inject banner path for both dev and packaged app
-   * 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
@@ -69,21 +36,12 @@ function createSplashWindow() {
       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();
@@ -91,13 +49,6 @@ function closeSplashWindow() {
   }
 }
 
-/**
- * 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})`);

app/themeManager.js

@@ -1,48 +1,14 @@
-/**
- * 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"],
@@ -54,25 +20,10 @@ const REQUIRED_KEYS = [
   ["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) {
@@ -82,14 +33,6 @@ function validateThemeJson(json) {
   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(),
@@ -102,17 +45,6 @@ function buildThemeObject(themeId, themeJson, 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`);
@@ -123,20 +55,6 @@ function extractImage(buffer, filename) {
   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);
@@ -173,15 +91,6 @@ async function loadThemeFromZip(zipPath, themeId) {
   }
 }
 
-/**
- * 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"));
@@ -215,38 +124,13 @@ async function loadThemeFromFolder(folderPath, themeId) {
   }
 }
 
-/**
- * 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 = [];
 
@@ -270,37 +154,18 @@ async function loadThemesFromFolder() {
     if (fs.statSync(filePath).isDirectory()) {
       const theme = await loadThemeFromFolder(filePath, themeId);
       if (theme) themes.push(theme);
+      continue;
     }
   }
 
   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();
@@ -309,24 +174,10 @@ async function initThemes(folderPath) {
   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));

app/tray.js

@@ -1,117 +0,0 @@
-const {app, Menu, Tray, nativeImage} = require("electron");
-const path = require("path");
-const {logger} = require("../server/logger"); // Ajuste le chemin si besoin
-const fs = require("fs");
-const {getMainWindow} = require("./windowManager");
-
-/**
- * Global reference to the Tray instance to prevent garbage collection.
- * @type {Tray | null}
- */
-let tray = null;
-
-/**
- * Creates and configures the cross-platform System Tray.
- *
- * Responsibilities:
- * - Loads the appropriate icon format based on the operating system.
- * - Builds the right-click context menu.
- * - Handles left-click behavior to toggle main window visibility.
- *
- * @param {boolean} devMode - Indicates whether the application is running in development mode.
- * @returns {Tray} The created Tray instance.
- */
-function createSystemTray(devMode) {
-    // Prevent creating multiple tray instances
-    if (tray) return tray;
-
-    const isWin = process.platform === "win32";
-    const iconName = isWin ? "app-icon.ico" : "app-icon-64x64.png"; 
-
-    // Attempt to load the icon from the local build directory first
-    let iconPath = path.join(__dirname, "..", "build", iconName);
-
-    // Fallback to the extracted resources path if running in production
-    if (!devMode && !fs.existsSync(iconPath)) {
-        iconPath = path.join(process.resourcesPath, iconName);
-    }
-
-    if (!fs.existsSync(iconPath)) {
-        logger.error(`System Tray icon not found at resolved path: ${iconPath}`);
-    } else {
-        logger.info("System Tray icon resolved successfully.");
-    }
-    
-    const icon = nativeImage.createFromPath(iconPath);    
-
-    if (icon.isEmpty()) {
-        logger.error("System Tray icon file was found but could not be decoded by Electron (image is empty).");
-    }
-
-    tray = new Tray(icon);
-    tray.setToolTip("Freedom Loader");
-
-    /**
-     * System Tray Context Menu (Right-click action).
-     */
-    const contextMenu = Menu.buildFromTemplate([
-        {
-            label: "Show Freedom Loader",
-            click: () => {
-                const window = getMainWindow();
-                if (window && !window.isDestroyed()) {
-                    window.show();
-                    window.focus();
-                    logger.info("Window Restored from SystemTray (Using Show Action)");
-                }
-            },
-        },
-        { type: "separator" },
-        {
-            label: "Quit",
-            click: () => {
-                /**
-                 * Flags the application for a deliberate exit,
-                 * bypassing the default "minimize to tray" behavior.
-                 */
-                app.isQuitting = true;
-                app.quit();
-            },
-        },
-    ]);
-
-    tray.setContextMenu(contextMenu);
-
-    /**
-     * Left-click behavior: Toggles main window visibility.
-     * but it remains standard practice for Windows and Linux environments.
-     */
-    tray.on("click", () => {
-        const window = getMainWindow();
-        if (!window || window.isDestroyed()) return;
-
-        if (window.isVisible()) {
-            window.hide();
-        } else {
-            window.show();
-            window.focus();
-            logger.info("Window Restored from SystemTray (Double Click on Tray Icon)");
-        }
-    });
-
-    return tray;
-}
-
-/**
- * Safely destroys the tray icon to prevent OS-level crashes (especially on Linux/Wayland).
- * Should be called right before the application quits.
- */
-function destroyTray() {
-    if (tray && !tray.isDestroyed()) {
-        tray.destroy();
-        tray = null;
-        logger.info("System Tray destroyed cleanly.");
-    }
-}
-
-module.exports = {createSystemTray, destroyTray};

app/windowManager.js

@@ -1,55 +1,21 @@
-/**
- * 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;
   }
 
-  /**
+  const iconPath = config.localMode
-   * 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,
@@ -69,10 +35,6 @@ async function createMainWindow() {
 
   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");
@@ -81,25 +43,6 @@ async function createMainWindow() {
     throw err;
   }
 
-  /**
-   * Intercepts the window close event.
-   * If the app is not explicitly quitting (via Tray menu),
-   * cancels the destruction and hides the window instead.
-   */
-  mainWindow.on('close', (event) => {
-
-    if (!app.isQuitting && config.configFeatures.systemTray) {
-      event.preventDefault();
-      mainWindow.hide();
-      logger.info("Window Minimized in SystemTray (Using Close Button)");
-      return false;
-    }
-  });
-
-  /**
-   * 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;
@@ -108,14 +51,6 @@ async function createMainWindow() {
   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;
 }

app/ytDlpUpdater.js

@@ -1,33 +1,10 @@
 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()}`);
   });
 }

config.js

@@ -3,129 +3,41 @@ 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 || process.env.NODE_ENV === "test";
 
-/**
- * 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) {
+  if (localMode) {
     const devConfigPath = path.join(__dirname, "config", "config.dev.json");
-
     if (!fs.existsSync(devConfigPath)) {
-      const defaultConfigPath = path.join(
+      const defaultConfigPath = path.join(__dirname, "config", "config.default.json");
-        __dirname,
-        "config",
-        "config.default.json"
-      );
       fs.copyFileSync(defaultConfigPath, devConfigPath);
     }
-
     return devConfigPath;
   }
 
   const userConfigPath = path.join(app.getPath("userData"), "config.json");
-
   if (!fs.existsSync(userConfigPath)) {
-    const defaultConfigPath = path.join(
+    const defaultConfigPath = path.join(process.resourcesPath, "config", "config.default.json");
-      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);
 }
 
-/**
+const configFeatures = loadFeatures();
- * 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.
- */
-let configFeatures = loadFeatures();
 
 module.exports = {
-  /**
+  version: packageJson.version,
-   * Application version from package.json
-   */
-  version: devMode ? `dev-${packageJson.version}` : `v${packageJson.version}` ,
-
-  /**
-   * Backend Express / internal server port
-   */
   applicationPort: "8787",
-
+  localMode,
-  /**
-   * Indicates whether the app is running in development mode
-   */
-  devMode,
-
-  /**
-   * Discord RPC application identifier
-   */
   DiscordRPCID: "1410934537051181146",
-
-  /**
-   * Runtime feature flags loaded from configuration file
-   */
   configFeatures,
-
+  featuresPath
-  /**
+}
-   * Function to reload the config
-   */
-  reloadFeatures,
-
-  /**
-   * Path to the active configuration file
-   */
-  featuresPath,
-};

config/config.default.json

@@ -1,6 +1,5 @@
 {
   "autoUpdate": true,
-  "systemTray": false,
   "discordRPC": true,
   "customTopBar": true,
   "autoCheckInfo": true,
@@ -8,13 +7,11 @@
   "addMetadata": true,
   "verboseLogs": false,
   "autoDownloadPlaylist": true,
-  "keepPlaylistOrder": false,
+  "createPlaylistFolders": true,
-  "createPlaylistFolders": false,
   "customCodec": "h264",
   "logSystem": true,
   "outputTitleCheck": true,
   "downloadSystem": true,
   "notifySystem": true,
-  "enableHardwareAcceleration": true,
   "theme": "dark" 
 }

eslint.config.js

@@ -1,40 +0,0 @@
-const js = require("@eslint/js");
-const globals = require("globals");
-
-module.exports = [
-    js.configs.recommended,
-
-    {ignores: ["node_modules/**", "srpm-out/**", "dist/**", "test/**"]},
-
-    {
-        languageOptions: {
-            ecmaVersion: "latest",
-            sourceType: "commonjs",
-        },
-        rules: {
-            "no-unused-vars": ["error", {argsIgnorePattern: "^_"}],
-            "no-console": "off",
-            "semi": ["error", "always"]
-        },
-
-
-    },
-    {
-        files: ["app/**", "server/**", "main.js"],
-        languageOptions: {
-            globals: {...globals.node}
-        }
-    },
-    {
-        files: ["public/**"],
-        languageOptions: {
-            globals: {...globals.browser}
-        }
-    },
-    {
-        files: ["preload.js"],
-        languageOptions: {
-            globals: {...globals.node, ...globals.browser}
-        }
-    }
-];

jest.config.js

@@ -1,21 +0,0 @@
-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

@@ -1,8 +1,3 @@
-/**
- * Handle crash application and avoid ghost instance
- */
-const { app } = require("electron");
-
 process.on("uncaughtException", (err) => {
   console.error("Uncaught exception:", err);
   app.quit();
@@ -13,134 +8,44 @@ process.on("unhandledRejection", (reason) => {
   app.quit();
 });
 
+const { app } = require("electron");
+const { createSplashWindow, closeSplashWindow, setSplashProgress } = require("./app/splashManager");
+const path = require("path");
 
-/**
+const { logger, logSessionStart, logSessionEnd } = require("./server/logger");
- * True if this is the primary instance (lock acquired successfully)
- */
-const isPrimaryInstance = app.requestSingleInstanceLock();
-
-/**
- * If we are on a second instance
- */
-if (!isPrimaryInstance) {
-  app.quit();
-  process.exit(0);
-}
-
-/**
- * Set App Name and AppID 
- */
-app.setName("Freedom Loader");
-app.setAppUserModelId("com.masteracnolo.freedomloader");
-
-
-/**
- * Load the app dependencies for hardware choice
- */
-const { logger, logSessionStart, logSessionEnd, logDir } = require("./server/logger");
-const { configFeatures, devMode} = require("./config");
-
-/**
- * In-memory snapshot of application feature flags.
- *
- * Note: Changes to the config file are not automatically reflected.
- * A restart could be required.
- */
-if (!configFeatures.enableHardwareAcceleration){
-  app.disableHardwareAcceleration();
-  logger.info("Disabled Hardware Acceleration");
-} else {
-  logger.info("Enable Hardware Acceleration");
-}
-
-if(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");
-
 const { initAutoUpdater } = require("./app/autoUpdater");
 const { startRPC, stopRPC } = require("./app/discordRPC");
+
+const { configFeatures } = require("./config");
+const config = require("./config");
+const { initThemes } = require("./app/themeManager");
+
 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 } = require("./server/helpers/path.helpers");
-const { userThemesPath, initUserThemes, validateBinaries, defaultDownloadFolder } = require("./server/helpers/path.helpers");
-const {createSystemTray, destroyTray} = require("./app/tray");
-const { stopServer } = require("./server/server");
 
-/**
+app.setName("Freedom Loader");
- * Expose .env in process.env
+app.setAppUserModelId("com.masteracnolo.freedomloader");
- */
+app.disableHardwareAcceleration();
-require("dotenv").config();
 
-/**
+if (!config.localMode) {
- * Global flag indicating if the application is intentionally shutting down.
+  const gotLock = app.requestSingleInstanceLock();
- * Used across the app to bypass the "minimize to tray on close" behavior.
+  if (gotLock) {
- * @type {boolean}
+    app.on("second-instance", () => {
- */
+      logger.info("New instance detected, closing older...");
-app.isQuitting = false;
+      getMainWindow()?.destroy();
-
+    });
-/**
- * State flag to track the asynchronous cleanup process during shutdown.
- * Prevents the application from exiting before services (RPC, Tray, Logs) are properly closed.
- * @type {boolean}
- */
-let isCleanedUp = false;
-
-/**
- * Performs a graceful shutdown of all application services asynchronously.
- * Once finished, it re-triggers the app.quit() process.
- */
-async function cleanShutdown() {
-  try {
-    destroyTray();
-    await stopRPC();
-    stopServer(); 
-
-  } catch (err) {
-    logger.error("Error during cleanup:", err);
-
-  } finally {
-    logger.info("All services stopped. Have a nice day!");
-    logSessionEnd();
-    
-    isCleanedUp = true;
-    app.quit();
   }
 }
 
-/**
- * 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();
-});
-
 app.whenReady().then(async () => {
-  logSessionStart(logDir, defaultDownloadFolder);
+  logSessionStart();
 
   createSplashWindow();
 
-  if (!devMode && !checkNativeDependencies()) return;
+  if (!config.localMode && !checkNativeDependencies()) return;
 
   const { userYtDlp } = require("./server/helpers/path.helpers");
   updateYtDlp(userYtDlp);
@@ -153,22 +58,16 @@ app.whenReady().then(async () => {
     registerIpcHandlers(getMainWindow);
 
     setSplashProgress(2); // Loading themes
-
-    validateBinaries();
-
     initUserThemes();
-    await initThemes(userThemesPath);
+    await initThemes(userThemesPath); 
 
     setSplashProgress(3); // Almost ready
     await createMainWindow();
+
+    await new Promise(resolve => setTimeout(resolve, 2000));
     
     closeSplashWindow();
     getMainWindow().show();
-
-    if (configFeatures.systemTray) {
-      createSystemTray(devMode);
-    }
-
     if (configFeatures.discordRPC) startRPC();
 
     if (configFeatures.autoUpdate) initAutoUpdater(getMainWindow());
@@ -180,20 +79,12 @@ app.whenReady().then(async () => {
 });
 
 app.on("window-all-closed", () => {
-  if (app.isQuitting || !configFeatures.systemTray) {
+  logger.info("Shutting down...");
-    logger.info("Shutting down...");
+  app.quit();
-    app.quit();
-  } else if (process.platform !== "darwin") {
-    logger.info("Main window closed, app running in background (Tray).");
-  }
 });
 
-app.on("before-quit", (event) => {
+app.on("before-quit", async () => {
-  app.isQuitting = true;
+  await stopRPC();
-
+  logger.info("All services stopped. Have a nice day!");
-  if (!isCleanedUp) {
+  logSessionEnd();
-    event.preventDefault(); 
-
-    cleanShutdown();
-  }
 });

package.json

@@ -1,46 +1,19 @@
 {
   "name": "freedom-loader",
-  "desktopName": "com.masteracnolo.freedomloader",
   "productName": "Freedom Loader",
-  "version": "1.6.4-preview",
+  "version": "1.5.0",
-  "author": "MasterAcnolo <MasterAcnolo@users.noreply.github.com>",
+  "author": "MasterAcnolo",
-  "description": "Free and open-source GUI for yt-dlp — download video and audio from hundreds of platforms",
+  "description": "Freedom Loader",
-  "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 --no-warnings .",
+    "start": "electron --trace-warnings .",
-    "start:warn": "electron --trace-warnings .",
-    "start:debug": "WAYLAND_DEBUG=1 ELECTRON_ENABLE_LOGGING=1 ELECTRON_ENABLE_STACK_DUMPING=1 electron --enable-logging --v=1 .",
-    "dev": "nodemon --watch server --watch app --watch main.js --watch config.js --ext js,json --exec \"electron --no-warnings .\"",
-    "dev:warn": "nodemon --watch server --watch app --watch main.js --watch config.js --ext js,json --exec \"electron --trace-warnings .\"",
-    "dev:debug": "nodemon --watch server --watch app --watch main.js --watch config.js --ext js,json --exec \"WAYLAND_DEBUG=1 ELECTRON_ENABLE_LOGGING=1 ELECTRON_ENABLE_STACK_DUMPING=1 electron --enable-logging --v=1 .\"",
     "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",
-    "lint": "eslint . --format pretty",
-    "lint:fix": "eslint . --fix --format pretty",
     "update": "npm update"
   },
   "dependencies": {
     "chalk": "^4.1.2",
     "debug": "^4.4.1",
     "discord-rpc": "^4.0.1",
-    "dotenv": "^17.4.2",
     "electron-updater": "^6.6.2",
     "express": "^5.1.0",
     "express-rate-limit": "^8.2.1",
@@ -50,18 +23,8 @@
     "winston-daily-rotate-file": "^5.0.0"
   },
   "devDependencies": {
-    "@electron/devtron": "^2.1.1",
+    "electron": "^41.2.0",
-    "@eslint/js": "^10.0.1",
+    "electron-builder": "^26.8.1"
-    "@jest/globals": "^30.4.1",
-    "@playwright/test": "^1.62.1",
-    "electron": "^44.3.0",
-    "electron-builder": "^26.15.3",
-    "eslint": "^10.10.0",
-    "eslint-formatter-pretty": "^7.1.0",
-    "globals": "^17.12.0",
-    "jest": "^30.4.2",
-    "nodemon": "^3.1.14",
-    "playwright": "^1.62.1"
   },
   "build": {
     "appId": "com.masteracnolo.freedomloader",
@@ -70,8 +33,7 @@
       {
         "provider": "github",
         "owner": "MasterAcnolo",
-        "repo": "Freedom-Loader",
+        "repo": "Freedom-Loader"
-        "releaseType": "draft"
       }
     ],
     "files": [
@@ -90,38 +52,49 @@
         "to": "theme"
       },
       {
-        "from": "config/config.default.json",
+        "from": "build/confirm-icon.png",
-        "to": "config/config.default.json"
+        "to": "confirm-icon.png"
       },
       {
-        "from": "build",
+        "from": "build/app-icon.ico",
-        "to": ".",
+        "to": "app-icon.ico"
-        "filter": [
+      },
-          "app-icon.ico",
+      {
-          "app-icon-64x64.png",
+        "from": "build/banner.bmp",
-          "confirm-icon.png",
+        "to": "banner.bmp"
-          "banner.bmp",
+      },
-          "banner.png",
+      {
-          "error.png"
+        "from": "build/banner.png",
-        ]
+        "to": "banner.png"
+      },
+      {
+        "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.default.json",
+        "to": "config/config.default.json"
       }
     ],
     "win": {
       "target": "nsis",
-      "icon": "build/app-icon.ico",
+      "icon": "build/app-icon.ico"
-      "artifactName": "Freedom-Loader-Setup-${version}.${ext}",
-      "extraResources": [
-        {
-          "from": "resources/binaries/win-32",
-          "to": "binaries",
-          "filter": [
-            "yt-dlp.exe",
-            "ffmpeg.exe",
-            "ffprobe.exe",
-            "deno.exe"
-          ]
-        }
-      ]
     },
     "nsis": {
       "oneClick": false,
@@ -133,47 +106,6 @@
       "createDesktopShortcut": true,
       "createStartMenuShortcut": true,
       "shortcutName": "Freedom Loader"
-    },
-    "linux": {
-      "target": [
-        "AppImage",
-        "deb",
-        "snap"
-      ],
-      "category": "Utility",
-      "synopsis": "GUI for yt-dlp to download video and audio with metadata",
-      "maintainer": "MasterAcnolo",
-      "icon": "build/app-icon.png",
-      "executableName": "freedom-loader",
-      "extraResources": [
-        {
-          "from": "resources/binaries/linux",
-          "to": "binaries",
-          "filter": [
-            "yt-dlp",
-            "ffmpeg",
-            "ffprobe",
-            "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

@@ -1,73 +0,0 @@
-<?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

@@ -1,9 +0,0 @@
-#!/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

@@ -1,25 +0,0 @@
-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

preload.js

@@ -1,158 +1,27 @@
 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", {
-
-  /**
-   * Sends error log message.
-   *
-   * @param {...any} args - Values to log
-   */
-  logError: (...args) => ipcRenderer.send("log-error", args.map(arg => typeof arg === "object" ? JSON.stringify(arg) : arg).join(" ")),
-
-  /**
-   * Sends info log message.
-   *
-   * @param {...any} args - Values to log
-   */
-  logInfo: (...args) => ipcRenderer.send("log-info", args.map(arg => typeof arg === "object" ? JSON.stringify(arg) : arg).join(" ")),
-
-  /**
-   * Sends warning log message.
-   *
-   * @param {...any} args - Values to log
-   */
-  logWarn: (...args) => ipcRenderer.send("log-warn", args.map(arg => typeof arg === "object" ? JSON.stringify(arg) : arg).join(" ")),
-
-  /**
-   * Send Bug Report
-   *
-   * @param params
-   * @returns {Promise<any>}
-   */
-  sendReport: (params) => ipcRenderer.invoke('send-report', params),
-
-  /**
-   * 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"),
-
+  reloadThemes: () => ipcRenderer.invoke("reload-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"),
-
-  /**
-   * Opens the workshop or external content library.
-   */
   openWorkshop: () => ipcRenderer.send("open-workshop"),
-
+  openConfig: () => ipcRenderer.send("open-config")
-  /**
+});
-   * Opens configuration/settings panel.
-   */
-  openConfig: () => ipcRenderer.send("open-config"),
-});

public/index.html

@@ -13,7 +13,6 @@
     <link rel="stylesheet" href="styles/styles.css">
     <link rel="stylesheet" href="styles/layout/topbar.css">
     
-    <link href="https://fonts.googleapis.com/icon?family=Material+Icons+Round" rel="stylesheet">
 </head>
 <body>
 
@@ -22,7 +21,6 @@
             <div class="custom-controls">
                 <button id="devtools-btn" title="Dev Tools">Tools</button>
                 <button id="logs-btn" title="Logs">Logs</button>
-                <button id="report-bug-btn" title="Report a bug">Report a Bug</button> <!-- TODO: Find a better place -->
                 <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>
@@ -58,9 +56,9 @@
                 <div class="setting-item" id="theme" style="margin-left: 32px;">
                     <div class="setting-info">
                         <div style="display: flex; align-items: center; gap: 10px;">
-                        <span class="setting-title">Theme</span>
+                        <span class="setting-title">Thème</span>
 
-                        <select id="themeSelect" data-key="theme" aria-label="Choose the theme">
+                        <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">
@@ -108,10 +106,10 @@
                 </div>
 
                 <div class="setting-item">
-                    <input data-key="keepPlaylistOrder" id="keepPlaylistOrder" type="checkbox">
+                    <input type="checkbox" data-key="autoCheckInfo" id="autoCheckInfo">
                     <div class="setting-info">
-                        <span class="setting-title">Keep Playlist Order</span>
+                    <span class="setting-title">Auto Fetch Info</span>
-                        <small>Add index before output file, to keep the order.</small>
+                    <small>Automatically fetch information for new downloads.</small>
                     </div>
                 </div>
             </div>
@@ -129,31 +127,15 @@
                     </div>
                 </div>
 
-                    <div class="setting-item">
+                <!-- <div class="setting-item">
-                        <input data-key="systemTray" id="systemTray" type="checkbox">
+                    <input type="checkbox" data-key="outputTitleCheck" id="outputTitleCheck">
-                        <div class="setting-info">
+                    <div class="setting-info">
-                            <span class="setting-title">System Tray</span>
+                    <span class="setting-title">Output title (special chars)</span>
-                            <small>Minimize app on close, in the System Tray. [EXPERIMENTAL]</small>
+                    <small>Check for unusual characters in output titles.</small>
-                        </div>
                     </div>
+                </div> -->
 
-                    <!-- <div class="setting-item">
+                <div class="setting-item">
-                        <input type="checkbox" data-key="outputTitleCheck" id="outputTitleCheck">
-                        <div class="setting-info">
-                        <span class="setting-title">Output title (special chars)</span>
-                        <small>Check for unusual characters in output titles.</small>
-                        </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">
                     <span class="setting-title">Add Metadata</span>
@@ -193,20 +175,28 @@
                     </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">
@@ -264,7 +254,7 @@
             </div>
 
             <div class="download-path">
-                Will be saved in <span id="savePath"></span>
+                    Will be save on <span id="savePath"></span> 
                     <button id="changePath">Edit</button>
             </div>
 
@@ -297,6 +287,7 @@
 
             <span id="version-badge" class="version-badge"></span>
 
+        </div>
     </main>
 
     <!-- Toast Container -->
@@ -315,7 +306,6 @@
     <script src="script/fetchinfo.js"></script>
     <script src="script/progressBar.js"></script>
     <script src="script/customthemes.js"></script>
-    <script src="script/reportBug.js"></script>
     <script type="module" src="script/topbar.js"></script>
 
 </body>

public/script/appVersion.js

@@ -1,54 +1,8 @@
-/**
+async function versionLabel(){
- * Retrieves the application version and build state from the backend.
+    const appVersion = await window.electronAPI.getVersion();
- * Displays a formatted string indicating packaging state and preview status.
- * Hides the "Packaged" state for production builds to keep the UI clean.
- *
- * Example outputs: "Not Packaged Preview v1.6.2" or "Preview v1.6.2"
- *
- * @returns {Promise<void>}
- */
-async function displayVersionLabel() {
-  /**
-   * Raw version string from the backend (e.g., "dev-1.6.2-preview" or "v1.6.2")
-   * @type {string}
-   */
-  const appVersion = await window.electronAPI.getVersion();
 
-  /**
+    // Write in front the app version for debugging (bottom right)
-   * UI element displaying the current application version.
+    document.getElementById("version-badge").textContent = `v${appVersion}`;
-   * @type {HTMLElement | null}
+};
-   */
-  const versionBadge = document.getElementById("version-badge");
 
-  if (!versionBadge) return;
+versionLabel();
-
-  /**
-   * Extracts the numeric semantic version (e.g., "1.6.2").
-   * @type {RegExpMatchArray | null}
-   */
-  const versionMatch = appVersion.match(/(\d+\.\d+\.\d+)/);
-  const baseVersion = versionMatch ? versionMatch[0] : "Unknown";
-
-  /**
-   * Determines the packaging state. The backend prepends "dev-" if unpackaged.
-   * @type {boolean}
-   */
-  const isPackaged = !appVersion.includes("dev-");
-
-  /**
-   * Determines if the current build is a preview version.
-   * @type {boolean}
-   */
-  const isPreview = appVersion.includes("preview");
-
-  /**
-   * Construct the final display string.
-   * If packaged, we don't mention it. If not, we explicitly say "Not Packaged ".
-   */
-  const packageStateStr = isPackaged ? "" : "Not Packaged ";
-  const previewStr = isPreview ? "Preview " : "";
-
-  versionBadge.textContent = `${packageStateStr}${previewStr}v${baseVersion}`;
-}
-
-displayVersionLabel();

public/script/clipboardPaste.js

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

public/script/custompath.js

@@ -1,24 +1,9 @@
-/**
- * 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";
@@ -27,17 +12,6 @@ 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; 
@@ -45,14 +19,6 @@ window.addEventListener("DOMContentLoaded", async () => {
     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");
@@ -76,16 +42,13 @@ window.addEventListener("DOMContentLoaded", async () => {
 
   await loadInitialPath();
 
-  /**
+  document
-   * Opens system folder selector and updates download path.
+    .getElementById("changePath")
-   *
+    .addEventListener("click", async () => {
-   * 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,22 +1,6 @@
 const themeSelect = document.getElementById("themeSelect");
-/**
- * Currently selected themes loaded from backend.
- * Used as cache for UI theme switching.
- */
 let loadedThemes = [];
 
-/**
- * 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;
@@ -31,75 +15,72 @@ function applyTheme(theme) {
     document.body.style.backgroundImage = "";
   }
 
-  // CSS variables (design tokens)
+  // Colors
-  root.style.setProperty("--background-color", style.colors?.background || "#121212");
+  root.style.setProperty("--background-color",          style.colors?.background || "");
-  root.style.setProperty("--default-text-color", style.colors?.text?.default || "#e0e0e0");
+  root.style.setProperty("--default-text-color",        style.colors?.text?.default || "");
-  root.style.setProperty("--subtitle-color", style.colors?.text?.subtitle || "#2196f3");
+  root.style.setProperty("--subtitle-color",            style.colors?.text?.subtitle || "");
-  root.style.setProperty("--audio-only-label-color", style.colors?.text?.audioOnly || "#f5f5f5");
+  root.style.setProperty("--audio-only-label-color",    style.colors?.text?.audioOnly || "");
 
-  root.style.setProperty("--form-bg-color", style.form?.background || "#1e1e1e");
+  // Form
-  root.style.setProperty("--form-input-bg-color", style.form?.input?.background || "#2a2a2a");
+  root.style.setProperty("--form-bg-color",                   style.form?.background || "");
-  root.style.setProperty("--form-input-border-color", style.form?.input?.border || "#444444");
+  root.style.setProperty("--form-input-bg-color",             style.form?.input?.background || "");
-  root.style.setProperty("--form-input-border-focus-color", style.form?.input?.borderFocus || "#2196f3");
+  root.style.setProperty("--form-input-border-color",         style.form?.input?.border || "");
-  root.style.setProperty("--form-input-text-color", style.form?.input?.text || "#f5f5f5");
+  root.style.setProperty("--form-input-border-focus-color",   style.form?.input?.borderFocus || "");
-  root.style.setProperty("--form-input-placeholder-color", style.form?.input?.placeholder || "#888888");
+  root.style.setProperty("--form-input-text-color",           style.form?.input?.text || "");
-  root.style.setProperty("--form-button-bg-color", style.form?.button?.background || "#2196f3");
+  root.style.setProperty("--form-input-placeholder-color",    style.form?.input?.placeholder || "");
-  root.style.setProperty("--form-button-text-color", style.form?.button?.text || "#ffffff");
+  root.style.setProperty("--form-button-bg-color",            style.form?.button?.background || "");
-  root.style.setProperty("--form-button-bg-hover-color", style.form?.button?.hover || "#1976d2");
+  root.style.setProperty("--form-button-text-color",          style.form?.button?.text || "");
-  root.style.setProperty("--paste-button-icon-color", style.form?.pasteButtonIcon || "#ffffff");
+  root.style.setProperty("--form-button-bg-hover-color",      style.form?.button?.hover || "");
+  root.style.setProperty("--paste-button-icon-color",         style.form?.pasteButtonIcon || "");
 
-  root.style.setProperty("--checkbox-unchecked-bg-color", style.checkbox?.background?.unchecked || "#555555");
+  // Checkbox
-  root.style.setProperty("--checkbox-checked-bg-color", style.checkbox?.background?.checked || "#2196f3");
+  root.style.setProperty("--checkbox-unchecked-bg-color",       style.checkbox?.background?.unchecked || "");
-  root.style.setProperty("--checkbox-checkmark-border-color", style.checkbox?.checkmarkBorder || "#ffffff");
+  root.style.setProperty("--checkbox-checked-bg-color",         style.checkbox?.background?.checked || "");
-  root.style.setProperty("--checkbox-pulse-color", style.checkbox?.pulse || "rgba(33, 150, 243, 0.5)");
+  root.style.setProperty("--checkbox-checkmark-border-color",   style.checkbox?.checkmarkBorder || "");
+  root.style.setProperty("--checkbox-pulse-color",              style.checkbox?.pulse || "");
 
-  root.style.setProperty("--download-status-color", style.download?.status || "#2196f3");
+  // Download
+  root.style.setProperty("--download-status-color", style.download?.status || "");
 
-  root.style.setProperty("--progress-bar-bg-color", style.progressBar?.background || "#444444");
+  // Progress bar
-  root.style.setProperty("--progress-bar-fill-color", style.progressBar?.fill || "#2196f3");
+  root.style.setProperty("--progress-bar-bg-color",   style.progressBar?.background || "");
+  root.style.setProperty("--progress-bar-fill-color", style.progressBar?.fill || "");
 
-  root.style.setProperty("--video-info-bg-color", style.videoInfo?.background || "#1a1a1a");
+  // Video info
-  root.style.setProperty("--video-info-text-color", style.videoInfo?.text || "#e0e0e0");
+  root.style.setProperty("--video-info-bg-color",          style.videoInfo?.background || "");
-  root.style.setProperty("--video-info-heading-color", style.videoInfo?.heading || "#2196f3");
+  root.style.setProperty("--video-info-text-color",        style.videoInfo?.text || "");
-  root.style.setProperty("--video-info-list-color", style.videoInfo?.list || "#cccccc");
+  root.style.setProperty("--video-info-heading-color",     style.videoInfo?.heading || "");
-  root.style.setProperty("--video-info-list-strong-color", style.videoInfo?.strong || "#ffffff");
+  root.style.setProperty("--video-info-list-color",        style.videoInfo?.list || "");
-  root.style.setProperty("--video-info-link-color", style.videoInfo?.link || "#2196f3");
+  root.style.setProperty("--video-info-list-strong-color", style.videoInfo?.strong || "");
-  root.style.setProperty("--video-info-link-hover-color", style.videoInfo?.linkHover || "#1976d2");
+  root.style.setProperty("--video-info-link-color",        style.videoInfo?.link || "");
+  root.style.setProperty("--video-info-link-hover-color",  style.videoInfo?.linkHover || "");
 
-  root.style.setProperty("--playlist-background-color", style.playlist?.background || "#303030");
+  // Playlist
+  root.style.setProperty("--playlist-background-color", style.playlist?.background || "");
 
-  root.style.setProperty("--settings-button-bg-color", style.settings?.button?.background || "#1e1e1e");
+  // Settings
-  root.style.setProperty("--settings-button-text-color", style.settings?.button?.text || "#e0e0e0");
+  root.style.setProperty("--settings-button-bg-color",      style.settings?.button?.background || "");
-  root.style.setProperty("--open-theme-button-bg-color", style.settings?.openThemeButton?.background || "#2196f3");
+  root.style.setProperty("--settings-button-text-color",    style.settings?.button?.text || "");
-  root.style.setProperty("--open-theme-button-text-color", style.settings?.openThemeButton?.text || "#ffffff");
+  root.style.setProperty("--open-theme-button-bg-color",    style.settings?.openThemeButton?.background || "");
-  root.style.setProperty("--open-json-button-bg-color", style.settings?.openJsonButton?.background || style.settings?.button?.background || "#1e1e1e");
+  root.style.setProperty("--open-theme-button-text-color",  style.settings?.openThemeButton?.text || "");
-  root.style.setProperty("--open-json-button-text-color", style.settings?.openJsonButton?.text || style.settings?.button?.text || "#e0e0e0");
+  root.style.setProperty("--open-json-button-bg-color",     style.settings?.openJsonButton?.background || style.settings?.button?.background || "");
-  root.style.setProperty("--settings-modal-bg-color", style.settings?.background?.modal || "#1e1e1e");
+  root.style.setProperty("--open-json-button-text-color",   style.settings?.openJsonButton?.text || style.settings?.button?.text || "");
-  root.style.setProperty("--settings-section-bg-color", style.settings?.background?.section || "#2a2a2a");
+  root.style.setProperty("--settings-modal-bg-color",       style.settings?.background?.modal || "");
-  root.style.setProperty("--settings-text-color", style.settings?.text || "#e0e0e0");
+  root.style.setProperty("--settings-section-bg-color",     style.settings?.background?.section || "");
-  root.style.setProperty("--settings-subtitle-color", style.settings?.subtitle || "#aaaaaa");
+  root.style.setProperty("--settings-text-color",           style.settings?.text || "");
+  root.style.setProperty("--settings-subtitle-color",       style.settings?.subtitle || "");
 
+  // Subtitle
   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 = theme.id;
@@ -108,143 +89,35 @@ function populateThemeSelect(themes) {
   }
 }
 
-/**
- * Initializes theme system:
- * - loads themes from backend
- * - restores saved theme
- * - applies selected theme
- */
 async function initThemes() {
   loadedThemes = await window.electronAPI.getThemes();
 
-  if (!loadedThemes.length) {
+  if (!loadedThemes.length) return;
-    const defaultTheme = {
-      id: "dark",
-      name: "Dark",
-      subtitle: "Because Why Not ?",
-      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);
 }
 
-/**
- * Handles theme selection change from UI dropdown.
- */
 themeSelect.addEventListener("change", (e) => {
   const theme = loadedThemes.find(t => t.id === e.target.value);
-  if (!theme) return;
+  if (theme) {
-
+    applyTheme(theme);
-  applyTheme(theme);
+    saveTheme(theme.id);
-  saveTheme(theme.id);
+  }
 });
 
-/**
- * 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;

public/script/downloadstatus.js

@@ -2,35 +2,9 @@ const form = document.getElementById("downloadForm");
 const statusDiv = document.getElementById("downloadStatus");
 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();
   
@@ -87,13 +61,6 @@ form.addEventListener("submit", async (e) => {
   }
 });
 
-/**
- * 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");
@@ -117,14 +84,6 @@ function showInitialProgress() {
   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;
 
@@ -150,12 +109,6 @@ async function stopDownload() {
   }
 }
 
-/**
- * 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";

public/script/fetchinfo.js

@@ -1,44 +1,23 @@
-/**
- * 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?url=${encodeURIComponent(url)}`, {
+    const res = await fetch("/info", {
-      method: "GET",
+      method: "POST",
-      headers: {"Accept": "application/json"}
+      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+      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;
@@ -47,19 +26,9 @@ 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");
@@ -269,8 +238,8 @@ async function init() {
       infoDiv.classList.add("visible");
     });
 
-  });
+  })
 
-}
+};
 
 init();

public/script/progressBar.js

@@ -1,65 +1,40 @@
-/**
- * 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() {
   progressBar.style.width = "0%";
   progressBarText.innerHTML = "0%";
   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";
 
+  // Show stop button
   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) {
+  // Show progress div and stop button only when percent > 0
   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 = "";
@@ -75,19 +50,13 @@ function resetProgress() {
   playlistInfoElement.textContent = "";
   playlistInfoElement.style.display = "none";
 
+  // Hide stop button
   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();
@@ -96,41 +65,34 @@ evtSource.onmessage = e => {
   }
 
   if (e.data === "done") {
+    // Keep progress bar visible for better UX, let toast handle the feedback
     setTimeout(() => {
       resetProgress();
-      window.electronAPI.setProgress(-1);
+      window.electronAPI.setProgress(-1); 
-    }, 2000);
+    }, 2000); // Wait 2s so user sees 100% progress
     return;
   }
 
   const percent = parseFloat(e.data);
-
+  
   if (!isNaN(percent)) {
     updateProgress(percent);
-    window.electronAPI.setProgress(percent);
+    window.electronAPI.setProgress(percent); // Update Task Bar
+    // Don't hide at 100%, wait for "done" signal instead
   }
 };
 
-/**
- * SSE stream: download speed updates (e.g. "5.2 MiB/s").
- */
 speedEvt.onmessage = e => {
   speedElement.style.display = "block";
-  speedElement.textContent = e.data;
+  speedElement.textContent = e.data; // ex: "5.2MiB/s"
 };
 
-/**
- * SSE stream: download stage updates (e.g. downloading, merging, extracting).
- */
 stageEvt.onmessage = e => {
   stageElement.style.display = "block";
-  stageElement.textContent = e.data;
+  stageElement.textContent = e.data; // ex: "📥 Downloading..."
 };
 
-/**
- * SSE stream: playlist progress updates (e.g. "Item 1 of 15").
- */
 playlistInfoEvt.onmessage = e => {
   playlistInfoElement.style.display = "block";
-  playlistInfoElement.textContent = e.data;
+  playlistInfoElement.textContent = e.data; // ex: "Item 1 of 15"
 };

public/script/reportBug.js

@@ -1,121 +0,0 @@
-class BugReportModal {
-    constructor() {
-        this.modal = null;
-        this.form = null;
-        this.init();
-    }
-
-    init() {
-        this.modal = document.createElement("div");
-        this.modal.className = "bug-modal-overlay";
-        this.modal.style.cssText = "display:none; position:fixed; top:0; left:0; width:100%; height:100%; background:rgba(0,0,0,0.7); justify-content:center; align-items:center; z-index:99999; font-family:sans-serif;";
-
-        this.modal.innerHTML = `
-      <div class="bug-modal-content" style="background:#14141491 !important; color:#ffffff !important; padding:24px !important; border-radius:10px !important; width:420px !important; box-shadow: 0 10px 25px rgba(0,0,0,0.8) !important; display:flex !important; flex-direction:column !important; gap:16px !important; border: 1px solid #333 !important; box-sizing: border-box !important;">
-        <h3 style="margin:0 !important; font-size:1.2rem !important; font-weight:600 !important; color:#ffffff !important;">Report a Bug</h3>
-        <form id="bugReportForm" style="display:flex !important; flex-direction:column !important; gap:12px !important; width:unset !important; margin:0 !important; background:transparent !important; box-shadow: unset !important;">
-          <div style="display:flex !important; flex-direction:column !important; gap:4px !important;">
-            <label style="font-size:0.85rem !important; color:#aaaaaa !important;">Title <span style="color: red; font-weight: bold" >*</span> </label>
-            <input type="text" id="bugTitle" required style="background:#2a2a2a !important; border:1px solid #444 !important; color:#ffffff !important; border-radius:6px !important; padding:8px 10px !important; outline:none !important; width:100% !important; box-sizing: border-box !important;" />
-          </div>
-          <div style="display:flex !important; flex-direction:column !important; gap:4px !important;">
-            <label style="font-size:0.85rem !important; color:#aaaaaa !important;">Description <span style="color: red; font-weight: bold" >*</span></label>
-            <textarea id="bugDescription" placeholder="Provide some details about the bug" required rows="4" style="background:#2a2a2a !important; border:1px solid #444 !important; color:#ffffff !important; border-radius:6px !important; padding:8px 10px !important; outline:none !important; resize:vertical !important; width:100% !important; box-sizing: border-box !important;"></textarea>
-          </div>
-          <div style="display:flex !important; flex-direction:column !important; gap:4px !important;">
-            <label style="font-size:0.85rem !important; color:#aaaaaa !important;">Include Logs From Today</label>
-            <select id="bugIncludeLogs" style="background:#2a2a2a !important; border:1px solid #444 !important; color:#ffffff !important; border-radius:6px !important; padding:8px 10px !important; outline:none !important; width:100% !important; box-sizing: border-box !important;">
-              <option value="yes" style="background:#2a2a2a !important; color:#ffffff !important;">Yes</option>
-              <option value="no" style="background:#2a2a2a !important; color:#ffffff !important;">No</option>
-            </select>
-          </div>
-          <div style="display:flex !important; justify-content:flex-end !important; gap:8px !important; margin-top:8px !important;">
-            <button type="button" id="bugCancelBtn" style="background:#333333 !important; border:none !important; color:#cccccc !important; padding:8px 14px !important; border-radius:6px !important; cursor:pointer !important;">Cancel</button>
-            <button type="submit" style="background:#4f46e5 !important; border:none !important; color:#ffffff !important; padding:8px 16px !important; border-radius:6px !important; cursor:pointer !important; font-weight:500 !important;">Send</button>
-          </div>
-        </form>
-      </div>
-    `;
-
-        document.body.appendChild(this.modal);
-        this.form = this.modal.querySelector("#bugReportForm");
-
-        this.bindEvents();
-    }
-
-    bindEvents() {
-        const titleInput = this.modal.querySelector("#bugTitle");
-        const descInput = this.modal.querySelector("#bugDescription");
-
-        titleInput.addEventListener("input", () => {
-            localStorage.setItem("draft_bug_title", titleInput.value);
-        });
-
-        descInput.addEventListener("input", () => {
-            localStorage.setItem("draft_bug_desc", descInput.value);
-        });
-
-        this.modal.querySelector("#bugCancelBtn").addEventListener("click", () => {
-            this.close();
-        });
-
-        this.modal.addEventListener("click", (e) => {
-            if (e.target === this.modal) {
-                this.close();
-            }
-        });
-
-        this.form.addEventListener("submit", async (e) => {
-            e.preventDefault();
-            const data = {
-                title: titleInput.value,
-                description: descInput.value,
-                includeLogs: this.modal.querySelector("#bugIncludeLogs").value
-            };
-
-            window.electronAPI.logInfo("Submitting:", data);
-
-            try {
-                const success = await window.electronAPI.sendReport(data);
-
-                if (success) {
-                    localStorage.removeItem("draft_bug_title");
-                    localStorage.removeItem("draft_bug_desc");
-                    this.form.reset();
-                    this.close();
-                    window.showSuccess("Bug report sent successfully!");
-                }
-            } catch (err) {
-                window.showError("Failed to send bug report.");
-                window.electronAPI.logError("Failed to send bug report:", err.message);
-            }
-        });
-    }
-
-    loadState() {
-        const savedTitle = localStorage.getItem("draft_bug_title");
-        const savedDesc = localStorage.getItem("draft_bug_desc");
-
-        if (savedTitle) {
-            this.modal.querySelector("#bugTitle").value = savedTitle;
-        }
-        if (savedDesc) {
-            this.modal.querySelector("#bugDescription").value = savedDesc;
-        }
-    }
-
-    open() {
-        this.loadState();
-        this.modal.style.display = "flex";
-    }
-
-    close() {
-        this.modal.style.display = "none";
-    }
-}
-
-window.bugModal = new BugReportModal();
-
-document.getElementById("report-bug-btn").addEventListener("click", () => {
-    window.bugModal.open();
-});

public/script/settingsPanel.js

@@ -1,105 +1,66 @@
-/**
- * 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 currentlyOpen = settingsPanel.style.display === "block";
+    const isOpen = settingsPanel.style.display === "block";
-  settingsPanel.style.display = currentlyOpen ? "none" : "block";
+    settingsPanel.style.display = isOpen ? "none" : "block";
 });
 
-/**
- * Closes the settings panel and resets internal state.
- */
 function closePanel() {
-  isOpen = false;
+    isOpen = false;
-  settingsPanel.style.display = "none";
+    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
+  document.querySelectorAll(".settings-section input, .settings-section select").forEach(el => {
-    .querySelectorAll(".settings-section input, .settings-section select")
+    const key = el.dataset.key;
-    .forEach((el) => {
+    if (features[key] !== undefined) {
-      const key = el.dataset.key;
+      if (el.type === "checkbox") el.checked = features[key];
-      if (!key) return;
+      else if (el.tagName === "SELECT") el.value = features[key];
+    }
 
-      if (features[key] !== undefined) {
+    el.addEventListener("change", () => {
-        if (el.type === "checkbox") el.checked = features[key];
+      if (key === "theme") return;
-        else if (el.tagName === "SELECT") el.value = features[key];
+      let value = el.type === "checkbox" ? el.checked : el.value;
-      }
+      window.electronAPI.setFeature(key, value);
-
-      el.addEventListener("change", () => {
-        if (key === "theme") return;
-
-        const value = el.type === "checkbox" ? el.checked : el.value;
-        window.electronAPI.setFeature(key, value);
-      });
     });
+  });
 }
 
-/**
+// Open The JSON
- * Opens configuration JSON file via Electron topbar API.
+document.getElementById("open-json-btn").addEventListener("click", () => {
- */
+  window.topbarAPI.openConfig();
-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();
 });
 
-/**
+// Open Theme Folder
- * Initializes settings UI by loading backend feature flags.
+document.getElementById("open-theme").addEventListener("click", () => {
- */
+  window.topbarAPI.openTheme();
-loadSettings();
+});
+
+// Refresh Themes
+document.getElementById("refresh-themes-btn").addEventListener("click", function() {
+  this.classList.add("spinning");
+  window.refreshThemes();
+  
+  setTimeout(() => {
+    this.classList.remove("spinning");
+  }, 600);
+});
+
+
+/* clic sur l'overlay = fermer */
+settingsPanel.addEventListener("click", closePanel);
+
+/* clic dans la modal = stop propagation */
+settingsModal.addEventListener("click", (e) => {
+    e.stopPropagation();
+});
+
+loadSettings();

public/script/toast.js

@@ -1,43 +1,35 @@
-/**
+window.showToast = function(message, type = 'info', duration = 4000) {
- * Displays a toast notification in the global UI container.
+  const container = document.getElementById('toast-container');
- *
+  if (!container) return;
- * 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");
+  // Create toast element
-  toast.classList.add("toast", type);
+  const toast = document.createElement('div');
+  toast.classList.add('toast', type);
 
+  // Icons for different types
   const icons = {
-    success: "check_circle",
+    success: '✓',
-    error: "error",
+    error: '✕',
-    warning: "warning",
+    warning: '⚠',
-    info: "info"
+    info: 'ℹ'
   };
 
   const icon = icons[type] || icons.info;
 
-  toast.style.setProperty("--toast-duration", `${duration}ms`);
   toast.innerHTML = `
-    <span class="toast-icon material-icons-round">${icon}</span>
+    <span class="toast-icon">${icon}</span>
     <span class="toast-message">${message}</span>
     <button class="toast-close" title="Close">×</button>
-    <div class="toast-progress"></div>
   `;
 
-  const closeBtn = toast.querySelector(".toast-close");
+  // Add close functionality
-  closeBtn.addEventListener("click", () => removeToast(toast));
+  const closeBtn = toast.querySelector('.toast-close');
+  closeBtn.addEventListener('click', () => removeToast(toast));
 
+  // Add to container
   container.appendChild(toast);
 
+  // Auto remove after duration
   if (duration > 0) {
     setTimeout(() => removeToast(toast), duration);
   }
@@ -45,41 +37,18 @@ window.showToast = function (message, type = "info", duration = 4000) {
   return toast;
 };
 
-/**
- * Removes a toast element with a small exit animation.
- *
- * @param {HTMLElement} toast
- */
 function removeToast(toast) {
-  if (!toast?.parentElement) return;
+  if (!toast.parentElement) return;
-
+  
-  toast.classList.add("removing");
+  toast.classList.add('removing');
-
   setTimeout(() => {
-    toast.remove();
+    if (toast.parentElement) {
+      toast.remove();
+    }
   }, 300);
 }
 
-/**
+window.showSuccess = (message, duration = 4000) => window.showToast(message, 'success', duration);
- * Shortcut: success toast
+window.showError = (message, duration = 5000) => window.showToast(message, 'error', duration);
- */
+window.showWarning = (message, duration = 4000) => window.showToast(message, 'warning', duration);
-window.showSuccess = (message, duration = 4000) =>
+window.showInfo = (message, duration = 4000) => window.showToast(message, 'info', duration);
-  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,59 +1,33 @@
-/**
+// Ajout des listeners pour la topbar
- * Initializes topbar button event listeners and binds them
+function setupTopbarListeners() {
- * 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.
- */
-export function initTopBar() {
   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 workshopBtn = document.getElementById('workshop-btn');
 
-  const minBtn = document.getElementById("minimize-btn");
   if (minBtn) minBtn.onclick = () => topbarAPI.minimize();
-
-  const maxBtn = document.getElementById("maximize-btn");
   if (maxBtn) maxBtn.onclick = () => topbarAPI.maximize();
-
-  const closeBtn = document.getElementById("close-btn");
   if (closeBtn) closeBtn.onclick = () => topbarAPI.close();
-  
-  const devtoolsBtn = document.getElementById("devtools-btn");
   if (devtoolsBtn) devtoolsBtn.onclick = () => topbarAPI.openDevTools();
-  
-  const logsBtn = document.getElementById("logs-btn");
   if (logsBtn) logsBtn.onclick = () => topbarAPI.openLogs();
-  
-  const websiteBtn = document.getElementById("website-btn");
   if (websiteBtn) websiteBtn.onclick = () => topbarAPI.openWebsite();
-  
-  const wikiBtn = document.getElementById("wiki-btn");
   if (wikiBtn) wikiBtn.onclick = () => topbarAPI.openWiki();
-  
-  const workshopBtn = document.getElementById("workshop-btn");
   if (workshopBtn) workshopBtn.onclick = () => topbarAPI.openWorkshop();
-
 }
 
-async function attachListeners(){
+document.addEventListener('DOMContentLoaded', setupTopbarListeners);
-  try{
-    const featuresList = await window.electronAPI.getFeatures();
-  
-    if (!featuresList.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";
-    }
-    
-  } catch (error) {
-    console.error("Failed to load layout features for topbar:", error);
-  }
 
-}
+const features = await window.electronAPI.getFeatures();
 
-initTopBar()
+if(!features.customTopBar){
-document.addEventListener("DOMContentLoaded", attachListeners)
+  document.getElementById("topbar").style.display = "none"; 
+  document.getElementById("container").style.marginTop = "0";
+  document.getElementById("theme-switcher").style.top = "30px";  
+} 

public/styles/components/toast.css

@@ -5,70 +5,73 @@
   right: 20px;
   display: flex;
   flex-direction: column;
-  gap: 12px;
+  gap: 8px;
   z-index: 9999;
   pointer-events: none;
 }
 
 /* Toast */
 .toast {
-  position: relative;
   display: flex;
   align-items: center;
-  gap: 12px;
+  gap: 10px;
-  padding: 14px 16px;
+  padding: 10px 14px;
-  background-color: rgba(30, 30, 30, 0.9);
+  background-color: rgba(50, 50, 50, 0.9);
-  backdrop-filter: blur(12px);
+  border-radius: 6px;
-  -webkit-backdrop-filter: blur(12px);
+  color: #ffffff;
-  border: 1px solid rgba(255, 255, 255, 0.08);
+  font-size: 0.9rem;
-  border-radius: 10px;
+  max-width: 220px;
-  color: #f3f4f6;
+  min-width: 100px;
-  font-family: inherit;
+  animation: slideIn 0.25s ease-out;
-  font-size: 0.875rem;
-  max-width: 320px;
-  min-width: 220px;
-  box-shadow: 0 10px 25px -5px rgba(0, 0, 0, 0.3), 0 8px 10px -6px rgba(0, 0, 0, 0.2);
-  animation: slideIn 0.3s cubic-bezier(0.16, 1, 0.3, 1) forwards;
   pointer-events: auto;
-  overflow: hidden;
+  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: 20px;
+  font-size: 18px;
   display: flex;
   align-items: center;
   justify-content: center;
 }
 
-.toast-icon svg {
-  width: 100%;
-  height: 100%;
-}
-
 .toast.success .toast-icon {
-  color: #22c55e;
+  color: #28a745;
 }
 
 .toast.error .toast-icon {
-  color: #ef4444;
+  color: #dc3545;
 }
 
 .toast.warning .toast-icon {
-  color: #f59e0b;
+  color: #ffc107;
 }
 
 .toast.info .toast-icon {
-  color: #0ea5e9;
+  color: #17a2b8;
 }
 
 /* Toast Message */
 .toast-message {
   flex: 1;
-  font-weight: 400;
+  font-weight: 500;
-  line-height: 1.4;
-  word-break: break-word;
 }
 
 /* Toast Close Button */
@@ -76,87 +79,58 @@
   flex-shrink: 0;
   background: none;
   border: none;
-  color: #9ca3af;
+  color: currentColor;
   cursor: pointer;
-  font-size: 16px;
+  font-size: 18px;
-  width: 24px;
+  padding: 0;
-  height: 24px;
-  border-radius: 4px;
   display: flex;
   align-items: center;
   justify-content: center;
-  transition: background-color 0.15s ease, color 0.15s ease;
+  opacity: 0.5;
+  transition: opacity 0.2s ease;
 }
 
 .toast-close:hover {
-  background-color: rgba(255, 255, 255, 0.1);
+  opacity: 1;
-  color: #ffffff;
-}
-
-.toast-progress {
-  position: absolute;
-  bottom: 0;
-  left: 0;
-  height: 3px;
-  width: 100%;
-  background-color: rgba(255, 255, 255, 0.1);
-  animation: progress var(--toast-duration, 4000ms) linear forwards;
-}
-
-.toast.success .toast-progress {
-  background-color: #22c55e;
-}
-
-.toast.error .toast-progress {
-  background-color: #ef4444;
 }
 
 /* Animations */
 @keyframes slideIn {
   from {
-    transform: translateY(-20px);
+    transform: translateX(350px);
     opacity: 0;
   }
   to {
-    transform: translateY(0);
+    transform: translateX(0);
     opacity: 1;
   }
 }
 
 @keyframes slideOut {
   from {
-    transform: translateY(0);
+    transform: translateX(0);
     opacity: 1;
   }
   to {
-    transform: translateY(-20px);
+    transform: translateX(350px);
     opacity: 0;
   }
 }
 
-@keyframes progress {
-  from {
-    width: 100%;
-  }
-  to {
-    width: 0%;
-  }
-}
-
 .toast.removing {
-  animation: slideOut 0.25s ease-in forwards;
+  animation: slideOut 0.25s ease-out;
 }
 
+/* Responsive */
 @media (max-width: 480px) {
   #toast-container {
-    top: auto;
+    bottom: 12px;
-    bottom: 16px;
+    right: 12px;
-    right: 16px;
+    left: 12px;
-    left: 16px;
   }
 
   .toast {
     max-width: none;
     min-width: auto;
   }
-}
+}

public/styles/layout/form.css

@@ -40,7 +40,8 @@ form button:hover {
 form#downloadForm {
     display: flex;
     gap: 0.5em;
-    width: 350px;
+    max-width: 600px;
+    width: 100%;
     justify-content: center;
 }
 

public/styles/styles.css

@@ -16,14 +16,6 @@
 @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');
 
 
-/* Mark element as disabled */
-.disabled {
-  pointer-events: none;
-  opacity: 0.5;
-  filter: grayscale(40%);
-  cursor: not-allowed;
-}
-
 /* Because why not */
 #reference{
   position: fixed;

scripts/CHANGELOG.md

@@ -1 +0,0 @@
-[//]: # (This file is used for the release CHANGELOG. Please use Markdown to describe changes.)

scripts/create-copr-package.sh

@@ -1,116 +0,0 @@
-#!/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

@@ -1,198 +0,0 @@
-#!/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")
-
-if [[ "$VERSION" == *"-preview"* ]]; then
-    echo "Error: The current version ($VERSION) is a 'preview"
-    echo "Unable to launch release pipeline. Please update the package.json with a stable version.."
-    exit 1
-fi
-
-TAG="$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 "Unknown Argument : $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 0.3 - Retrieve Changelog
-# ------------------------------------------------------------
-if [ ! -f "$ROOT_DIR/CHANGELOG.md" ]; then
-    echo "Warning: CHANGELOG.md not found, release notes will be empty."
-    CHANGELOG=""
-else
-    CHANGELOG="$(cat "$ROOT_DIR/CHANGELOG.md")"
-    echo "Changelog retrieved successfully"
-fi
-# ------------------------------------------------------------
-# 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
-
-## Changelog
-
-$CHANGELOG
-
-## Found a bug or issue?
-Please report it in the [GitHub Issues](https://github.com/MasterAcnolo/Freedom-Loader/issues) section.
-
-**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/download.controller.js

@@ -4,47 +4,11 @@ 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 = [];
+const playlistInfoListeners = [];
 
-/**
- * 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 = {
@@ -61,30 +25,17 @@ async function downloadController(req, res) {
       return res.status(400).send("Save Path Not Allowed.");
     }
 
-    const outputFolder = await fetchDownload(
+    // Get output folder when the download is finished
-      options,
+    const outputFolder = await fetchDownload(options, listeners, speedListeners, stageListeners, playlistInfoListeners);
-      progressListeners,
-      speedListeners,
-      stageListeners,
-      playlistListeners
-    );
-    
     notifyDownloadFinished(outputFolder, configFeatures.notifySystem);
     res.send("Download Done !");
     
   } catch (err) {
-    logger.error(`Server Error in /download: ${err?.message ?? err}`);
+    logger.error(`Server Error in /download : ${err.message}`);
-    res.status(500).send("Server Error");
+    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',
@@ -93,21 +44,14 @@ function progressController(req, res) {
   });
 
   const sendProgress = percent => res.write(`data: ${percent}\n\n`);
-  progressListeners.push(sendProgress);
+  listeners.push(sendProgress);
 
   req.on('close', () => {
-    progressListeners.splice(progressListeners.indexOf(sendProgress), 1);
+    listeners.splice(listeners.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',
@@ -124,14 +68,6 @@ 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',
@@ -148,14 +84,6 @@ function stageController(req, res) {
   });
 }
 
-/**
- * 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) {
@@ -167,18 +95,6 @@ function cancelDownloadController(req, res) {
   }
 }
 
-/**
- * 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',
@@ -187,10 +103,10 @@ function playlistInfoController(req, res) {
   });
 
   const sendPlaylistInfo = info => res.write(`data: ${info}\n\n`);
-  playlistListeners.push(sendPlaylistInfo);
+  playlistInfoListeners.push(sendPlaylistInfo);
 
   req.on('close', () => {
-    playlistListeners.splice(playlistListeners.indexOf(sendPlaylistInfo), 1);
+    playlistInfoListeners.splice(playlistInfoListeners.indexOf(sendPlaylistInfo), 1);
     res.end();
   });
 }

server/controller/info.controller.js

@@ -2,129 +2,71 @@ const { fetchInfo } = require("../services/info.services");
 const { parseVideo, parsePlaylist } = require("../helpers/parseInfo.helpers");
 const { logger } = require("../logger");
 const { isValidUrl } = require("../helpers/validation.helpers");
-const {isUrlPlaylist} = require("../helpers/playlist.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) {
 
-    // Previously, i support both POST and GET element, but it's kinda weird. So now it only support GET.
+    const url = req.body.url || req.query.url; // POST et GET
-    const url = req.query.url;
-    const encodedUrl = encodeURIComponent(url)
 
-    /**
+
-     * Basic validation:
+    // If no url, non-string url or invalid url
-     * - URL must exist
+
-     * - Must be a string
+    if (!url || typeof url !== "string" || !isValidUrl(url)) return res.status(400).send("Invalid URL Or Missing");
-     * - Must pass custom URL validation
+
-     */
+    logger.info(`/Info Request receive by the Info Controller. URL: ${url}`);
-    if (!url || typeof url !== "string" || !isValidUrl(url)) {
+
-        return res.status(400).send("Invalid URL Or Missing");
+    if (url.includes("&list") || url.includes("?list")) {
+        logger.info("Estimated Data Type: Playlist")
+
+    } else{
+        logger.info("Estimated Data Type: Video")
     }
 
-    logger.info(`Info request received. RAW URL: ${url}`);
-    logger.info(`Info request received. ENCODED: ${encodedUrl}`);
-
-    // Lightweight heuristic to detect playlist URLs. It works for Youtube.
-    const isPlaylistUrl = isUrlPlaylist(url);
-
-    logger.info(
-        isPlaylistUrl
-            ? "Estimated Data Type: Playlist"
-            : "Estimated Data Type: Video"
-    );
-
     try {
-        let data;
+    let data;
+    let fetchError = null;
 
-        /**
+    try {
-         * Primary metadata fetch attempt
+        data = await fetchInfo(url);
-         */
+    } catch (err) {
-        try {
+        fetchError = err;
-            data = await fetchInfo(url);
+        
-        } catch (err) {
+        // If it's a playlist URL and fetch failed, try fetching just the single video
-
+        if ((url.includes("&list") || url.includes("?list"))) {
-            /**
+            logger.info(`Playlist fetch failed: ${err.message}. Retrying with single video...`);
-             * Fallback strategy:
+            
-             * If playlist extraction fails, retry as single video
+            // Remove the &list parameter
-             */
+            const singleVideoUrl = url.split("&list")[0].split("?list")[0];
-            if (isPlaylistUrl) {
+            
-
+            try {
-                logger.info(
+                data = await fetchInfo(singleVideoUrl);
-                    `Playlist fetch failed: ${err.message}. Retrying as single video...`
+                logger.info(`Single video fetch succeeded after playlist failure`);
-                );
+            } catch (retryErr) {
-
+                logger.error(`Single video fetch also failed: ${retryErr.message}`);
-                // Remove playlist query parameter (best-effort cleanup)
+                throw err; // Throw the original error
-                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
-                    logger.error(err);
-                }
-
-            } else {
-                logger.error(err);
             }
-        }
-
-        /**
-         * Normalize response based on yt-dlp output type
-         */
-        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(
-                `Playlist fetched: ${playlist.title} (${playlist.count} videos)`
-            );
-
-            return res.json(playlist);
-
         } else {
-
+            throw err;
-            const video = parseVideo(data);
-
-            logger.info(`Video fetched: ${video.title}`);
-
-            return res.json(video);
         }
+    }
+
+    if (data._type === "playlist") {
+
+        const playlist = parsePlaylist(data);
+        logger.info(`Playlist : ${playlist.title} (${playlist.count} vidéos)`);
+        return res.json(playlist);
+
+    } else{
+        const video = parseVideo(data);
+        logger.info(`Unique Video: ${video.title}`);
+        return res.json(video);
+    }
+
 
     } catch (err) {
-
+        logger.error(`Info controller error: ${err && err.message ? err.message : err}`);
-        logger.error(
+        return res.status(500).send(`Unable to fetch info`);
-            `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/helpers/buildArgs.helpers.js

@@ -1,31 +1,10 @@
 const path = require("path");
 
-const {getUserBrowser} = require("./getBrowser.helpers.js");
+const getUserBrowser = require("./getBrowser.helpers.js");
 const { ffmpegPath, denoPath} = require("./path.helpers.js");
 const { configFeatures } = require("../../config.js");
 const { logger } = require("../logger.js");
-const config  = require("../../config")
 
-/**
- * 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 = [
@@ -41,29 +20,7 @@ function validateCodec(codec){
   }
 }
 
-/**
+function buildYtDlpArgs({ url, audioOnly, quality, outputFolder }) {
- * 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, isPlaylist}) {
 
   logger.info("--- CONFIGURATION ---");
 
@@ -71,7 +28,6 @@ function buildYtDlpArgs({url, audioOnly, quality, outputFolder, isPlaylist}) {
   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}`);
@@ -119,27 +75,7 @@ function buildYtDlpArgs({url, audioOnly, quality, outputFolder, isPlaylist}) {
   };
 
   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";
-  }
-
-  // Add a custom signature in each file downloaded with the app. It's a small things but i found it cool :)
-  if (configFeatures.addMetadata) {
-    args.push(
-        "--postprocessor-args",
-        `ffmpeg:-metadata comment="Downloaded with Freedom Loader ${config.version}"`
-    );
-}
-
-  args.push("-o", path.join(outputFolder, outputTemplate));
   args.push(url);
 
   return args.filter(Boolean);

server/helpers/getBrowser.helpers.js

@@ -1,63 +1,39 @@
 const fs = require("fs");
 const os = require("os");
-const notify = require("./notify.helpers");
+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 platform = process.platform;
+  const userProfile = os.homedir();
-  let isFirefoxHere = false;
 
-  if (platform === "win32") {
+  // List of browsers supported by yt-dlp (Currently I can only guarantee Firefox, Sorry)
-    const paths = [
+  const browsers = [
-      "C:\\Program Files\\Mozilla Firefox\\firefox.exe",
+    { name: "firefox", path: path.join(userProfile, "AppData", "Roaming", "Mozilla", "Firefox", "Profiles") },
-      "C:\\Program Files (x86)\\Mozilla Firefox\\firefox.exe",
+    // { name: "chrome", path: path.join(userProfile, "AppData", "Local", "Google", "Chrome", "User Data", "Default") },
-      `${process.env.LOCALAPPDATA}\\Mozilla Firefox\\firefox.exe`,
+    // { 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") },
+    // { name: "opera", path: path.join(userProfile, "AppData", "Roaming", "Opera Software", "Opera Stable") },
+    // { name: "vivaldi", path: path.join(userProfile, "AppData", "Local", "Vivaldi", "User Data", "Default") },
+    // { name: "safari", path: path.join(userProfile, "AppData", "Local", "Apple Computer", "Safari") },
+    // { name: "whale", path: path.join(userProfile, "AppData", "Local", "Naver", "Naver Whale", "User Data", "Default") }
+  ];
 
-    isFirefoxHere = paths.some(p => fs.existsSync(p));
+  // Search for an available browser
+  for (const browser of browsers) {
+    if (fs.existsSync(browser.path)) {
+      logger.info(`Browser found: ${browser.name}`);
+      return browser.name;
+    }
   }
 
-  if (platform === "linux") {
+  // No browser found - notify user
-    const paths = [
+  logger.warn("No supported browser found on the system");
-      "/usr/bin/firefox",
+  notify.notifyFirefoxBrowserMissing();
-      "/usr/bin/firefox-esr",
+  
-      "/usr/local/bin/firefox",
+  // Fallback: return "Firefox" to let YT-DLP manage error
-      "/snap/bin/firefox",
+  // this avoid app crash
-      "/var/lib/flatpak/exports/bin/org.mozilla.firefox",
-      `${os.homedir()}/.local/share/flatpak/exports/bin/org.mozilla.firefox`,
-    ];
-    isFirefoxHere = paths.some(p => fs.existsSync(p));
-  }
-
-  if (!isFirefoxHere) {
-    // If you somehow managed to live without Firefox and need help installing it. - Don't applied to my Linux chad
-    // No supported browser found => Notify User
-    logger.warn("No supported browser found on the system");
-    notify.notifyFirefoxBrowserMissing();
-  } else {
-    logger.info("Browser found: firefox");
-  }
-
-  // Fallback to Firefox and let yt-dlp handle the error gracefully.
-  // This prevents the application from crashing
   return "firefox";
 }
 
-module.exports = {getUserBrowser};
+module.exports = getUserBrowser

server/helpers/notify.helpers.js

@@ -1,65 +1,19 @@
 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.
- *
- * 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.",
     icon: iconPaths.confirm,
   });
 
-  // Protect notification to garbage collection and race condition, by adding a 150ms timeout before trying to open the folder
+  notif.on("click", () => shell.openPath(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();
 }
 
-/**
- * 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",
@@ -67,51 +21,23 @@ function notifyCookiesBrowserError(){
     icon: iconPaths.error,
   });
 
-  activeNotifications.add(notif);
+  notif.on("click", () => 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();
 }
 
-/**
+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,
   });
 
-  activeNotifications.add(notif);
+  notif.on("click", () => 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();
 }
 
 module.exports = {
-  notifyDownloadFinished,
+  notifyDownloadFinished, 
   notifyCookiesBrowserError,
-  notifyFirefoxBrowserMissing,
+  notifyFirefoxBrowserMissing
 };

server/helpers/parseInfo.helpers.js

@@ -1,38 +1,27 @@
-/**
- * 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",
+    return {
-    ...data
+        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",
+    return {
-    title: data.title || data.id,
+        type: "playlist",
-    channel: data.uploader,
+        title: data.title || data.id,
-    count: data.entries.length,
+        channel: data.uploader,
-    videos: (data.entries || []).map(v => ({
+        count: data.entries.length,
-      id: v.id,
+        videos: (data.entries || []).map(v => ({
-      title: v.title,
+            id: v.id,
-      url: v.webpage_url,
+            title: v.title,
-      duration: v.duration,
+            url: v.webpage_url,
-      thumbnail: v.thumbnail,
+            duration: v.duration,
-      uploader: v.uploader
+            thumbnail: v.thumbnail,
-    }))
+            uploader: v.uploader
-  };
+        }))
+    };
 }
 
-module.exports = { parseVideo, parsePlaylist };
+module.exports = { parseVideo, parsePlaylist };

server/helpers/path.helpers.js

@@ -1,232 +1,110 @@
 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");
- * Is the OS windows
- */
-const isWindows = process.platform === 'win32'
 
-/**
+// Centralized resource paths
- * On windows the binaries are name.exe on Linux/macOS no
+const resourcesPath = config.localMode 
- */
+  ? path.join(__dirname, "../../ressources")
-const ext = isWindows ? '.exe' : ''
-
-/**  Centralized resource paths */
-const resourcesPath = config.devMode
-  ? path.join(__dirname, "../../resources")
   : process.resourcesPath;
 
-/**  Default download folder (centralized) */
+// Default download folder (centralized)
-const defaultDownloadFolder = path.join(app.getPath("downloads"), "Freedom Loader");
+const defaultDownloadFolder = path.join(os.homedir(), "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;
 
-/** Source binary bundled inside application resources (used for first-time copy) */
+const sourceYtDlp = path.join(resourcesPath, "binaries","yt-dlp.exe");
-const sourceYtDlp = path.join(
-  binariesPath,
-  `yt-dlp${ext}`
-);
 
-/**
+if (config.localMode) {
- * Resolve binary locations depending on environment:
+  userYtDlp = path.join(__dirname, "../../ressources/yt-dlp.exe");
- * - dev: local resources folder
+  ffmpegPath = path.join(__dirname, "../../ressources/"); // <- has ffmpeg.exe and ffprobe.exe
- * - prod: extracted userData + packaged resources
+  denoPath = path.join(__dirname, "../../ressources/deno.exe"); 
- */
-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(
+  userYtDlp = path.join(app.getPath("userData"),"yt-dlp.exe");
-    app.getPath("userData"),
+  ffmpegPath = path.join(resourcesPath, "binaries","ffmpeg.exe"); 
-    `yt-dlp${ext}`
+  denoPath = path.join(resourcesPath, "binaries","deno.exe");
-  );
 
-  ffmpegPath = path.join(
+  if (!fs.existsSync(userYtDlp)) {
-    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) {
-          getLogger().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(
+  ytDlp: path.join(resourcesPath, "binaries", "yt-dlp.exe"),
-    binariesPath,
+  ffmpeg: path.join(resourcesPath, "binaries", "ffmpeg.exe"),
-    `yt-dlp${ext}`
+  ffprobe: path.join(resourcesPath, "binaries", "ffprobe.exe"),
-  ),
+  deno: path.join(resourcesPath, "binaries", "deno.exe")
-
-  ffmpeg: path.join(
-    binariesPath,
-    `ffmpeg${ext}`
-  ),
-
-  ffprobe: path.join(
-    binariesPath,
-    `ffprobe${ext}`
-  ),
-
-  deno: path.join(
-    binariesPath,
-    `deno${ext}`
-  )
 };
 
-/**
+// Theme paths - themes stored in AppData to survive updates
- * 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("theme");
+const defaultThemesSourcePath = path.join(resourcesPath, "theme");
 
-/**
- * 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);
-      getLogger().info("Created user themes directory");
+      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);
-        const srcIsFile = !fs.statSync(srcPath).isDirectory();
+        
-
+        if (!fs.existsSync(destPath)) {
-        if (fs.existsSync(destPath)) {
+          try {
-          const destIsDir = fs.statSync(destPath).isDirectory();
-          if (srcIsFile && destIsDir) {
-            getLogger().warn(`Corrupted theme entry: ${theme}, fixing...`);
-            fs.rmSync(destPath, { recursive: true, force: true });
-
-          } else {
-            continue;
-          }
-        }
-
-        try {
-          if (srcIsFile) {
-            fs.copyFileSync(srcPath, destPath);
-            fs.chmodSync(destPath, 0o666);
-          } else {
             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}`);
+            }
           }
-          getLogger().info(`Copied default theme: ${theme}`);
-        } catch (copyErr) {
-          getLogger().warn(`Failed to copy theme ${theme}: ${copyErr.message}`);
         }
       }
     } else {
-      getLogger().warn(`Default themes source path not found: ${defaultThemesSourcePath}`);
+      logger.warn(`Default themes source path not found: ${defaultThemesSourcePath}`);
     }
   } catch (err) {
-    getLogger().error(`Failed to initialize user themes: ${err.message}`);
+    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, {
+      fs.mkdirSync(dest, { recursive: true, mode: 0o777 });
-        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 {
@@ -238,32 +116,8 @@ function copyDirectory(src, dest) {
   }
 }
 
-// Runtime validation of critical binaries
+if (!userYtDlp){ logger.error("Missing YT-DLP")}
-// if (!userYtDlp) {
+if (!ffmpegPath){ logger.error("Missing FFMPEG")}
-//     getLogger().error("Missing yt-dlp binary");
+if (!denoPath){ logger.error("Missing DENO")}
-// }
 
-// if (!ffmpegPath) {
+module.exports = { userYtDlp, ffmpegPath, denoPath, iconPaths, binaryPaths, resourcesPath, defaultDownloadFolder, userThemesPath, initUserThemes };
-//     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");
-}
-
-/**
- * Helper to lazy load logger, avoid circular import
- * @returns {import("winston").Logger}
- */
-function getLogger() {
-    return require("../logger.js").logger;
-}
-
-module.exports = { userYtDlp, ffmpegPath, denoPath, iconPaths, binaryPaths, resourcesPath, defaultDownloadFolder, userThemesPath, initUserThemes, isWindows, validateBinaries };

server/helpers/playlist.helpers.js

@@ -1,12 +0,0 @@
-/**
- * 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.
- */
-export function isUrlPlaylist(url) {
-    return url.includes("?list=") || url.includes("&list=") || url.includes("@");
-}

server/helpers/rateLimit.helpers.js

@@ -1,24 +1,14 @@
 const RateLimit = require("express-rate-limit");
 
 
-/**
+/* Rate Limite */
- * Rate limiter middleware used to protect public endpoints
+const rateLimite = RateLimit({
- * 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,
+  max: 5, // limit each IP to 100 requests per windowMs on the root path
   message: "Too many requests, please try again later.",
-  statusCode: 429,
+  statusCode: 429, // HTTP status code for "Too Many Requests"
 });
 
 module.exports = {
-    rateLimit
+    rateLimite
 }

server/helpers/validation.helpers.js

@@ -1,43 +1,21 @@
 const path = require("path");
 
-/**
+function isValidUrl(url) { 
- * Validates whether the provided string is a well-formed URL.
+  try { 
- *
+      new URL(url); 
- * The validation relies on the native URL constructor and
+      return true; 
- * returns `true` only if the value can be successfully parsed.
+      
- *
+    } catch { 
- * @param {string} url - URL to validate.
+      return false; 
- * @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,11 +4,9 @@ const fs = require("fs");
 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");
+const logDir = path.join(os.homedir(), "AppData", "Local", "FreedomLoader", "logs");
 
 // Create "Logs" folder if needed
 try {
@@ -17,42 +15,15 @@ try {
   console.error(`Failed to create log directory: ${error.message}`);
 }
 
-/**
+const logFormat = format.combine(
- * Format used by the saved file
+  format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }),
- * @type {Format}
+  format.printf(({ timestamp, level, message }) => `${timestamp} | ${level.toUpperCase()} |  ${message}`)
- */
-const fileFormat = format.combine(
-    format.timestamp({format: "YYYY-MM-DD HH:mm:ss"}),
-    format.errors({stack: true}), // Capture la stack trace complète des erreurs
-    format.printf(({timestamp, level, message, stack}) => {
-      return `${timestamp} | ${level.toUpperCase()} | ${stack || message}`;
-    })
 );
 
-/**
+// Logger configuration
- * Formated used by the IDE/Console
- * @type {Format}
- */
-const consoleFormat = format.combine(
-    format.colorize({all: true}),
-    format.timestamp({format: "HH:mm:ss"}),
-    format.errors({stack: true}),
-    format.printf(({timestamp, level, message, stack}) => {
-      return `[${timestamp}] ${level}: ${stack || message}`;
-    })
-);
-
-/**
- * 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,
   transports: [
     new DailyRotateFile({
       dirname: logDir,
@@ -60,30 +31,22 @@ const logger = createLogger({
       datePattern: "YYYY-MM-DD",
       zippedArchive: false,
       maxFiles: "7d",
-      format: fileFormat,
+      format: logFormat,
       options: { flags: "a" },
     }),
     new transports.Console({
-      format: consoleFormat,
+      format: logFormat,
     }),
   ],
 });
 
-/**
+function logSessionStart() {
- * Start Log Session 
+  logger.info(`--- Starting session: ${new Date().toISOString()} ---`);
- */
-function logSessionStart(logDir, downloadPath) {
-  logger.info(`--- Starting session: ${new Date().toLocaleString('sv-SE')} ---`);
-  logger.info("============================================================")
   logger.info(`Application Version: ${config.version}`)
-  if (typeof logSystemInfo === 'function') logSystemInfo(logger, logDir, downloadPath);
 }
 
-/**
- * Stop Log Session
- */
 function logSessionEnd() {
-  logger.info(`--- Ending session: ${new Date().toLocaleString('sv-SE')} ---`);
+  logger.info(`--- Ending session: ${new Date().toISOString()} ---`);
 }
 
 module.exports = {

server/routes/info.route.js

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

server/server.js

@@ -1,17 +1,11 @@
 const express = require("express");
 const path = require("path");
+const { logger, logSessionEnd } = require("./logger");
 const config = require("../config");
-
+const { rateLimite } = require("./helpers/rateLimit.helpers");
-const {logger} = require("./logger");
-const { rateLimit } = require("./helpers/rateLimit.helpers");
 
 const app = express();
 
-/**
- * Store the state of the server
- */
-let serverInstance = null;
-
 // Middlewares
 app.use(express.json());
 app.use(express.urlencoded({ extended: true }));
@@ -19,49 +13,34 @@ app.use(express.static(path.join(__dirname, "../public")));
 
 // Routes
 app.use("/download", require("./routes/download.route"));
-app.use("/info", require("./routes/info.route"));
+app.use("/info",     require("./routes/info.route"));
-
+app.get("/", rateLimite, (req, res) => {
-// Interface
-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 serverInstance = app.listen(config.applicationPort, () => {
+    const server = app.listen(config.applicationPort, () => {
       logger.info(`Express server ready at http://localhost:${config.applicationPort}`);
-      resolve(serverInstance);
+      resolve(server);
     });
 
-    serverInstance.on("error", (err) => {
+    server.on("error", (err) => {
       logger.error("Express server error:", err);
       reject(err);
     });
+
+    const gracefulExit = () => {
+      logSessionEnd();
+      server.close(() => {
+        logger.info("Express server closed cleanly.");
+        process.exit();
+      });
+    };
+
+    process.on("SIGINT",  gracefulExit);
+    process.on("SIGTERM", gracefulExit);
   });
 }
 
-/**
+module.exports = { startServer };
- * Clean exit function called by Electron
- */
-function stopServer() {
-  if (serverInstance) {
-    try{
-      serverInstance.close();
-      logger.info("Express server closed cleanly");
-    } catch (err){
-      logger.error("Express server was not closed cleanly:", err)
-    }
-  } else {
-    logger.info("Express server was already closed");
-  }
-}
-
-module.exports = { startServer, stopServer };

server/services/download.services.js

@@ -6,54 +6,34 @@ const { buildYtDlpArgs } = require("../helpers/buildArgs.helpers");
 const notify = require("../helpers/notify.helpers");
 const path = require("path");
 const { isSafePath } = require("../helpers/validation.helpers");
-const {reloadFeatures} = require("../../config");
+const { configFeatures } = require("../../config.js");
-const {isUrlPlaylist} = require("../helpers/playlist.helpers");
 
-/**
- * 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;
 
-/**
+// Détecte si une URL est une playlist
- * Creates a dedicated download folder for a playlist.
+function isPlaylistUrl(url) {
- *
+  return url.includes("?list=") || url.includes("&list=");
- * 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(/[<>:"|?*]/g, '') 
-      .replace(/\s+/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)) {
@@ -63,17 +43,17 @@ function createPlaylistFolder(basePath, playlistTitle) {
       }
       counter++;
     }
-
+    
     logger.error(`Could not find available playlist folder after 1000 attempts`);
-    logger.error("Unable to create playlist folder");
+    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)) {
@@ -88,56 +68,27 @@ function createPlaylistFolder(basePath, playlistTitle) {
       }
       counter++;
     }
-
+    
     logger.error(`Could not create playlist folder after 1000 attempts`);
     throw new Error("Unable to create playlist folder");
   }
 }
 
-/**
+function fetchDownload(options, listeners, speedListeners, stageListeners, playlistInfoListeners) {
- * 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[]} progressListeners - 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, progressListeners, 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;
-
+    
     // Normalize path and validate it's safe (within Users folder)
     let safeOutputFolder = path.resolve(outputFolder);
-
+    
     if (!isSafePath(safeOutputFolder)) {
       logger.warn(`Path not allowed, using default instead: ${safeOutputFolder}`);
       safeOutputFolder = path.resolve(defaultDownloadFolder);
     }
-
+    
     // Create download folder if it doesn't exist
     try {
       fs.mkdirSync(safeOutputFolder, { recursive: true });
@@ -148,9 +99,9 @@ function fetchDownload(options, progressListeners, speedListeners, stageListener
     }
 
     // Détecte si c'est une playlist et crée un dossier approprié
-    const isPlaylist = options.playlistTitle || isUrlPlaylist(options.url);
+    const isPlaylist = options.playlistTitle || isPlaylistUrl(options.url);
-
+    
-    if (isPlaylist && userConfig.createPlaylistFolders) {
+    if (isPlaylist && configFeatures.createPlaylistFolders) {
       try {
         const playlistName = options.playlistTitle || "Untitled Playlist";
         safeOutputFolder = createPlaylistFolder(safeOutputFolder, playlistName);
@@ -159,16 +110,11 @@ function fetchDownload(options, progressListeners, speedListeners, stageListener
         logger.error(`Failed to create playlist folder: ${err.message}`);
         return reject(err);
       }
-    } else if (isPlaylist && !userConfig.createPlaylistFolders) {
+    } else if (isPlaylist && !configFeatures.createPlaylistFolders) {
       logger.info(`Playlist detected but createPlaylistFolders is disabled, using base folder`);
     }
 
-    const args = buildYtDlpArgs({
+    const args = buildYtDlpArgs({ ...options, outputFolder: safeOutputFolder });
-      ...options,
-      outputFolder: safeOutputFolder,
-      isPlaylist
-    });
-
     logger.info(`[yt-dlp args] ${args.join(" ")}`);
 
     const child = execFile(userYtDlp, args);
@@ -178,25 +124,25 @@ function fetchDownload(options, progressListeners, speedListeners, stageListener
 
     child.on("close", code => {
       currentDownloadProcess = null;
-      progressListeners.forEach(fn => fn("done"));
+      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}`));
     });
 
-
+    
     child.stdout.on("data", data => {
       data.toString().split("\n").forEach(line => {
         if (!line.trim()) return;
         logger.info(`[yt-dlp] ${line}`);
 
-        // Progress Bar
+        // Progress Bar 
         if (line.startsWith("[download] Destination:")) {
-          progressListeners.forEach(fn => fn("reset"));
+          listeners.forEach(fn => fn("reset"));
           stageListeners.forEach(fn => fn("Downloading..."));
         }
         const match = line.match(/\[download\]\s+(\d+\.\d+)%/);
-        if (match) progressListeners.forEach(fn => fn(parseFloat(match[1])));
+        if (match) listeners.forEach(fn => fn(parseFloat(match[1])));
 
         if (line.includes("MiB/s") || line.includes("KiB/s")) {
             const match = line.match(/\d+(\.\d+)?[KM]?iB\/s/);
@@ -241,24 +187,14 @@ function fetchDownload(options, progressListeners, speedListeners, stageListener
       data.toString().split("\n").forEach(line => line.trim() && logger.error(`[yt-dlp stderr] ${line}`));
     });
 
-
+    
   });
 }
 
-/**
- * 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
@@ -274,7 +210,7 @@ function cancelDownload() {
       // Fallback to regular kill
       currentDownloadProcess.kill('SIGKILL');
     }
-
+    
     currentDownloadProcess = null;
     logger.info("Download cancelled successfully");
     return true;

server/services/info.services.js

@@ -1,32 +1,10 @@
 const { execFile } = require("child_process");
 const { userYtDlp, denoPath } = require("../helpers/path.helpers");
-const {getUserBrowser} = require("../helpers/getBrowser.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",
@@ -38,9 +16,9 @@ function fetchInfo(url) {
 
     return new Promise((resolve, reject) => {
 
-        execFile(userYtDlp,[...metadataArgs , url],
+        execFile(userYtDlp,[...args, url],
             {   timeout: 30_000, // 30s, if more timeout
-                maxBuffer: 10 * 1024 * 1024 },  // Maximum response size: 10 MB (Node.js default is much smaller)
+                maxBuffer: 10 * 1024 * 1024 },  // 10MO max response (Default: 200ko)
                 
                 (error, stdout, stderr) => {
 
@@ -61,7 +39,6 @@ function fetchInfo(url) {
 
             try {
                 const data = JSON.parse(stdout);
-
                 resolve(data);
             } catch (e) {
                 logger.error(`JSON Parsing Error: ${e.message}`);

server/sysinfo.js

@@ -1,142 +0,0 @@
-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

@@ -1,182 +0,0 @@
-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

@@ -1,133 +0,0 @@
-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"
-            );
-        });
-    });
-});