refactor: extract CHANGELOG into a separated file. Should avoid characters issue

- replace unusued throw new Error by logger.error
- remove unusued variables isWindows, err
- remove unusued logFormat
- remove unusued imports logSessionEnd

.github/ISSUE_TEMPLATE/performance-issue.md

@@ -29,6 +29,9 @@ 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/pages/faq)
-- [ ] I have reviewed the [Wiki](https://masteracnolo.github.io/Freedom-Loader-Site/pages/wiki)
+- [ ] I have checked the [FAQ](https://masteracnolo.github.io/Freedom-Loader-Site/#/faq)
+- [ ] I have reviewed the [Wiki](https://masteracnolo.github.io/Freedom-Loader-Site/#/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
+## Related Issue (if applicable)
 
 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
+- [ ] I have tested on Windows 10 and/or Windows 11 or in any Linux Distribution
 
 ## Screenshots (if applicable)
 

.github/workflows/codeql.yml

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

@@ -17,8 +17,10 @@ config/config.dev.json
 ffmpeg
 ffprobe
 deno
+yt-dlp
 
 # Windows Executable
 ffmpeg.exe
 ffprobe.exe
-deno.exe
+deno.exe
+yt-dlp.exe

BINARIES.md

@@ -93,4 +93,5 @@ 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.
+- 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,6 +6,7 @@ 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/)
@@ -23,7 +24,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`
+- Logs from: `C:\Users\[USERNAME]\AppData\Local\FreedomLoader\logs\LOGS-YYYY-MM-DD.log` (Windows) or `~/.local/share/FreedomLoader/logs/` (Linux)
 - Screenshots if applicable
 
 ### 2. Request a Feature
@@ -43,13 +44,11 @@ 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
-2. Create a feature branch: `git checkout -b feature/your-feature-name`
-3. Make your changes
-4. Test thoroughly on Windows 10/11
-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
+1. Fork the repository.
+2. Check out our [**Developer Guide (DEVELOPMENT.md)**](./DEVELOPMENT.md) to set up your environment.
+3. Create a feature branch following our branching conventions.
+4. Make your changes and test thoroughly on Windows and/or Linux.
+5. Open a Pull Request using the appropriate template.
 
 **Code Guidelines:**
 - Use camelCase for variables and functions
@@ -72,41 +71,9 @@ Small contributions matter—don't hesitate to submit documentation PRs.
 
 ## Development Setup
 
-### Prerequisites
-- Node.js 16.x or higher
-- npm or yarn
-- Git
-- Windows 10/11 (for testing)
+Want to write some code? Awesome! 
 
-### 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)
-└── resources/       # Binaries (yt-dlp, ffmpeg, etc.)
-```
+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.
 
 ---
 
@@ -114,12 +81,9 @@ Freedom-Loader/
 
 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
-- [ ] UI changes work on all themes (if applicable)
-- [ ] Tested on Windows 10 and/or Windows 11
+- [ ] Any features wasn't break during the development
+- [ ] Tested on Windows 10/11 and/or any Linux Distribution
 
 ---
 
@@ -161,4 +125,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

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

@@ -15,8 +15,6 @@
 
 </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.
@@ -25,7 +23,7 @@ The primary goal is to make media downloading accessible to users who want offli
 
 ### See related repo:
 
-- **[Website](https://masteracnolo.github.io/Freedom-Loader-Site/)** - Official project website and documentation
+- **[Website](https://github.com/MasterAcnolo/Freedom-Loader-Site/)** - Official project website and documentation
 - **[Workshop](https://github.com/MasterAcnolo/Freedom-Loader-Workshop)** - Theme creation tool and theme browser
 
 ## Table of Contents
@@ -35,14 +33,12 @@ 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
@@ -61,9 +57,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
-- **Theme Workshop** — web-based theme creator and browser
-- **Toast notifications** — in-app feedback system
+- **Custom themes** - ZIP-based theme system with live preview
+- **Theme Workshop** - web-based theme creator and browser
+- **Toast notifications** - in-app feedback system
 - **Real-time progress tracking** - Live download progress bar with network speed indicator
 - **Server-Sent Events (SSE)** - Non-blocking progress updates via event streaming
 - **Settings panel** - In-app configuration interface with live updates
@@ -80,9 +76,11 @@ The primary goal is to make media downloading accessible to users who want offli
 - **Rate limiting** - Express-based request throttling to prevent server overload
 - **Graceful shutdown** - Proper cleanup of servers, logs, and RPC connections
 - **System notifications** - Windows notifications on download completion (clickable to open folder)
-- **Splash screen** — animated loading screen on startup
-- **Stop download** — ability to cancel in-progress downloads
-- **Playlist folders** — dedicated folder creation per playlist
+- **Splash screen** - animated loading screen on startup
+- **Stop download** - ability to cancel in-progress downloads
+- **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
 
@@ -105,7 +103,7 @@ The primary goal is to make media downloading accessible to users who want offli
 
 ### Linux
 
-#### Fedora (via Copr — recommended)
+#### Fedora (via Copr - recommended)
 
 Installing via Copr lets `dnf` handle future updates automatically:
 
@@ -178,7 +176,8 @@ The application supports various configuration options:
 - Custom download directory selection
 - Discord Rich Presence activation
 - Theme customization
-- Log level configuration
+- Log level
+- And somes to see in the list [Configuration Options](#configuration-options) available
 
 ### Troubleshooting
 
@@ -226,6 +225,7 @@ Freedom Loader can be configured either through the settings panel in the UI or
 ```json
 {
   "autoUpdate": true,
+  "systemTray": true,
   "discordRPC": true,
   "customTopBar": true,
   "autoCheckInfo": true,
@@ -250,6 +250,7 @@ Freedom Loader can be configured either through the settings panel in the UI or
 | Option                       | Type    | Default  | Description                                                |
 |------------------------------|---------|----------|------------------------------------------------------------|
 | `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                   |
 | `customTopBar`               | boolean | `true`   | Use custom application top bar                             |
 | `autoCheckInfo`              | boolean | `true`   | Automatically fetch video information on URL paste         |
@@ -258,7 +259,7 @@ Freedom Loader can be configured either through the settings panel in the UI or
 | `verboseLogs`                | boolean | `false`  | Enable detailed logging for debugging                      |
 | `autoDownloadPlaylist`       | boolean | `true`   | Automatically download entire playlists                    |
 | `keepPlaylistOrder`          | boolean | `false`  | Add index before title, usefull for album                  |
-| `createPlaylistFolders`      | boolean | `true`   | Automatically create a folder for a playlist               |
+| `createPlaylistFolders`      | boolean | `false`  | Automatically create a folder for a playlist               |
 | `customCodec`                | string  | `"h264"` | Video codec for encoding (supported: h264, h265, vp9, av1) |
 | `logSystem`                  | boolean | `true`   | Enable application logging                                 |
 | `outputTitleCheck`           | boolean | `true`   | Verify output file titles                                  |
@@ -280,94 +281,6 @@ Freedom Loader can be configured either through the settings panel in the UI or
 > [!NOTE]
 > Some 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
-├── resources/              # Internal resources (binaries)
-├── server/                  # Express backend server
-│   ├── logger.js
-│   ├── server.js
-│   ├── controller/          # Request handlers
-│   │   ├── download.controller.js
-│   │   └── info.controller.js
-│   ├── helpers/             # Utility functions
-│   │   ├── buildArgs.helpers.js
-│   │   ├── getBrowser.helpers.js
-│   │   ├── notify.helpers.js
-│   │   ├── parseInfo.helpers.js
-│   │   ├── path.helpers.js
-│   │   ├── rateLimit.helpers.js
-│   │   └── validation.helpers.js
-│   ├── routes/              # API route definitions
-│   │   ├── download.route.js
-│   │   └── info.route.js
-│   └── services/            # Business logic layer
-│       ├── download.services.js
-│       └── info.services.js
-├── theme/                   # Theme system
-│   ├── template.theme.json  # Theme template
-│   ├── Dark/                # Default dark theme
-│   │   └── dark.theme.json
-│   └── Light/               # Default light theme
-│       └── light.theme.json
-├── main.js                  # Electron main process entry point
-├── preload.js               # Electron preload script (IPC bridge)
-├── config.js                # Global configuration loader
-├── package.json             # Project metadata and dependencies
-├── CODE_OF_CONDUCT.md       # Community guidelines
-├── CONTRIBUTING.md          # Contribution guidelines
-├── LICENSE                  # GPLv3 license
-└── README.md                # This file
-```
-
 ### Architecture Overview
 
 Freedom Loader uses a client-server architecture within a single Electron application:
@@ -391,7 +304,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
 
@@ -414,28 +327,7 @@ Freedom Loader includes a web-based theme creator available at [Freedom Loader W
 
 ## Development
 
-### 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
-```
+If you are interested by running a local non compiled version of Freedom Loader or just interested by contributing, see [DEVELOPMENT](./DEVELOPMENT.md)
 
 ### Additional Dependencies
 
@@ -446,40 +338,19 @@ You must download the required binaries and place them in the `resources` folder
 
 #### Required 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:
-
-```
-resources/
-├── 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.
+See [BINARIES.md](./BINARIES.md) for how to setup the binaries.
 
 ### Development Guidelines
 
 - Follow existing code style and conventions
-- Write clear commit messages
-- Test thoroughly before submitting changes
-- Update documentation when adding features
-- Maintain compatibility with Windows 10+ and Linux
+- Write clear, imperative commit messages (e.g., "Add playlist indexing" not "Added")
+- Test thoroughly on both Windows and Linux before submitting changes
+- Update documentation (README, DEVELOPMENT.md) when adding features
+- Maintain compatibility with:
+  - 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
 
@@ -521,15 +392,7 @@ 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) 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.
+Please read [CONTRIBUTING.md](CONTRIBUTING.md), [DEVELOPMENT.md](./DEVELOPMENT.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) before contributing.
 
 ## License
 
@@ -545,8 +408,8 @@ You are free to use, modify, and redistribute this software under the terms of t
 - [Electron](https://www.electronjs.org/) for the desktop application framework
 - The open-source community for continuous support and contributions
 - [@SpicyFire21](https://github.com/SpicyFire21) to be the spiciest one
+- [@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
 
 ---

app/autoUpdater.js

@@ -121,8 +121,14 @@ function initAutoUpdater(mainWindow) {
  */
 async function checkForUpdates() {
 
-  if (process.env.SNAP) {
-    logger.info("Running as Snap, update managed by snapd, skipping electron-updater");
+  /**
+   * 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;
   }
 

app/discordRPC.js

@@ -1,6 +1,8 @@
 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.
@@ -20,6 +22,51 @@ const rpc = new RPC.Client({ transport: "ipc" });
  */
 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.
  *
@@ -32,6 +79,11 @@ let intervalId;
  */
 function startRPC() {
 
+  /**
+   * Patch that create Simlinks for Linux environment;
+   */
+  fixLinuxDiscordRPC();
+
   /**
    * Rich Presence payload describing current application state
    * shown in Discord user profile.
@@ -50,8 +102,10 @@ function startRPC() {
 
   });
 
-  rpc.login({ clientId }).catch(err => {
-    logger.error("Unable to connect to the RPC:", err);
+  rpc.login({ clientId }).catch(() => {
+    // 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.info("Unable to connect to the Discord RPC. Discord is maybe not launched");
   });
 }
 
@@ -60,28 +114,23 @@ function startRPC() {
  *
  * Responsibilities:
  * - Clear any running intervals
- * - Remove current activity from Discord
+ * - Remove current activity from Discord if connected
  * - Destroy RPC transport connection
  * - Handle cleanup errors safely
  */
-async function stopRPC(){
+async function stopRPC() {
+  if (rpc) {
     try {
       if (intervalId) clearInterval(intervalId);
 
-      /**
-       * Ensures RPC connection exists before attempting cleanup.
-       */
-      if (rpc && rpc.transport) {
-        await rpc.clearActivity()
-        await rpc.destroy();
-      } else{
-        logger.error("Not Able to close RPC")
-      }
-      
+      await rpc.destroy();
+
     } catch (err) {
-      logger.error("Error while closing the RPC:", 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);
     }
   }
+}
 
 
 module.exports = { startRPC, stopRPC};

app/ipcHandlers.js

@@ -13,11 +13,12 @@
 const { ipcMain, dialog, shell } = require("electron");
 const fs = require("fs");
 const { logger, logDir } = require("../server/logger");
-const { configFeatures, featuresPath } = require("../config");
+const {configFeatures, featuresPath, devMode} = 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");
 
 /**
  * Security whitelist for feature flags that can be modified at runtime.
@@ -27,6 +28,7 @@ const { userThemesPath } = require("../server/helpers/path.helpers");
  */
 const FEATURE_WHITELIST = new Set([
   "autoUpdate",
+  "systemTray",
   "discordRPC",
   "customTopBar",
   "autoCheckInfo",
@@ -112,7 +114,18 @@ function registerIpcHandlers(getMainWindow) {
   /**
    * 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.
@@ -213,6 +226,21 @@ 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

@@ -56,35 +56,30 @@ function validateDownloadPath(userPath) {
   if (!userPath) return getDefaultDownloadPath();
 
   try {
+      const absolutePath = path.resolve(userPath);
 
-    /**
-     * Resolves filesystem symlinks to ensure canonical absolute path.
-     * Required to prevent path traversal or alias bypass.
-     */
-    const resolved = fs.realpathSync(path.resolve(userPath));
+      if (!fs.existsSync(absolutePath)) {
+        fs.mkdirSync(absolutePath, { recursive: true });
+        logger.info(`Download folder created: ${absolutePath}`);
+      }
 
-    if (!fs.existsSync(resolved)) {
-      fs.mkdirSync(resolved, { recursive: true });
-      logger.info(`Download folder created: ${resolved}`);
+      const real = fs.realpathSync(absolutePath);
+
+      if (!isSafePath(real)) {
+          logger.error("Path not allowed: system folders are blocked!");
+      }
+
+      return real;
     }
 
-    const real = fs.realpathSync(resolved);
-
-    if (!isSafePath(resolved)) {
-      throw new Error("Path not allowed: system folders are blocked!");
+    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 real;
-  }
-  catch (err) {
-    
-    /**
-     * Handles invalid filesystem paths, permissions issues, or resolution failures.
-     * Logs diagnostic information before propagating a sanitized error.
-     */
-    logger.error(`Invalid download path: ${userPath} — ${err.message}`);
-    throw new Error(`Invalid or inaccessible path: ${err.message}`);
-  }
 }
 
 module.exports = { validateDownloadPath, getDefaultDownloadPath };

app/tray.js

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

@@ -81,6 +81,21 @@ 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.

config.js

@@ -7,7 +7,7 @@ const path = require("path");
  * Indicates whether the application is running in development mode.
  * Determined by Electron's packaging state.
  */
-const devMode = process.env.NODE_ENV === "test" || !app?.isPackaged;
+const devMode = !app.isPackaged || process.env.NODE_ENV === "test";
 
 /**
  * Resolves the configuration file path depending on runtime environment.

config/config.default.json

@@ -1,5 +1,6 @@
 {
   "autoUpdate": true,
+  "systemTray": false,
   "discordRPC": true,
   "customTopBar": true,
   "autoCheckInfo": true,
@@ -8,7 +9,7 @@
   "verboseLogs": false,
   "autoDownloadPlaylist": true,
   "keepPlaylistOrder": false,
-  "createPlaylistFolders": true,
+  "createPlaylistFolders": false,
   "customCodec": "h264",
   "logSystem": true,
   "outputTitleCheck": true,

main.js

@@ -38,10 +38,13 @@ app.setAppUserModelId("com.masteracnolo.freedomloader");
  * Load the app dependencies for hardware choice
  */
 const { logger, logSessionStart, logSessionEnd, logDir } = require("./server/logger");
-const { configFeatures } = require("./config");
+const { configFeatures, devMode} = require("./config");
 
 /**
- * On start, enable or disable hardWareAcceleration
+ * 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();
@@ -50,15 +53,7 @@ if (!configFeatures.enableHardwareAcceleration){
   logger.info("Enable Hardware Acceleration")
 }
 
-/**
- * In-memory snapshot of application feature flags.
- *
- * Note: Changes to the config file are not automatically reflected.
- * A restart could be required.
- */
-const config = require("./config");
-
-if(config.devMode){
+if(devMode){
   /**
    * Start devTron extensions - @see https://github.com/electron/devtron
    */
@@ -79,8 +74,45 @@ const { updateYtDlp } = require("./app/ytDlpUpdater");
 const { createMainWindow, getMainWindow } = require("./app/windowManager");
 const { registerIpcHandlers } = require("./app/ipcHandlers");
 const { createSplashWindow, closeSplashWindow, setSplashProgress } = require("./app/splashManager");
-const { userThemesPath, initUserThemes, isWindows, validateBinaries, defaultDownloadFolder } = 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");
 
+/**
+ * Global flag indicating if the application is intentionally shutting down.
+ * Used across the app to bypass the "minimize to tray on close" behavior.
+ * @type {boolean}
+ */
+app.isQuitting = false;
+
+/**
+ * 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
@@ -103,7 +135,7 @@ app.whenReady().then(async () => {
 
   createSplashWindow();
 
-  if (!config.devMode && !checkNativeDependencies()) return;
+  if (!devMode && !checkNativeDependencies()) return;
 
   const { userYtDlp } = require("./server/helpers/path.helpers");
   updateYtDlp(userYtDlp);
@@ -127,6 +159,11 @@ app.whenReady().then(async () => {
     
     closeSplashWindow();
     getMainWindow().show();
+
+    if (configFeatures.systemTray) {
+      createSystemTray(devMode);
+    }
+
     if (configFeatures.discordRPC) startRPC();
 
     if (configFeatures.autoUpdate) initAutoUpdater(getMainWindow());
@@ -138,12 +175,20 @@ app.whenReady().then(async () => {
 });
 
 app.on("window-all-closed", () => {
-  logger.info("Shutting down...");
-  app.quit();
+  if (app.isQuitting || !configFeatures.systemTray) {
+    logger.info("Shutting down...");
+    app.quit();
+  } else if (process.platform !== "darwin") {
+    logger.info("Main window closed, app running in background (Tray).");
+  }
 });
 
-app.on("before-quit", async () => {
-  await stopRPC();
-  logger.info("All services stopped. Have a nice day!");
-  logSessionEnd();
+app.on("before-quit", (event) => {
+  app.isQuitting = true;
+
+  if (!isCleanedUp) {
+    event.preventDefault(); 
+
+    cleanShutdown();
+  }
 });

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "freedom-loader",
-  "version": "1.6.1",
+  "version": "1.6.3-preview",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "freedom-loader",
-      "version": "1.6.1",
+      "version": "1.6.3-preview",
       "license": "GPL-3.0-only",
       "dependencies": {
         "chalk": "^4.1.2",
@@ -24,9 +24,10 @@
         "@electron/devtron": "^2.1.1",
         "@jest/globals": "^30.4.1",
         "@playwright/test": "^1.62.1",
-        "electron": "^43.3.0",
+        "electron": "^44.3.0",
         "electron-builder": "^26.15.3",
         "jest": "^30.4.2",
+        "nodemon": "^3.1.14",
         "playwright": "^1.62.1"
       }
     },
@@ -2939,6 +2940,19 @@
         "node": ">=6.0.0"
       }
     },
+    "node_modules/binary-extensions": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz",
+      "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/bindings": {
       "version": "1.5.0",
       "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz",
@@ -3015,6 +3029,19 @@
         "node": "20 || >=22"
       }
     },
+    "node_modules/braces": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
+      "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fill-range": "^7.1.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/browserslist": {
       "version": "4.28.7",
       "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.7.tgz",
@@ -3265,6 +3292,31 @@
         "node": ">=10"
       }
     },
+    "node_modules/chokidar": {
+      "version": "3.6.0",
+      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.6.0.tgz",
+      "integrity": "sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "anymatch": "~3.1.2",
+        "braces": "~3.0.2",
+        "glob-parent": "~5.1.2",
+        "is-binary-path": "~2.1.0",
+        "is-glob": "~4.0.1",
+        "normalize-path": "~3.0.0",
+        "readdirp": "~3.6.0"
+      },
+      "engines": {
+        "node": ">= 8.10.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.2"
+      }
+    },
     "node_modules/chownr": {
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/chownr/-/chownr-3.0.0.tgz",
@@ -3858,9 +3910,9 @@
       }
     },
     "node_modules/electron": {
-      "version": "43.3.0",
-      "resolved": "https://registry.npmjs.org/electron/-/electron-43.3.0.tgz",
-      "integrity": "sha512-nLlvu0WFjftWsSaTkV2B/c4NDuJBspTyXu8vKSQ6vLvFt8uG3NgN49LLKcXddwX0GqVvAQDhciWp+4xOdTdhew==",
+      "version": "44.3.0",
+      "resolved": "https://registry.npmjs.org/electron/-/electron-44.3.0.tgz",
+      "integrity": "sha512-St9EV7F2VtYaYWD2qaAjBwUgKxx39eJOUsUJ5+/1113sqbVfNqv4Dbm/W1rN7qmYSPa+mWwR6yr+b7MfgjgVfQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -4465,6 +4517,19 @@
         "node": ">=10"
       }
     },
+    "node_modules/fill-range": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
+      "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "to-regex-range": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/finalhandler": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.1.tgz",
@@ -4741,6 +4806,19 @@
         "url": "https://github.com/sponsors/isaacs"
       }
     },
+    "node_modules/glob-parent": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
+      "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "is-glob": "^4.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
     "node_modules/glob/node_modules/balanced-match": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
@@ -5031,6 +5109,13 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/ignore-by-default": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/ignore-by-default/-/ignore-by-default-1.0.1.tgz",
+      "integrity": "sha512-Ius2VYcGNk7T90CppJqcIkS5ooHUZyIQK+ClZfMfMNFEF9VSE73Fq+906u/CWu92x4gzZMWOwfFYckPObzdEbA==",
+      "dev": true,
+      "license": "ISC"
+    },
     "node_modules/immediate": {
       "version": "3.0.6",
       "resolved": "https://registry.npmjs.org/immediate/-/immediate-3.0.6.tgz",
@@ -5110,6 +5195,29 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/is-binary-path": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz",
+      "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "binary-extensions": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/is-extglob": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
+      "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/is-fullwidth-code-point": {
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
@@ -5130,6 +5238,29 @@
         "node": ">=6"
       }
     },
+    "node_modules/is-glob": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
+      "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-extglob": "^2.1.1"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-number": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
+      "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.12.0"
+      }
+    },
     "node_modules/is-promise": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz",
@@ -6653,6 +6784,58 @@
         "node": ">=18"
       }
     },
+    "node_modules/nodemon": {
+      "version": "3.1.14",
+      "resolved": "https://registry.npmjs.org/nodemon/-/nodemon-3.1.14.tgz",
+      "integrity": "sha512-jakjZi93UtB3jHMWsXL68FXSAosbLfY0In5gtKq3niLSkrWznrVBzXFNOEMJUfc9+Ke7SHWoAZsiMkNP3vq6Jw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "chokidar": "^3.5.2",
+        "debug": "^4",
+        "ignore-by-default": "^1.0.1",
+        "minimatch": "^10.2.1",
+        "pstree.remy": "^1.1.8",
+        "semver": "^7.5.3",
+        "simple-update-notifier": "^2.0.0",
+        "supports-color": "^5.5.0",
+        "touch": "^3.1.0",
+        "undefsafe": "^2.0.5"
+      },
+      "bin": {
+        "nodemon": "bin/nodemon.js"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/nodemon"
+      }
+    },
+    "node_modules/nodemon/node_modules/has-flag": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+      "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/nodemon/node_modules/supports-color": {
+      "version": "5.5.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
+      "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "has-flag": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
     "node_modules/nopt": {
       "version": "9.0.0",
       "resolved": "https://registry.npmjs.org/nopt/-/nopt-9.0.0.tgz",
@@ -7250,6 +7433,13 @@
         "node": ">= 0.10"
       }
     },
+    "node_modules/pstree.remy": {
+      "version": "1.1.8",
+      "resolved": "https://registry.npmjs.org/pstree.remy/-/pstree.remy-1.1.8.tgz",
+      "integrity": "sha512-77DZwxQmxKnu3aR542U+X8FypNzbfJ+C5XQDk3uWjWxn6151aIMGthWYRXTqT1E5oJvg+ljaa2OJi+VfvCOQ8w==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/pump": {
       "version": "3.0.4",
       "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.4.tgz",
@@ -7467,6 +7657,32 @@
         "util-deprecate": "~1.0.1"
       }
     },
+    "node_modules/readdirp": {
+      "version": "3.6.0",
+      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz",
+      "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "picomatch": "^2.2.1"
+      },
+      "engines": {
+        "node": ">=8.10.0"
+      }
+    },
+    "node_modules/readdirp/node_modules/picomatch": {
+      "version": "2.3.2",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",
+      "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
     "node_modules/register-scheme": {
       "version": "0.0.2",
       "resolved": "git+ssh://git@github.com/devsnek/node-register-scheme.git#e7cc9a63a1f512565da44cb57316d9fb10750e17",
@@ -8324,6 +8540,19 @@
       "dev": true,
       "license": "BSD-3-Clause"
     },
+    "node_modules/to-regex-range": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
+      "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-number": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=8.0"
+      }
+    },
     "node_modules/toidentifier": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
@@ -8333,6 +8562,16 @@
         "node": ">=0.6"
       }
     },
+    "node_modules/touch": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/touch/-/touch-3.1.1.tgz",
+      "integrity": "sha512-r0eojU4bI8MnHr8c5bNo7lJDdI2qXlWWJk6a9EAFG7vbhTjElYhBVS3/miuE0uOuoLdb8Mc/rVfsmm6eo5o9GA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "nodetouch": "bin/nodetouch.js"
+      }
+    },
     "node_modules/tr46": {
       "version": "0.0.3",
       "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz",
@@ -8419,6 +8658,13 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/undefsafe": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/undefsafe/-/undefsafe-2.0.5.tgz",
+      "integrity": "sha512-WxONCrssBM8TSPRqN5EmsjVrsv4A8X12J4ArBiiayv3DyyG3ZlIg6yysuuSYdZsVz3TKcTg2fd//Ujd4CHV1iA==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/undici": {
       "version": "7.29.0",
       "resolved": "https://registry.npmjs.org/undici/-/undici-7.29.0.tgz",

package.json

@@ -1,7 +1,8 @@
 {
   "name": "freedom-loader",
+  "desktopName": "com.masteracnolo.freedomloader",
   "productName": "Freedom Loader",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "author": "MasterAcnolo <MasterAcnolo@users.noreply.github.com>",
   "description": "Free and open-source GUI for yt-dlp — download video and audio from hundreds of platforms",
   "homepage": "https://masteracnolo.github.io/Freedom-Loader-Site/",
@@ -15,8 +16,12 @@
   },
   "main": "main.js",
   "scripts": {
-    "start": "electron --trace-warnings .",
-
+    "start": "electron --no-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",
@@ -25,10 +30,8 @@
     "release": "bash scripts/release.sh",
     "release:publish": "bash scripts/release.sh --publish",
     "release:dry-run": "bash scripts/release.sh --dry-run",
-
     "test": "jest",
     "test:unit": "jest test/unit",
-
     "update": "npm update"
   },
   "dependencies": {
@@ -47,9 +50,10 @@
     "@electron/devtron": "^2.1.1",
     "@jest/globals": "^30.4.1",
     "@playwright/test": "^1.62.1",
-    "electron": "^43.3.0",
+    "electron": "^44.3.0",
     "electron-builder": "^26.15.3",
     "jest": "^30.4.2",
+    "nodemon": "^3.1.14",
     "playwright": "^1.62.1"
   },
   "build": {
@@ -78,25 +82,21 @@
         "from": "theme",
         "to": "theme"
       },
-      {
-        "from": "build/confirm-icon.png",
-        "to": "confirm-icon.png"
-      },
-      {
-        "from": "build/banner.bmp",
-        "to": "banner.bmp"
-      },
-      {
-        "from": "build/banner.png",
-        "to": "banner.png"
-      },
-      {
-        "from": "build/error.png",
-        "to": "error.png"
-      },
       {
         "from": "config/config.default.json",
         "to": "config/config.default.json"
+      },
+      {
+        "from": "build",
+        "to": ".",
+        "filter": [
+          "app-icon.ico",
+          "app-icon-64x64.png",
+          "confirm-icon.png",
+          "banner.bmp",
+          "banner.png",
+          "error.png"
+        ]
       }
     ],
     "win": {
@@ -105,20 +105,14 @@
       "artifactName": "Freedom-Loader-Setup-${version}.${ext}",
       "extraResources": [
         {
-          "from": "resources/binaries/win-32/yt-dlp.exe",
-          "to": "binaries/yt-dlp.exe"
-        },
-        {
-          "from": "resources/binaries/win-32/ffmpeg.exe",
-          "to": "binaries/ffmpeg.exe"
-        },
-        {
-          "from": "resources/binaries/win-32/ffprobe.exe",
-          "to": "binaries/ffprobe.exe"
-        },
-        {
-          "from": "resources/binaries/win-32/deno.exe",
-          "to": "binaries/deno.exe"
+          "from": "resources/binaries/win-32",
+          "to": "binaries",
+          "filter": [
+            "yt-dlp.exe",
+            "ffmpeg.exe",
+            "ffprobe.exe",
+            "deno.exe"
+          ]
         }
       ]
     },
@@ -140,24 +134,20 @@
         "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/yt-dlp",
-          "to": "binaries/yt-dlp"
-        },
-        {
-          "from": "resources/binaries/linux/ffmpeg",
-          "to": "binaries/ffmpeg"
-        },
-        {
-          "from": "resources/binaries/linux/ffprobe",
-          "to": "binaries/ffprobe"
-        },
-        {
-          "from": "resources/binaries/linux/deno",
-          "to": "binaries/deno"
+          "from": "resources/binaries/linux",
+          "to": "binaries",
+          "filter": [
+            "yt-dlp",
+            "ffmpeg",
+            "ffprobe",
+            "deno"
+          ]
         }
       ]
     },

public/index.html

@@ -56,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">Thème</span>
+                        <span class="setting-title">Theme</span>
 
-                        <select id="themeSelect" data-key="theme" aria-label="Choisir le thème">
+                        <select id="themeSelect" data-key="theme" aria-label="Choose the theme">
 
                         </select>
                         <button id="refresh-themes-btn" title="Refresh themes" class="refresh-themes-btn">
@@ -127,13 +127,21 @@
                     </div>
                 </div>
 
-                <!-- <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 class="setting-item">
+                        <input data-key="systemTray" id="systemTray" type="checkbox">
+                        <div class="setting-info">
+                            <span class="setting-title">System Tray</span>
+                            <small>Minimize app on close, in the System Tray. [EXPERIMENTAL]</small>
+                        </div>
                     </div>
-                </div> -->
+
+                    <!-- <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">
@@ -254,7 +262,7 @@
             </div>
 
             <div class="download-path">
-                    Will be save on <span id="savePath"></span> 
+                Will be saved in <span id="savePath"></span>
                     <button id="changePath">Edit</button>
             </div>
 
@@ -298,7 +306,6 @@
     
     <!-- Scripts -->
     <script src="script/toast.js"></script>
-    <script src="script/customConfiguration.js"></script>
     <script src="script/clipboardPaste.js"></script>
     <script src="script/custompath.js"></script>
     <script src="script/settingsPanel.js"></script>

public/script/appVersion.js

@@ -1,21 +1,54 @@
 /**
- * Retrieves the application version from the Electron main process
- * and displays it in the UI version badge (bottom-right corner).
+ * Retrieves the application version and build state from the backend.
+ * Displays a formatted string indicating packaging state and preview status.
+ * Hides the "Packaged" state for production builds to keep the UI clean.
  *
- * This is mainly used for debugging and build identification.
+ * Example outputs: "Not Packaged Preview v1.6.2" or "Preview v1.6.2"
+ *
+ * @returns {Promise<void>}
  */
-async function versionLabel() {
+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();
 
-    /**
-     * UI element displaying the current application version.
-     * Updated at runtime after IPC call resolves.
-     */
-    const versionBadge = document.getElementById("version-badge");
+  /**
+   * UI element displaying the current application version.
+   * @type {HTMLElement | null}
+   */
+  const versionBadge = document.getElementById("version-badge");
 
-    if (!versionBadge) return;
+  if (!versionBadge) return;
 
-    versionBadge.textContent = `${appVersion}`;
+  /**
+   * 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}`;
 }
 
-versionLabel();
+displayVersionLabel();

public/script/customConfiguration.js

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

public/script/customthemes.js

@@ -121,7 +121,7 @@ async function initThemes() {
     const defaultTheme = {
       id: "dark",
       name: "Dark",
-      subtitle: "Darkness is my ally",
+      subtitle: "Because Why Not ?",
       style: {
         background: {
           size: "cover",

public/script/topbar.js

@@ -5,53 +5,55 @@
  * This function is safe to call once DOM is ready.
  * It silently aborts if the API or elements are missing.
  */
-function setupTopbarListeners() {
+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");
-
   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();
+
 }
 
-/**
- * Registers topbar event listeners after DOM is fully loaded.
- */
-document.addEventListener("DOMContentLoaded", setupTopbarListeners);
-
-/**
- * Applies UI layout adjustments depending on feature flags
- * provided by the Electron backend.
- *
- * Specifically handles:
- * - hiding custom topbar
- * - adjusting layout spacing
- * - repositioning theme switcher
- */
-(async function applyFeatureLayout() {
-  const features = await window.electronAPI.getFeatures();
-
-  if (!features.customTopBar) {
-    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";
+async function attachListeners(){
+  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);
   }
-})();
+
+}
+
+initTopBar()
+document.addEventListener("DOMContentLoaded", attachListeners)

scripts/CHANGELOG.md

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

scripts/release.sh

@@ -4,7 +4,14 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 VERSION=$(node -p "require('$ROOT_DIR/package.json').version")
-TAG="v$VERSION"
+
+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
@@ -17,7 +24,7 @@ for arg in "$@"; do
         --copr)    PUBLISH_COPR=true ;;
         --publish) PUBLISH_SNAP=true; PUBLISH_COPR=true ;;
         --dry-run) DRY_RUN=true ;;
-        *) echo "⚠️ Argument inconnu : $arg" ; exit 1 ;;
+        *) echo "Unknown Argument : $arg" ; exit 1 ;;
     esac
 done
 
@@ -57,6 +64,16 @@ echo "[0/5] Cleaning workspace..."
 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)
 # ------------------------------------------------------------
@@ -98,19 +115,13 @@ PREV_TAG=$(git rev-list --tags --skip=1 --max-count=1 | xargs git describe --tag
 
 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.
 
-## Next Release (non-exhaustive roadmap)
-- More format options
-- Subtitle support
-- Improved UI / UX
-- Language selection
-- Download specific parts of videos
-- File renaming options
-- Parallel downloads
-- Skip sponsored parts automatically
-
 **Full Changelog**: https://github.com/MasterAcnolo/Freedom-Loader/compare/${PREV_TAG}...${TAG}"
 
 if [ "$DRY_RUN" = false ]; then

server/controller/info.controller.js

@@ -2,6 +2,7 @@ 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");
 
 /**
  * Handles metadata retrieval for a video or playlist.
@@ -36,7 +37,7 @@ async function infoController(req, res) {
     logger.info(`Info request received. ENCODED: ${encodedUrl}`);
 
     // Lightweight heuristic to detect playlist URLs. It works for Youtube.
-    const isPlaylistUrl = url.includes("&list") || url.includes("?list");
+    const isPlaylistUrl = isUrlPlaylist(url);
 
     logger.info(
         isPlaylistUrl
@@ -76,11 +77,11 @@ async function infoController(req, res) {
                     );
 
                     // Preserve original error context
-                    throw err;
+                    logger.error(err);
                 }
 
             } else {
-                throw err;
+                logger.error(err);
             }
         }
 

server/helpers/buildArgs.helpers.js

@@ -1,9 +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.
@@ -130,6 +131,14 @@ function buildYtDlpArgs({url, audioOnly, quality, outputFolder, isPlaylist}) {
     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);
 

server/helpers/getBrowser.helpers.js

@@ -1,7 +1,6 @@
 const fs = require("fs");
 const os = require("os");
-const path = require("path");
-const notify = require("./notify.helpers")
+const notify = require("./notify.helpers");
 const { logger } = require("../logger");
 
 /**
@@ -22,41 +21,38 @@ const { logger } = require("../logger");
  * @returns {string} The detected browser identifier.
  */
 function getUserBrowser() {
-  //const userProfile = os.homedir();
-  const firefoxPath = getFirefoxProfilePath();
+  const platform = process.platform;
+  let isFirefoxHere = false;
 
-  /**
-   * Browsers supported by yt-dlp cookie extraction.
-   *
-   * Only Firefox is currently enabled and tested.
-   * Additional browsers can be enabled in the future
-   * once compatibility has been verified.
-   */
-  const browsers = [
-    { name: "firefox", path: firefoxPath },
-    // { name: "chrome", path: path.join(userProfile, "AppData", "Local", "Google", "Chrome", "User Data", "Default") },
-    // { name: "brave", path: path.join(userProfile, "AppData", "Local", "BraveSoftware", "Brave-Browser", "User Data", "Default") },
-    // { name: "edge", path: path.join(userProfile, "AppData", "Local", "Microsoft", "Edge", "User Data", "Default") },
-    // { 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") }
-  ];
+  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`,
+    ];
 
-  // Search for the first available browser profile.
-  for (const browser of browsers) {
-    if (browser.path && fs.existsSync(browser.path)) {
-      logger.info(`Browser found: ${browser.name}`);
-      return browser.name;
-    }
+    isFirefoxHere = paths.some(p => fs.existsSync(p));
   }
 
-  // No supported browser found => Notify User
-  logger.warn("No supported browser found on the system");
+  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`,
+    ];
+    isFirefoxHere = paths.some(p => fs.existsSync(p));
+  }
 
-  // If you somehow managed to live without Firefox and need help installing it. - Don't applied to my Linux chad
-  if (process.platform === "win32") {
+  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.
@@ -64,39 +60,4 @@ function getUserBrowser() {
   return "firefox";
 }
 
-function getFirefoxProfilePath() {
-  const home = os.homedir();
-
-  if (process.platform === "win32") {
-    return path.join(
-      home,
-      "AppData",
-      "Roaming",
-      "Mozilla",
-      "Firefox",
-      "Profiles"
-    );
-  }
-
-  if (process.platform === "linux") {
-    return path.join(
-      "usr",
-      "bin",
-      "firefox"
-    );
-  }
-
-  if (process.platform === "darwin") {
-    return path.join(
-      home,
-      "Library",
-      "Application Support",
-      "Firefox",
-      "Profiles"
-    );
-  }
-
-  return null;
-}
-
-module.exports = getUserBrowser
+module.exports = {getUserBrowser};

server/helpers/path.helpers.js

@@ -150,7 +150,7 @@ const binaryPaths = {
  * - user themes are persisted in userData to survive updates
  */
 const userThemesPath = path.join(app.getPath("userData"), "themes");
-const defaultThemesSourcePath = path.join(resourcesPath, "theme");
+const defaultThemesSourcePath = path.join("theme");
 
 /**
  * Initializes user theme directory and ensures default themes exist.
@@ -260,7 +260,7 @@ function validateBinaries() {
 
 /**
  * Helper to lazy load logger, avoid circular import
- * @returns {winston.Logger}
+ * @returns {import("winston").Logger}
  */
 function getLogger() {
     return require("../logger.js").logger;

server/helpers/playlist.helpers.js

@@ -0,0 +1,12 @@
+/**
+ * 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/logger.js

@@ -17,9 +17,29 @@ try {
   console.error(`Failed to create log directory: ${error.message}`);
 }
 
-const logFormat = format.combine(
-  format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }),
-  format.printf(({ timestamp, level, message }) => `${timestamp} | ${level.toUpperCase()} |  ${message}`)
+/**
+ * Format used by the saved file
+ * @type {Format}
+ */
+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}`;
+    })
+);
+
+/**
+ * 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}`;
+    })
 );
 
 /**
@@ -33,7 +53,6 @@ const logFormat = format.combine(
  */
 const logger = createLogger({
   level: "info",
-  format: logFormat,
   transports: [
     new DailyRotateFile({
       dirname: logDir,
@@ -41,11 +60,11 @@ const logger = createLogger({
       datePattern: "YYYY-MM-DD",
       zippedArchive: false,
       maxFiles: "7d",
-      format: logFormat,
+      format: fileFormat,
       options: { flags: "a" },
     }),
     new transports.Console({
-      format: logFormat,
+      format: consoleFormat,
     }),
   ],
 });
@@ -54,17 +73,17 @@ const logger = createLogger({
  * Start Log Session 
  */
 function logSessionStart(logDir, downloadPath) {
-  logger.info(`--- Starting session: ${new Date().toISOString()} ---`);
+  logger.info(`--- Starting session: ${new Date().toLocaleString('sv-SE')} ---`);
   logger.info("============================================================")
   logger.info(`Application Version: ${config.version}`)
-  logSystemInfo(logger, logDir, downloadPath)
+  if (typeof logSystemInfo === 'function') logSystemInfo(logger, logDir, downloadPath);
 }
 
 /**
  * Stop Log Session
  */
 function logSessionEnd() {
-  logger.info(`--- Ending session: ${new Date().toISOString()} ---`);
+  logger.info(`--- Ending session: ${new Date().toLocaleString('sv-SE')} ---`);
 }
 
 module.exports = {

server/server.js

@@ -1,11 +1,17 @@
 const express = require("express");
 const path = require("path");
-const { logger, logSessionEnd } = require("./logger");
 const config = require("../config");
+
+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 }));
@@ -30,33 +36,32 @@ app.get("/", rateLimit, (req, res) => {
  */
 async function startServer() {
   return new Promise((resolve, reject) => {
-    const server = app.listen(config.applicationPort, () => {
+    const serverInstance = app.listen(config.applicationPort, () => {
       logger.info(`Express server ready at http://localhost:${config.applicationPort}`);
-      resolve(server);
+      resolve(serverInstance);
     });
 
-    server.on("error", (err) => {
+    serverInstance.on("error", (err) => {
       logger.error("Express server error:", err);
       reject(err);
     });
-
-    /**
-     * Clean exit function
-     *  - Stop Log 
-     *  - Stop Express Server
-     *  - Stop Electron App 
-     */
-    const gracefulExit = () => {
-      logSessionEnd();
-      server.close(() => {
-        logger.info("Express server 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

@@ -7,6 +7,7 @@ const notify = require("../helpers/notify.helpers");
 const path = require("path");
 const { isSafePath } = require("../helpers/validation.helpers");
 const {reloadFeatures} = require("../../config");
+const {isUrlPlaylist} = require("../helpers/playlist.helpers");
 
 /**
  * Reference to the currently running yt-dlp process.
@@ -18,19 +19,6 @@ const {reloadFeatures} = require("../../config");
  */
 let currentDownloadProcess = null;
 
-/**
- * Determines whether a URL targets a playlist.
- *
- * The detection is based on the presence of the YouTube
- * playlist query parameter (`list`).
- *
- * @param {string} url - URL to inspect.
- * @returns {boolean} True if the URL appears to be a playlist.
- */
-function isPlaylistUrl(url) {
-  return url.includes("?list=") || url.includes("&list=");
-}
-
 /**
  * Creates a dedicated download folder for a playlist.
  *
@@ -49,23 +37,23 @@ function isPlaylistUrl(url) {
  */
 function createPlaylistFolder(basePath, playlistTitle) {
   const sanitizedTitle = playlistTitle
-    .replace(/[<>:"|?*]/g, '') 
-    .replace(/\s+/g, ' ') 
+      .replace(/[<>:"|?*]/g, '')
+      .replace(/\s+/g, ' ')
     .trim()
     .substring(0, 200);
 
   const playlistPath = path.join(basePath, sanitizedTitle);
-  
+
   try {
     if (!fs.existsSync(playlistPath)) {
       fs.mkdirSync(playlistPath, { recursive: true });
       logger.info(`Playlist folder created: ${playlistPath}`);
       return playlistPath;
     }
-    
+
     let counter = 1;
     let newPath;
-    
+
     while (counter <= 1000) {
       newPath = path.join(basePath, `${sanitizedTitle} ${counter}`);
       if (!fs.existsSync(newPath)) {
@@ -75,17 +63,17 @@ function createPlaylistFolder(basePath, playlistTitle) {
       }
       counter++;
     }
-    
+
     logger.error(`Could not find available playlist folder after 1000 attempts`);
-    throw new Error("Unable to create playlist folder");
-    
+    logger.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)) {
@@ -100,7 +88,7 @@ function createPlaylistFolder(basePath, playlistTitle) {
       }
       counter++;
     }
-    
+
     logger.error(`Could not create playlist folder after 1000 attempts`);
     throw new Error("Unable to create playlist folder");
   }
@@ -123,7 +111,7 @@ function createPlaylistFolder(basePath, playlistTitle) {
  * @param {string} [options.outputFolder] - Destination folder.
  * @param {string} [options.playlistTitle] - Playlist title.
  *
- * @param {Function[]} listeners - Progress listeners.
+ * @param {Function[]} progressListeners - Progress listeners.
  * @param {Function[]} speedListeners - Download speed listeners.
  * @param {Function[]} stageListeners - Processing stage listeners.
  * @param {Function[]} playlistInfoListeners - Playlist progress listeners.
@@ -132,24 +120,24 @@ function createPlaylistFolder(basePath, playlistTitle) {
  * Resolves with the final output folder path once the
  * download has completed successfully.
  */
-function fetchDownload(options, listeners, speedListeners, stageListeners, playlistInfoListeners) {
+function fetchDownload(options, progressListeners, speedListeners, stageListeners, playlistInfoListeners) {
 
   return new Promise((resolve, reject) => {
 
     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 });
@@ -160,7 +148,7 @@ function fetchDownload(options, listeners, speedListeners, stageListeners, playl
     }
 
     // Détecte si c'est une playlist et crée un dossier approprié
-    const isPlaylist = options.playlistTitle || isPlaylistUrl(options.url);
+    const isPlaylist = options.playlistTitle || isUrlPlaylist(options.url);
 
     if (isPlaylist && userConfig.createPlaylistFolders) {
       try {
@@ -190,25 +178,25 @@ function fetchDownload(options, listeners, speedListeners, stageListeners, playl
 
     child.on("close", code => {
       currentDownloadProcess = null;
-      listeners.forEach(fn => fn("done"));
+      progressListeners.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:")) {
-          listeners.forEach(fn => fn("reset"));
+          progressListeners.forEach(fn => fn("reset"));
           stageListeners.forEach(fn => fn("Downloading..."));
         }
         const match = line.match(/\[download\]\s+(\d+\.\d+)%/);
-        if (match) listeners.forEach(fn => fn(parseFloat(match[1])));
+        if (match) progressListeners.forEach(fn => fn(parseFloat(match[1])));
 
         if (line.includes("MiB/s") || line.includes("KiB/s")) {
             const match = line.match(/\d+(\.\d+)?[KM]?iB\/s/);
@@ -253,7 +241,7 @@ function fetchDownload(options, listeners, speedListeners, stageListeners, playl
       data.toString().split("\n").forEach(line => line.trim() && logger.error(`[yt-dlp stderr] ${line}`));
     });
 
-    
+
   });
 }
 
@@ -270,7 +258,7 @@ function fetchDownload(options, listeners, speedListeners, stageListeners, playl
 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
@@ -286,7 +274,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,6 +1,6 @@
 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");
 
 /**
@@ -61,6 +61,7 @@ function fetchInfo(url) {
 
             try {
                 const data = JSON.parse(stdout);
+
                 resolve(data);
             } catch (e) {
                 logger.error(`JSON Parsing Error: ${e.message}`);