Flathub submission guide

Drift-prevention: This Starlight page is the canonical Flathub submission guide. The legacy packaging/flathub/README.md path now points here to prevent duplicate instructions.

This guide documents how to submit Ferrex Player to Flathub for distribution. The Git commands below apply to the separate upstream Flathub repository clone; use Jujutsu for Ferrex repository work.

Prerequisites

Flatpak manifest is already configured: flatpak/io.github.lowband21.FerrexPlayer.yml
AppStream metadata: flatpak/io.github.lowband21.FerrexPlayer.metainfo.xml
Desktop entry: flatpak/io.github.lowband21.FerrexPlayer.desktop
Icons: 128x128, 192x192, 512x512 in flatpak/icons/

Submission Steps

1. Fork the Flathub Repository

gh repo fork flathub/flathub --clone=true
cd flathub

2. Create Your App Branch

git checkout -b io.github.lowband21.FerrexPlayer

3. Add Your Manifest

Copy your manifest to the repository root:

cp /path/to/ferrex/flatpak/io.github.lowband21.FerrexPlayer.yml .

4. Create flathub.json (Optional)

If you need special build options, create flathub.json:

{
  "only-arches": ["x86_64"],
  "skip-icons-check": false
}

5. Submit Pull Request

git add .
git commit -m "Add io.github.lowband21.FerrexPlayer"
git push origin io.github.lowband21.FerrexPlayer
gh pr create --title "Add io.github.lowband21.FerrexPlayer" --body "Ferrex Player - Native media player with zero-copy HDR on Wayland"

6. Wait for Review

The Flathub team will review your PR. Common checks:

AppStream metadata validation
Desktop file validation
Build succeeds on Flathub infrastructure
Security review

7. Post-Merge

After merge, your app will be:

Built automatically on Flathub’s infrastructure
Published to https://flathub.org/apps/io.github.lowband21.FerrexPlayer
Available via flatpak install flathub io.github.lowband21.FerrexPlayer

Maintenance

After initial submission, updates are handled via:

x-data-checker (automatic version updates)
Manual PRs for major changes
Flathub’s build system monitors your releases