Add flatpak support #132
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,67 @@ | ||
| # Flatpak Packaging for Hydra | ||
|
|
||
| This directory contains the Flatpak package definition and AppStream metadata for **Hydra Download Manager** (`io.github.ja7ad.hydra`). | ||
|
|
||
| ## Files | ||
|
|
||
| - `io.github.ja7ad.hydra.yml`: Flatpak manifest for building with `flatpak-builder`. | ||
| - `io.github.ja7ad.hydra.metainfo.xml`: AppStream 1.0+ metadata for Flathub, GNOME Software, and KDE Discover. | ||
| - `io.github.ja7ad.hydra.desktop`: XDG Desktop entry for Flatpak environments. | ||
|
|
||
| ## Building Locally | ||
|
|
||
| ### Prerequisites | ||
|
|
||
| Install Flatpak, `flatpak-builder`, and the Freedesktop 24.08 runtime and SDK: | ||
|
|
||
| ```bash | ||
| flatpak install flathub org.freedesktop.Platform//24.08 org.freedesktop.Sdk//24.08 org.freedesktop.Sdk.Extension.rust-stable//24.08 | ||
| ``` | ||
|
|
||
| ### Build and Install | ||
|
|
||
| To build and install the Flatpak into your user installation: | ||
|
|
||
| ```bash | ||
| flatpak-builder --user --install --force-clean build-dir packaging/flatpak/io.github.ja7ad.hydra.yml | ||
| ``` | ||
|
|
||
| ### Run | ||
|
|
||
| ```bash | ||
| flatpak run io.github.ja7ad.hydra | ||
| ``` | ||
|
|
||
| Or run via CLI: | ||
|
|
||
| ```bash | ||
| flatpak run --command=hydra io.github.ja7ad.hydra --help | ||
| ``` | ||
|
|
||
| ## Creating a Standalone Bundle (.flatpak) | ||
|
|
||
| To build a standalone `.flatpak` single-file installer: | ||
|
|
||
| ```bash | ||
| # Build into local repo | ||
| flatpak-builder --repo=repo --force-clean build-dir packaging/flatpak/io.github.ja7ad.hydra.yml | ||
|
|
||
| # Export single-file bundle | ||
| flatpak build-bundle repo Hydra-0.4.2-x86_64.flatpak io.github.ja7ad.hydra | ||
| ``` | ||
|
|
||
| Or use the helper script: | ||
|
|
||
| ```bash | ||
| scripts/package-flatpak.sh --bundle | ||
| ``` | ||
|
|
||
| ## Flathub Submission & Maintenance | ||
|
|
||
| 1. Fork the [Flathub repository](https://github.com/flathub/flathub). | ||
| 2. Generate `cargo-sources.json` for offline cargo dependencies: | ||
| ```bash | ||
| flatpak-cargo-generator Cargo.lock -o packaging/flatpak/cargo-sources.json | ||
| ``` | ||
| 3. Update the `sources` in `io.github.ja7ad.hydra.yml` to reference the release git tag and `cargo-sources.json`. | ||
| 4. Submit a pull request to `flathub/flathub` with the `io.github.ja7ad.hydra` branch/directory. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,12 @@ | ||
| [Desktop Entry] | ||
| Type=Application | ||
| Name=Hydra Download Manager | ||
| GenericName=Download Manager | ||
| Comment=Multi-connection download accelerator and manager | ||
| Exec=hydra-gui @@u %u @@ | ||
|
Owner
There was a problem hiding this comment. either drop both lines (Exec=hydra-gui, no MimeType), matching packaging/debian/hydra.desktop, or teach main.rs to consume a positional URL. As written the entry claims the hydra: scheme and throws the argument away. |
||
| Icon=io.github.ja7ad.hydra | ||
| Terminal=false | ||
| Categories=Network;FileTransfer; | ||
| Keywords=download;manager;accelerator;torrent;http;metalink;hls;dash; | ||
| StartupWMClass=hydra | ||
|
Owner
There was a problem hiding this comment. StartupWMClass=io.github.ja7ad.hydra, to match the app id app.rs:1789 now sets. |
||
| MimeType=x-scheme-handler/hydra; | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,71 @@ | ||
| <?xml version="1.0" encoding="UTF-8"?> | ||
| <component type="desktop-application"> | ||
| <id>io.github.ja7ad.hydra</id> | ||
| <name>Hydra Download Manager</name> | ||
| <summary>Multi-connection download accelerator and manager</summary> | ||
| <metadata_license>CC0-1.0</metadata_license> | ||
| <project_license>GPL-3.0-or-later</project_license> | ||
| <developer id="io.github.ja7ad"> | ||
| <name>Javad Rajabzadeh</name> | ||
| </developer> | ||
| <description> | ||
| <p> | ||
| Hydra is an advanced, high-performance download accelerator and manager written in Rust. | ||
| It splits downloads across multiple parallel HTTP/HTTPS connections with dynamic chunk sizing, | ||
| automatic resume capability, and end-to-end cryptographic checksum verification (SHA-256, BLAKE3, MD5, SHA-1). | ||
| </p> | ||
| <p>Key features include:</p> | ||
| <ul> | ||
| <li>High-speed multi-connection HTTP/HTTPS and streaming download engine</li> | ||
| <li>Adaptive stream assembly for HLS and MPEG-DASH audio/video streams</li> | ||
| <li>Metalink 3.0 and 4.0 XML parser and mirror failover handling</li> | ||
| <li>Remote zip preview and selective single-file extraction without full archive download</li> | ||
| <li>Reed-Solomon forward error correction (PAR2 parity) verification and repair</li> | ||
| <li>Full-featured graphical user interface, lightweight CLI (hydra / hya), and browser native messaging host</li> | ||
| <li>Browser integration for Firefox, Chrome, Edge, and Chromium derivatives</li> | ||
| <li>System tray integration (StatusNotifierItem) and dark/light system theme support</li> | ||
| </ul> | ||
| </description> | ||
| <launchable type="desktop-id">io.github.ja7ad.hydra.desktop</launchable> | ||
| <url type="homepage">https://github.com/ja7ad/hydra</url> | ||
| <url type="bugtracker">https://github.com/ja7ad/hydra/issues</url> | ||
| <url type="vcs-browser">https://github.com/ja7ad/hydra</url> | ||
| <url type="help">https://github.com/ja7ad/hydra/blob/main/README.md</url> | ||
| <screenshots> | ||
| <screenshot type="default"> | ||
| <image>https://raw.githubusercontent.com/ja7ad/hydra/main/docs/img/screenshot1.jpg</image> | ||
| <caption>Hydra Download Manager main window</caption> | ||
| </screenshot> | ||
| <screenshot> | ||
| <image>https://raw.githubusercontent.com/ja7ad/hydra/main/docs/img/screenshot2.png</image> | ||
| <caption>Queue scheduling and download progress</caption> | ||
| </screenshot> | ||
| <screenshot> | ||
| <image>https://raw.githubusercontent.com/ja7ad/hydra/main/docs/img/screenshot3.png</image> | ||
| <caption>Stream sniffer and media stream capture</caption> | ||
| </screenshot> | ||
| <screenshot> | ||
| <image>https://raw.githubusercontent.com/ja7ad/hydra/main/docs/img/screenshot4.png</image> | ||
| <caption>Zip directory preview and selective archive download</caption> | ||
| </screenshot> | ||
| </screenshots> | ||
| <provides> | ||
| <binary>hydra</binary> | ||
| <binary>hya</binary> | ||
| <binary>hydra-gui</binary> | ||
| <binary>hydra-host</binary> | ||
| </provides> | ||
| <releases> | ||
| <release version="0.4.2" date="2026-09-01"> | ||
|
Owner
There was a problem hiding this comment. date="2026-09-05" per CHANGELOG.md:8, and move the "Flatpak packaging" bullet (:65) to whichever release actually ships it. |
||
| <description> | ||
| <p>Features and improvements in release 0.4.2:</p> | ||
| <ul> | ||
| <li>Enhanced streaming parser and parallel segment fetcher</li> | ||
| <li>Optimized memory consumption and UI responsiveness</li> | ||
| <li>Flatpak packaging and Flathub distribution support</li> | ||
| </ul> | ||
| </description> | ||
| </release> | ||
| </releases> | ||
| <content_rating type="oars-1.1"/> | ||
| </component> | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,84 @@ | ||
| app-id: io.github.ja7ad.hydra | ||
| runtime: org.freedesktop.Platform | ||
| runtime-version: '24.08' | ||
| sdk: org.freedesktop.Sdk | ||
| sdk-extensions: | ||
| - org.freedesktop.Sdk.Extension.rust-stable | ||
| command: hydra-gui | ||
|
|
||
| finish-args: | ||
| # Display & Windowing | ||
| - --share=ipc | ||
| - --socket=fallback-x11 | ||
| - --socket=wayland | ||
| # Network & Hardware | ||
| - --share=network | ||
| - --socket=pulseaudio | ||
| - --device=dri | ||
| # Filesystem permissions for download directories | ||
| - --filesystem=xdg-download | ||
| - --filesystem=home | ||
| # StatusNotifierItem system tray integration | ||
| - --talk-name=org.kde.StatusNotifierWatcher | ||
| - --own-name=org.kde.StatusNotifierItem-* | ||
|
Owner
There was a problem hiding this comment. delete the line. --own-name=org.kde.StatusNotifierItem-* isn't a valid bus name (flatpak only strips a trailing .*), so build-finish errors out. ksni registers with the watcher under its unique name, so line 22's --talk-name=org.kde.StatusNotifierWatcher is all that's needed. |
||
| # Desktop notifications | ||
| - --talk-name=org.freedesktop.Notifications | ||
| # XDG Portals (File dialogs, settings, dark theme detection, URI open) | ||
| - --talk-name=org.freedesktop.portal.Desktop | ||
| - --talk-name=org.freedesktop.portal.FileChooser | ||
| - --talk-name=org.freedesktop.portal.OpenURI | ||
| - --talk-name=org.freedesktop.portal.Settings | ||
| - --talk-name=org.freedesktop.portal.Background | ||
| - --talk-name=org.freedesktop.portal.FdoStyle | ||
| - --system-talk-name=org.freedesktop.login1 | ||
|
|
||
| build-options: | ||
| append-path: /usr/lib/sdk/rust-stable/bin | ||
| env: | ||
| CARGO_HOME: /run/build/hydra/cargo | ||
|
Comment on lines
+35
to
+38
Owner
There was a problem hiding this comment. build has no network and no offline sources. For the local make flatpak path add the build-arg; for the Flathub submission generate cargo-sources.json instead (never both — Flathub rejects --share=network): |
||
|
|
||
| modules: | ||
| - name: hydra | ||
| buildsystem: simple | ||
| build-commands: | ||
| # Build GUI, CLI, and Native Host | ||
| - cargo build --release --locked -p hya-cli -p hya-gui -p hya-host | ||
| # Binaries | ||
| - install -Dm755 target/release/hydra-gui /app/bin/hydra-gui | ||
| - install -Dm755 target/release/hydra /app/bin/hydra | ||
| - install -Dm755 target/release/hydra-host /app/bin/hydra-host | ||
| - ln -sf hydra /app/bin/hya | ||
| # Desktop launcher & AppStream metadata | ||
| - install -Dm644 packaging/flatpak/io.github.ja7ad.hydra.desktop /app/share/applications/io.github.ja7ad.hydra.desktop | ||
| - install -Dm644 packaging/flatpak/io.github.ja7ad.hydra.metainfo.xml /app/share/metainfo/io.github.ja7ad.hydra.metainfo.xml | ||
| # Application icons (docs/logo.png -> hicolor) | ||
| - install -Dm644 docs/logo.png /app/share/icons/hicolor/512x512/apps/io.github.ja7ad.hydra.png | ||
| - | | ||
| for s in 16 32 48 64 128 256; do | ||
| if command -v magick >/dev/null 2>&1; then | ||
| install -d "/app/share/icons/hicolor/${s}x${s}/apps" | ||
| magick docs/logo.png -resize "${s}x${s}" "/app/share/icons/hicolor/${s}x${s}/apps/io.github.ja7ad.hydra.png" | ||
| elif command -v convert >/dev/null 2>&1; then | ||
| install -d "/app/share/icons/hicolor/${s}x${s}/apps" | ||
| convert docs/logo.png -resize "${s}x${s}" "/app/share/icons/hicolor/${s}x${s}/apps/io.github.ja7ad.hydra.png" | ||
| fi | ||
| done | ||
| # Shell completions | ||
| - install -d /app/share/bash-completion/completions /app/share/zsh/site-functions /app/share/fish/vendor_completions.d | ||
| - target/release/hydra completions bash > /app/share/bash-completion/completions/hydra | ||
| - target/release/hydra completions zsh > /app/share/zsh/site-functions/_hydra | ||
| - target/release/hydra completions fish > /app/share/fish/vendor_completions.d/hydra.fish | ||
| - target/release/hydra completions bash --bin-name hya > /app/share/bash-completion/completions/hya | ||
| - target/release/hydra completions zsh --bin-name hya > /app/share/zsh/site-functions/_hya | ||
| - target/release/hydra completions fish --bin-name hya > /app/share/fish/vendor_completions.d/hya.fish | ||
| # Man pages | ||
| - install -d /app/share/man/man1 | ||
| - for page in docs/man/*.1; do install -Dm644 "$page" "/app/share/man/man1/$(basename "$page")"; done | ||
| # Documentation & Licenses | ||
| - install -Dm644 LICENSE /app/share/licenses/io.github.ja7ad.hydra/LICENSE | ||
| - install -Dm644 LICENSING.md /app/share/licenses/io.github.ja7ad.hydra/LICENSING.md | ||
| - install -Dm644 README.md /app/share/doc/io.github.ja7ad.hydra/README.md | ||
| - install -Dm644 CHANGELOG.md /app/share/doc/io.github.ja7ad.hydra/CHANGELOG.md | ||
| sources: | ||
| - type: dir | ||
|
Owner
There was a problem hiding this comment. add skip: [target, .git, build-dir, repo] under the type: dir source. |
||
| path: ../.. | ||
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
the header at line 10 promises target/dist/*.flatpak, but bare make flatpak builds without exporting a bundle; either say make flatpak ARGS=--bundle there or default BUNDLE=1 in the script.