feat: publish package to fedora copr, add script to automaticaly build and upload the file.

Enhance readme and fix auto updater issue
2026-07-29 18:25:47 +02:00 · 2026-06-29 10:44:17 +02:00
parent 7d5203001b
commit 8b31436e25
6 changed files with 247 additions and 49 deletions
--- a/README.md
+++ b/README.md
@@ -5,9 +5,9 @@
    alt="Banner"
    style="width: 50%;"/></a>

-### **A clean, open-source multimedia downloader for Windows**
+### **A clean, open-source multimedia downloader for Windows and Linux**

-[![Release](https://img.shields.io/badge/Release-1.5.1-blue?style=for-the-badge)](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+[![Release](https://img.shields.io/badge/Release-1.6.0-blue?style=for-the-badge)](https://github.com/MasterAcnolo/Freedom-Loader/releases)
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-red.svg?style=for-the-badge)](https://www.gnu.org/licenses/gpl-3.0)
 [![Website](https://img.shields.io/badge/Website-Visit-404040?style=for-the-badge)](https://masteracnolo.github.io/Freedom-Loader-Site/)
 [![Workshop](https://img.shields.io/badge/Worshop-Visit-0E05A1?style=for-the-badge)](https://masteracnolo.github.io/Freedom-Loader-Workshop/)
@@ -86,35 +86,84 @@ The primary goal is to make media downloading accessible to users who want offli

 ## Installation

+[![Fedora Copr](https://img.shields.io/badge/Fedora-Copr-294172?style=for-the-badge&logo=fedora&logoColor=white)](https://copr.fedorainfracloud.org/coprs/masteracnolo/freedom-loader/)
+[![Debian/Ubuntu](https://img.shields.io/badge/.deb-Debian%2FUbuntu-A81D33?style=for-the-badge&logo=debian&logoColor=white)](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+
+[//]: # ([![Snap Store]&#40;https://img.shields.io/badge/Snap-Store-82BEA0?style=for-the-badge&logo=snapcraft&logoColor=white&#41;]&#40;https://snapcraft.io/freedom-loader&#41;)
+[![AppImage](https://img.shields.io/badge/AppImage-Universal-1E88E5?style=for-the-badge&logo=linux&logoColor=white)](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+
 ### Requirements

- **Operating System**: Windows 10 or later
- **Browser**: Mozilla Firefox (required for cookie extraction)
-  - [Download Firefox](https://www.firefox.com)
+- **Windows**: Windows 10 or later
+- **Linux**: any modern x86_64 distribution
+- **Browser**: Mozilla Firefox ([download](https://www.firefox.com)) required for cookie extraction, on both platforms

-### Standard Installation
+### Windows

-1. Download the latest release from the [Releases page](https://github.com/MasterAcnolo/Freedom-Loader/releases)
-2. Run the downloaded `.exe` installer
-3. If Windows Defender shows a warning, click "More info" then "Run anyway"
-4. Follow the installation wizard
+1. Download the latest `.exe` from the [Releases page](https://github.com/MasterAcnolo/Freedom-Loader/releases)
+2. Run the installer (click "More info" → "Run anyway" if Windows Defender warns you)
+3. Follow the installation wizard
+
+### Linux
+
+#### Fedora (via Copr — recommended)
+
+Installing via Copr lets `dnf` handle future updates automatically:
+
+```bash
+sudo dnf copr enable masteracnolo/freedom-loader
+sudo dnf install freedom-loader
+```
+
+#### Debian / Ubuntu (.deb)
+
+```bash
+# Download the latest .deb from the Releases page, then:
+sudo apt install ./freedom-loader_1.x.x_amd64.deb
+```
+
+[//]: # (#### Snap &#40;any distro with snapd&#41;)
+
+[//]: # ()
+[//]: # (```bash)
+
+[//]: # (sudo snap install freedom-loader)
+
+[//]: # (```)
+
+#### RPM (Fedora/RHEL/openSUSE, without Copr)
+
+```bash
+sudo dnf install ./freedom-loader-1.x.y.x86_64.rpm
+```
+
+#### AppImage (any distro, no installation needed)
+
+```bash
+# Download the latest .AppImage from the Releases page, then:
+chmod +x Freedom-Loader-1.x.y.AppImage
+./Freedom-Loader-1.x.y.AppImage
+```
+
+Once installed via any method, launch Freedom Loader from your application menu, or from a terminal with:
+```bash
+freedom-loader
+```

 ### File Locations

-Downloaded files are stored in:
-```
-C:\Users\[USERNAME]\Downloads\Freedom Loader
-```
-> [!NOTE]
-> *You can change it whenever you want. Just click the "Edit" button in the UI.*
+|               | Windows                                                 | Linux                                |
+|---------------|---------------------------------------------------------|--------------------------------------|
+| **Downloads** | `C:\Users\[USERNAME]\Downloads\Freedom Loader`          | `~/Downloads/Freedom Loader`         |
+| **Logs**      | `C:\Users\[USERNAME]\AppData\Local\FreedomLoader\logs\` | `~/.local/share/FreedomLoader/logs/` |

-Application logs can be found at:
-```
-C:\Users\[USERNAME]\AppData\Local\FreedomLoader\logs\
-```
+> [!NOTE]
+> The download folder can be changed anytime via the "Edit" button in the UI, on both platforms.

 ## Usage

+> [!TIP] On Linux, you can start Freedom Loader using `freedom-loader` command
+
 ### Basic Download

 1. Launch Freedom Loader
@@ -138,7 +187,7 @@ The application supports various configuration options:
 If you encounter issues:

 1. Restart the application
-2. Check the logs in `AppData\Local\FreedomLoader\logs\`
+2. Check the logs in `AppData\Local\FreedomLoader\logs\` or `~/.local/share/FreedomLoader/logs`
 3. Open the developer console: `CTRL + SHIFT + I` → "Toggle Developer Tools"
 4. Create an issue on GitHub with logs and reproduction steps

@@ -164,10 +213,17 @@ If you encounter issues:
 Freedom Loader can be configured either through the settings panel in the UI or by directly editing the `config.json` file located in the application data directory.

 ### Configuration File Location
+
+#### Windows
 ```
 %APPDATA%\Freedom Loader\config.json
 ```

+#### Linux
+```
+~/.config/Freedom Loader/config.json
+```
+
 ### Available Options
 ```json
 {
@@ -192,24 +248,24 @@ Freedom Loader can be configured either through the settings panel in the UI or

 ### Configuration Options

-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `autoUpdate` | boolean | `true` | Enable automatic application updates |
-| `discordRPC` | boolean | `true` | Enable Discord Rich Presence integration |
-| `customTopBar` | boolean | `true` | Use custom application top bar |
-| `autoCheckInfo` | boolean | `true` | Automatically fetch video information on URL paste |
-| `addThumbnail` | boolean | `true` | Embed thumbnail in downloaded audio files |
-| `addMetadata` | boolean | `true` | Add metadata tags to downloaded files |
-| `verboseLogs` | boolean | `false` | Enable detailed logging for debugging |
-| `autoDownloadPlaylist` | boolean | `true` | Automatically download entire playlists |
-| `createPlaylistFolders` | boolean | `true` | Automatically create a folder for a playlist |
-| `customCodec` | string | `"h264"` | Video codec for encoding (supported: h264, h265, vp9, av1) |
-| `logSystem` | boolean | `true` | Enable application logging |
-| `outputTitleCheck` | boolean | `true` | Verify output file titles |
-| `downloadSystem` | boolean | `true` | Enable download system |
-| `notifySystem` | boolean | `true` | Enable system notifications |
-| `enableHardwareAcceleration` | boolean | `true` | Enable Hardware Acceleration |
-| `theme` | string | `dark` | Current Theme Name |
+| Option                       | Type    | Default  | Description                                                |
+|------------------------------|---------|----------|------------------------------------------------------------|
+| `autoUpdate`                 | boolean | `true`   | Enable automatic application updates                       |
+| `discordRPC`                 | boolean | `true`   | Enable Discord Rich Presence integration                   |
+| `customTopBar`               | boolean | `true`   | Use custom application top bar                             |
+| `autoCheckInfo`              | boolean | `true`   | Automatically fetch video information on URL paste         |
+| `addThumbnail`               | boolean | `true`   | Embed thumbnail in downloaded audio files                  |
+| `addMetadata`                | boolean | `true`   | Add metadata tags to downloaded files                      |
+| `verboseLogs`                | boolean | `false`  | Enable detailed logging for debugging                      |
+| `autoDownloadPlaylist`       | boolean | `true`   | Automatically download entire playlists                    |
+| `createPlaylistFolders`      | boolean | `true`   | Automatically create a folder for a playlist               |
+| `customCodec`                | string  | `"h264"` | Video codec for encoding (supported: h264, h265, vp9, av1) |
+| `logSystem`                  | boolean | `true`   | Enable application logging                                 |
+| `outputTitleCheck`           | boolean | `true`   | Verify output file titles                                  |
+| `downloadSystem`             | boolean | `true`   | Enable download system                                     |
+| `notifySystem`               | boolean | `true`   | Enable system notifications                                |
+| `enableHardwareAcceleration` | boolean | `true`   | Enable Hardware Acceleration                               |
+| `theme`                      | string  | `dark`   | Current Theme Name                                         |

 ### Supported Codecs

@@ -423,7 +479,7 @@ resources/
 - Write clear commit messages
 - Test thoroughly before submitting changes
 - Update documentation when adding features
- Maintain compatibility with Windows 10+
+- Maintain compatibility with Windows 10+ and Linux

 ## Roadmap

@@ -445,7 +501,7 @@ Use the GitHub Issues system and include:
 - Clear description of the issue
 - Steps to reproduce
 - Expected vs actual behavior
- Relevant logs from `AppData\Local\FreedomLoader\logs\`
+- Relevant logs from `AppData\Local\FreedomLoader\logs\` or `~/.local/share/FreedomLoader/logs/`
 - Screenshots if applicable

 ### Feature Requests
--- a/app/autoUpdater.js
+++ b/app/autoUpdater.js
@@ -121,6 +121,11 @@ function initAutoUpdater(mainWindow) {
 */
 async function checkForUpdates() {

+  if (process.env.SNAP) {
+    logger.info("Running as Snap, update managed by snapd, skipping electron-updater");
+    return;
+  }
+
  if (!require("electron").app.isPackaged) return ;

  try {
--- a/package.json
+++ b/package.json
@@ -38,7 +38,8 @@
      {
        "provider": "github",
        "owner": "MasterAcnolo",
-        "repo": "Freedom-Loader"
+        "repo": "Freedom-Loader",
+        "releaseType": "draft"
      }
    ],
    "files": [
@@ -82,7 +83,7 @@
      "shortcutName": "Freedom Loader"
    },
    "linux": {
-      "target": ["AppImage", "deb","rpm"],
+      "target": ["AppImage", "deb","rpm", "snap"],
      "category": "Utility",
      "icon": "build/app-icon.png",
      "extraResources": [
@@ -90,12 +91,30 @@
        { "from": "resources/binaries/linux/ffmpeg", "to": "binaries/ffmpeg" },
        { "from": "resources/binaries/linux/ffprobe", "to": "binaries/ffprobe" },
        { "from": "resources/binaries/linux/deno", "to": "binaries/deno" }
-      ],
-      "extraFiles": [
-        {
-          "from": "package/com.masteracnolo.freedomloader.metainfo.xml",
-          "to": "usr/share/metainfo/com.masteracnolo.freedomloader.metainfo.xml"
-        }
+      ]
+    },
+    "deb": {
+      "fpm": [
+        "./package/com.masteracnolo.freedomloader.metainfo.xml=/usr/share/metainfo/com.masteracnolo.freedomloader.metainfo.xml"
+      ]
+    },
+    "rpm": {
+      "fpm": [
+        "./package/com.masteracnolo.freedomloader.metainfo.xml=/usr/share/metainfo/com.masteracnolo.freedomloader.metainfo.xml"
+      ]
+    },
+    "snap": {
+      "confinement": "strict",
+      "plugs": [
+        "default",
+        "home",
+        "removable-media",
+        "network",
+        "audio-playback",
+        "desktop",
+        "desktop-legacy",
+        "x11",
+        "wayland"
      ]
    }
  }
--- a/package/com.masteracnolo.freedomloader.metainfo.xml
+++ b/package/com.masteracnolo.freedomloader.metainfo.xml
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<component type="desktop-application">
+    <id>com.masteracnolo.freedomloader</id>
+
+    <name>Freedom Loader</name>
+
+    <summary>GUI for yt-dlp to download video and audio with metadata</summary>
+
+    <metadata_license>CC0-1.0</metadata_license>
+    <project_license>GPL-3.0-only</project_license>
+
+    <developer id="com.masteracnolo">
+        <name>MasterAcnolo</name>
+    </developer>
+
+    <description>
+        <p>
+            Freedom Loader is a free and open-source graphical interface built
+            around yt-dlp, the powerful command-line media downloader. It lets
+            you download video and audio from hundreds of supported websites
+            without ever touching a terminal, with no ads, no tracking, and
+            no questionable third-party services.
+        </p>
+        <p>
+            Under the hood, Freedom Loader bundles yt-dlp and ffmpeg directly,
+            so there is nothing extra to install: paste a link, choose a
+            format and quality, and the app handles fetching, converting
+            and tagging the file for you.
+        </p>
+        <p>Features include:</p>
+        <ul>
+            <li>MP4 video or MP3 audio downloads with embedded metadata and thumbnails</li>
+            <li>Quality selection from best to specific resolutions (1080p, 720p, 480p)</li>
+            <li>Codec choice: H.264, H.265, AV1, VP9 and Theora</li>
+            <li>Playlist downloads with automatic per-playlist folders</li>
+            <li>Cookie-based access to age-restricted and member-only content</li>
+            <li>Custom theme system with a web-based theme creator</li>
+            <li>Real-time download progress with network speed indicator</li>
+            <li>Optional Discord Rich Presence integration</li>
+            <li>Automatic application and download-engine updates</li>
+        </ul>
+        <p>
+            DRM-protected content is not supported and cannot be downloaded.
+        </p>
+    </description>
+
+    <launchable type="desktop-id">freedom-loader.desktop</launchable>
+
+    <url type="homepage">https://github.com/MasterAcnolo/Freedom-Loader</url>
+    <url type="bugtracker">https://github.com/MasterAcnolo/Freedom-Loader/issues</url>
+    <url type="vcs-browser">https://github.com/MasterAcnolo/Freedom-Loader</url>
+
+    <categories>
+        <category>AudioVideo</category>
+        <category>Utility</category>
+        <category>Network</category>
+    </categories>
+
+    <releases>
+        <release version="1.6.0" date="2026-06-23">
+            <description>
+                <p>Latest stable release.</p>
+            </description>
+        </release>
+    </releases>
+
+    <content_rating type="oars-1.1"/>
+
+    <provides>
+        <binary>freedom-loader</binary>
+    </provides>
+</component>
--- a/package/freedom-loader.spec
+++ b/package/freedom-loader.spec
@@ -0,0 +1,25 @@
+Name:           freedom-loader
+Version:        __VERSION__
+Release:        1%{?dist}
+Summary:        GUI for yt-dlp media downloads
+License:        GPL-3.0-only
+Source0:        freedom-loader-__VERSION__.x86_64.rpm
+BuildArch:      x86_64
+Requires:       glibc, gtk3, nss, libXScrnSaver
+
+%description
+GUI for yt-dlp media downloads.
+
+%install
+rpm2cpio %{SOURCE0} | (cd %{buildroot} && cpio -idmv)
+mkdir -p %{buildroot}/usr/bin
+ln -sf "/opt/Freedom Loader/freedom-loader" %{buildroot}/usr/bin/freedom-loader
+
+%files
+/opt/*
+/usr/bin/freedom-loader
+/usr/share/applications/*
+/usr/share/metainfo/*
+/usr/share/icons/hicolor
+
+%changelog
--- a/scripts/make-copr-srpm.sh
+++ b/scripts/make-copr-srpm.sh
@@ -0,0 +1,20 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+VERSION=$(node -p "require('$ROOT_DIR/package.json').version")
+mkdir -p "$ROOT_DIR/srpm-out"
+
+TMP_DIR="$ROOT_DIR/.copr-build-tmp"
+mkdir -p "$TMP_DIR"
+TMP_SPEC="$TMP_DIR/freedom-loader.spec"
+sed "s/__VERSION__/$VERSION/g" "$ROOT_DIR/package/freedom-loader.spec" > "$TMP_SPEC"
+
+rpmbuild -bs "$TMP_SPEC" \
+  --define "_sourcedir $ROOT_DIR/dist" \
+  --define "_srcrpmdir $ROOT_DIR/srpm-out"
+
+rm -rf "$TMP_DIR"
+echo "SRPM généré : $ROOT_DIR/srpm-out/freedom-loader-$VERSION-1*.src.rpm"