shiru-flatpak

Flatpak repackaging for the Shiru desktop app using the official upstream .deb releases. This repo intentionally does not include Shiru source code.

What this repo does

• Fetches the latest Shiru .deb from upstream releases.
• Extracts it and packages it into a Flatpak.
• Caches extracted files for fast rebuilds.
• Injects version metadata so the installed Flatpak reports the upstream version.

Requirements

• flatpak
• flatpak-builder
• curl
• python3
• ar
• tar

Quick start

./flatpak-build.sh --clean

Skip install (CI or build-only)

./flatpak-build.sh --clean --skip-install

Force reinstall

./flatpak-build.sh --clean --force-install

Force update (re-download + re-extract)

./flatpak-build.sh --clean --update

How version checks work

• Latest upstream tag is read from GitHub releases.
• Installed Flatpak version is read from Flatpak metadata.
• If installed version matches the latest tag, the build is skipped (unless --force-install or --update).
• When --force-install is used on a matching version, the script logs a warning and reinstall proceeds.

Automation (GitHub Actions)

• The workflow compares the latest upstream tag with UPSTREAM_VERSION.
• If upstream is newer (or no release exists yet), it builds and publishes a new release.
• CI builds run with --skip-install to avoid flatpak remote-add on empty repos.
• The workflow installs the Flatpak runtime/sdk before building.

Resilience features

• Uses ETag caching to reduce GitHub API calls and avoid rate limits.
• Falls back to cached release data if GitHub is rate-limited.
• Asset matching is configurable via flatpak-build.conf.

Cache behavior

• Cache root: ~/.cache/shiru-flatpak
• Extracted files are cached per version and reused.
• .deb files are deleted after extraction to reduce IO.
• After a successful build, only the latest version is retained.

Configuration

Edit flatpak-build.conf to tune asset matching:

• DEB_ASSET_REGEX / DEB_ARCH_REGEX
• DEB_ASSET_FALLBACKS
• STRICT_ASSET

Files in this repo

• .flatpak-manifest.yaml - Flatpak manifest
• flatpak-build.sh - build + update script
• flatpak-build.conf - configuration
• com.github.rockinchaos.shiru.metainfo.xml - metadata
• VERSION - project version for this repo
• UPSTREAM_VERSION - last upstream Shiru version handled by this repo

Upstream

• Shiru releases: https://github.com/RockinChaos/Shiru/releases

License

See LICENSE.