Skip to content

Describe the artifacts the release actually builds - #78

Merged
nnmarcoo merged 1 commit into
mainfrom
install-docs-match-artifacts
Aug 22, 2026
Merged

Describe the artifacts the release actually builds#78
nnmarcoo merged 1 commit into
mainfrom
install-docs-match-artifacts

Conversation

@nnmarcoo

Copy link
Copy Markdown
Owner

Closes #50.

The install page told Linux users to chmod +x bloom-*.AppImage or sudo dpkg -i bloom_*.deb, and pointed Windows users at a .exe installer. The release workflow uploads bloom-*.tar.gz, bloom-*.dmg, bloom-*.zip and bloom-*.msi. No AppImage, no .deb, no .exe, so anyone on Linux following the page had nothing to download.

Now it describes the tarball. It also documents something that was not written down anywhere: the Linux full build links FFmpeg through an $ORIGIN/lib rpath, so lib/ has to stay next to the binary. Extract the tarball and move bloom somewhere on its own and video silently stops working.

The macOS text was already correct and I left it alone.

This makes the docs true today. Shipping an AppImage and a .deb is still the better answer for Linux, and I would rather do that as its own PR than bolt packaging onto a docs fix. Happy to pick it up next if you want it.

Also updated the search index entry, which indexed appimage, dpkg and deb as keywords.

install.html told Linux users to run an AppImage or install a .deb, and
mentioned a Windows .exe installer. The release workflow publishes only
tar.gz, dmg, zip and msi, so none of those files have ever existed.

Also documents that the Linux full build needs lib/ kept beside the
binary, since it links FFmpeg through an $ORIGIN/lib rpath.
@nnmarcoo
nnmarcoo merged commit abc0084 into main Aug 22, 2026
1 check passed
@nnmarcoo
nnmarcoo deleted the install-docs-match-artifacts branch August 22, 2026 14:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Install docs point at AppImage and .deb builds that do not exist

1 participant