Distribution packaging

July 15, 2026 · View on GitHub

These files prepare OpenDeezer for several distribution providers. They do not mean the application is already listed: public catalogs still require their maintainers' accounts, reviews, and policy decisions.

ProviderRepository supportPublication status
F-DroidFour ABI source-build recipes, reproducible binaries, and Fastlane textUnder fdroiddata review; publish all four immutable binaries before updating its metadata
ObtainiumPhone and TV import configurationsReady for direct GitHub Releases use; catalog entry optional
Snap StoreStrictly confined GNOME recipeamd64 pack validated; register the name, test on Ubuntu, then upload
HomebrewmacOS/Linux TUI formulaChecksum-pinned; publish it to Cycl0o0/homebrew-tap
WinGetWindows TUI manifests, schema 1.12Checksum-pinned; submit to microsoft/winget-pkgs
AURSource-building PKGBUILD and .SRCINFOChecksum-pinned; publish through the AUR account
ScoopWindows TUI manifestDirect manifest install supported; a bucket makes it discoverable
FlathubExisting local Flatpak drafts onlyBlocked; do not submit the current files
IzzyOnDroidUses the signed GitHub APKsDeferred pending its current inclusion-policy review

Release automation

The publish-manifests release job runs scripts/update-package-manifests.sh. It updates versions and real checksums in Homebrew, WinGet, AUR, Scoop, Snap, and all four F-Droid ABI build blocks, preserves the result as a workflow artifact, and tries to open release/manifests-<tag>. PR creation is best-effort because a repository may disable PR creation by GITHUB_TOKEN; checksum or manifest validation failures still fail the job.

After merging that PR, the remaining external actions are:

  • copy the formula to Cycl0o0/homebrew-tap;
  • push the AUR files to the opendeezer AUR repository;
  • submit the WinGet directory with wingetcreate or a pull request;
  • publish the Scoop manifest in a maintained bucket;
  • build, test, register, and upload the Snap;
  • update and submit the F-Droid recipe after the next Android tag.

Android: F-Droid and Obtainium

fdroid/ contains a mainline F-Droid proposal that builds the Go AAR and one APK per supported ABI from source. It declares the NonFreeNet and TetheredNet anti-features because a Deezer account and proprietary Deezer service are required. Canonical listing text is under ../fastlane/metadata/android/. The F-Droid guide records the remaining signing, screenshot, reproducibility, and trademark review work.

obtainium/ contains import files for the phone/tablet and TV application IDs. Obtainium needs no central listing: it can follow the signed, per-ABI APKs on GitHub Releases directly.

IzzyOnDroid is separate from F-Droid and does not index every GitHub release automatically. Its current inclusion policy requires a separate request and review, so it is intentionally not submitted here.

Linux: Snap and local Flatpak

snap/ packages the GNOME client with strict confinement. Its guide covers local build/install tests and the human Snap Store publication step.

The manifests under flatpak/ remain useful for local Flatpak builds. They are not a Flathub submission. Current Flathub requirements restrict AI-assisted applications and submission material and also impose third-party trademark rules. A human maintainer must obtain policy and naming clearance before replacing and submitting the stale flatpak/flathub/ draft.

Terminal package managers

  • homebrew/opendeezer.rb installs the appropriate macOS or Linux TUI release binary. After tap publication: brew install Cycl0o0/tap/opendeezer.
  • winget/ installs the portable 64-bit Windows TUI. After community repository acceptance: winget install Cycl0o0.OpenDeezer.
  • aur/ builds the TUI from tagged source. After AUR publication: yay -S opendeezer.
  • scoop/opendeezer.json installs the 64-bit Windows TUI and carries a checksum-aware autoupdate template. See its README for the direct-manifest command and bucket publication.

Commercial mobile and desktop stores are not prepared here. Apple, Google, Microsoft Store, and Amazon submissions need developer accounts, platform signing/provisioning, and—most importantly—clear permission to use Deezer's service and branding.