Files
soundcraft/packaging/linux/flatpak/ai.storyteller.soundcraft.bundle.yml
8115ba9ed5 Release: Flatpak x86_64/aarch64, AppImage zsync updates, README Downloads (#13)
- AppImages embed gh-releases-zsync update information and ship a .zsync beside them.
- New flatpak job repackages the Linux tarball into soundcraft-<v>-linux-<arch>.flatpak
  (bundle manifest + flatpak-bundle.sh). Sandbox: pulseaudio socket (PipeWire's pulse server),
  ~/.vst3 and ~/.clap read-only, the LinuxAudio.Plugins extension point via VST3_PATH/CLAP_PATH;
  no raw ALSA devices, no JACK. The from-source Flathub manifest gets the same finish-args.
- Only signing jobs (macOS, Windows) and the draft job keep `environment: release`, so a branch
  dispatch dry-runs Linux, Flatpak, FreeBSD and web; the draft job still needs the signed jobs.
- README: Downloads section; docs/releasing.md updated.

Co-authored-by: Brandon Thomas <shared2@storyteller.ai>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 09:34:50 -04:00

74 lines
4.2 KiB
YAML

# Flatpak manifest for the single-file bundle attached to every GitHub release
# (soundcraft-<version>-linux-<arch>.flatpak). Build it with packaging/linux/flatpak-bundle.sh.
#
# It repackages the release's own Linux tarball (soundcraft-<version>-linux-<arch>.tar.gz,
# built on Ubuntu 22.04 by package.sh) instead of compiling Rust inside flatpak-builder: no
# network and no vendored crate sources during the build, a few seconds instead of 20+ minutes,
# and byte-for-byte the same binaries as the AppImage/deb/rpm. The script unpacks the tarball
# into `stage/` next to a copy of this file. The binaries need glibc >= 2.35 and load X11,
# Wayland, xkbcommon, Vulkan and libasound at runtime; the freedesktop runtime has all of them
# (plus alsa-lib's PulseAudio plugin), and the GPU driver comes from its
# org.freedesktop.Platform.GL extension.
#
# ai.storyteller.soundcraft.yml (same directory) is the from-source manifest for Flathub. Keep
# runtime-version, finish-args and add-extensions identical in both (packaging-lint checks this).
id: ai.storyteller.soundcraft
runtime: org.freedesktop.Platform
runtime-version: '25.08'
sdk: org.freedesktop.Sdk
command: soundcraft
finish-args:
# Display: Wayland first; X11 only when no Wayland compositor is running.
- --socket=wayland
- --socket=fallback-x11
# X11 shared memory (MIT-SHM). Without it the X11 fallback is slow or fails.
- --share=ipc
# GPU access for the wgpu UI (Vulkan, or GL as a fallback).
- --device=dri
# Playback and recording. cpal talks to ALSA; the runtime's alsa-lib routes ALSA through its
# PulseAudio plugin to this socket, which PipeWire's pulse server provides on modern desktops
# (and PulseAudio itself on older ones). Deliberately not granted: --device=all (raw /dev/snd
# for direct ALSA hardware access, which would bypass the sound server) and JACK, which
# SoundCraft doesn't use (cpal's jack feature is off; there is no live MIDI I/O either).
- --socket=pulseaudio
# Open/Save dialogs use the file-chooser portal (rfd) and drag-and-drop the document portal,
# so broad filesystem access isn't needed. Music is granted for sessions and their
# "Audio Files" folders opened by path from the command line.
- --filesystem=xdg-music
# VST3 and CLAP plugin hosts. The per-user plugin folders the hosts scan, read-only.
# System folders (/usr/lib/vst3, /usr/lib/clap) aren't reachable from the sandbox, and plugins
# there are linked against the host's libraries rather than the runtime's; sandboxed plugins
# come from Flatpak extensions instead (add-extensions below), found through these paths.
- --filesystem=~/.vst3:ro
- --filesystem=~/.clap:ro
- --env=VST3_PATH=/app/extensions/Plugins/vst3
- --env=CLAP_PATH=/app/extensions/Plugins/clap
# Flathub's shared audio-plugin extension point (org.freedesktop.LinuxAudio.Plugins.*, the one
# Ardour, Bitwig and friends use). Optional: nothing is downloaded unless the user installs a
# plugin extension; merge-dirs lets every installed one appear under .../Plugins/{vst3,clap}.
add-extensions:
org.freedesktop.LinuxAudio.Plugins:
directory: extensions/Plugins
version: '25.08'
add-ld-path: lib
merge-dirs: vst3;clap
subdirectories: true
no-autodownload: true
modules:
- name: soundcraft
buildsystem: simple
build-commands:
- install -Dm755 bin/soundcraft /app/bin/soundcraft
- install -Dm755 bin/soundcraft-cli /app/bin/soundcraft-cli
- install -Dm644 share/applications/ai.storyteller.soundcraft.desktop /app/share/applications/ai.storyteller.soundcraft.desktop
# Session files; the runtime's shared-mime-info already knows WAV, AIFF, FLAC, MP3 and MIDI.
- install -Dm644 share/mime/packages/ai.storyteller.soundcraft.xml /app/share/mime/packages/ai.storyteller.soundcraft.xml
# Already has the release's version and date substituted by package.sh.
- install -Dm644 share/metainfo/ai.storyteller.soundcraft.metainfo.xml /app/share/metainfo/ai.storyteller.soundcraft.metainfo.xml
- mkdir -p /app/share/icons /app/share/doc && cp -R share/icons/hicolor /app/share/icons/ && cp -R share/doc/soundcraft /app/share/doc/
# Mount point for the plugin extensions (add-extensions).
- install -d /app/extensions/Plugins
sources:
- type: dir
path: stage