| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| OpenPublisher-5-x86_64.AppImage | 2026-09-30 | 166.4 MB | |
| openpublisher5_amd64-windows-portable.exe | 2026-09-30 | 183.2 MB | |
| openpublisher5_amd64-windows.exe | 2026-09-30 | 165.2 MB | |
| openpublisher5_amd64-macos.dmg | 2026-09-30 | 233.1 MB | |
| openpublisher5_amd64-linux.run | 2026-09-30 | 193.4 MB | |
| openpublisher5_amd64-linux.rpm | 2026-09-30 | 215.4 MB | |
| openpublisher5_amd64-linux.flatpak | 2026-09-30 | 153.6 MB | |
| openpublisher5_amd64-linux.deb | 2026-09-30 | 156.2 MB | |
| openpublisher5_amd64-freebsd.pkg | 2026-09-30 | 185.5 MB | |
| 5.1.11_ Linux AppImage Type 2 Specification _ AppStream Compliance source code.tar.gz | 2026-09-30 | 21.5 MB | |
| 5.1.11_ Linux AppImage Type 2 Specification _ AppStream Compliance source code.zip | 2026-09-30 | 21.7 MB | |
| README.md | 2026-09-30 | 7.1 kB | |
| Totals: 12 Items | 1.7 GB | 0 | |
🚀 Summary
Version 5.1.11 delivers a comprehensive overhaul of the Linux AppImage packaging and runtime specification for Open Publisher v5. This release resolves upstream AppImageKit Type 2 runtime mount failures, catalog rejection warnings, missing AppStream metadata, permission restrictions in sandboxed environments, and FreeDesktop standard naming compliance.
The standardized package (OpenPublisher-5-x86_64.AppImage) provides seamless, out-of-the-box portable execution across standard distributions (Ubuntu, Fedora, Arch, Debian, openSUSE) as well as automated containerized testing environments (such as AppImageHub and Firejail).
🔍 Root Cause Analysis
Upstream validation and CI test runners identified three primary failure points in the previous AppImage package:
- Runtime Mount Failure (
Could not mount the AppImage): - Incompatible Compression Algorithm: The prior AppImage was built using SquashFS
zstdcompression. However, the official Type 2 AppImageKit runtime (runtime-fuse2-x86_64) embeds a staticsquashfusebuild that only supportsxz,lzo,lz4, andlzma. When launched on standard CI runners without host zstd-squashfuse support, the runtime failed to mount the image. -
ELF Header and Superblock Offset Misalignment: Manual alignment previously inserted zero-padding between the ELF runtime executable and the SquashFS payload without recalculating the ELF Section Header Table offset (
e_shoff). Consequently, the runtime's internalappimage_get_elf_size()function returned an offset that landed inside the padding bytes rather than pointing directly at the SquashFShsqssuperblock. -
Catalog Linter Naming Warning (
should not contain 'Linux'): -
The AppImage catalog and validation linters flagged the package name
openpublisher5_amd64-linux.AppImage. In the AppImage packaging standard, thelinuxtoken is redundant. The official specification requires the<Name>-<Version>-<arch>.AppImageconvention. -
Missing AppStream Software Center Metadata:
-
Modern Linux software centers (KDE Discover, GNOME Software) and AppImageHub require AppStream metainfo located at
usr/share/metainfo/containing structured application metadata, licensing information, screenshot references, and developer details. -
Payload File Permissions Restrictions:
- Directories and binaries inside the SquashFS payload were packaged with restrictive
0700permissions. When executed inside restricted sandboxes (such as Firejail in the AppImageHub test suite) or by non-root user accounts, directory traversal and binary execution were blocked.
🛠️ Fixes & Implementation Details
1. Universal SquashFS Compression (xz)
- Switched the filesystem packaging pipeline from
zstdto standardxzcompression usingmksquashfs:bash mksquashfs AppDir OpenPublisher-5-x86_64.squashfs -comp xz -b 1M -root-owned -noappend - Guaranteed native compatibility with
squashfuse, AppImageKit Type 2 runtime, and older enterprise Linux kernels.
2. Precise ELF Header Alignment & Offset
- Repositioned the runtime's Section Header Table so that
appimage_get_elf_size()calculates to exactly196,608bytes (the exact byte offset where the SquashFS filesystem begins). - Recorded the offset in the header padding to preserve full backward compatibility with local custom runner stubs.
3. Normalized Filesystem Permissions
- Enforced standard POSIX permissions across the entire AppDir payload before filesystem creation:
- Directories:
0755(drwxr-xr-x) - Executable binaries:
0755(-rwxr-xr-x) - Regular data files:
0644(-rw-r--r--) - Ensures unprivileged users and containerized sandboxes (like Firejail) can traverse, read, and execute all package components without permission errors.
4. Full AppStream & FreeDesktop Integration
- AppStream Metainfo: Added and validated
usr/share/metainfo/org.openpublisher.OpenPublisher.metainfo.xmldetailing the application summary, GNU GPL v2 license, categories (Office;Publishing;), and user interface capabilities. - Desktop Thumbnailing: Added
.DirIconsymlink targetingOpenPublisher.png(256x256) at the AppDir root for file managers and desktop thumbnailers. - High-DPI Icons: Installed 256x256 PNG icons into
usr/share/icons/hicolor/256x256/apps/and scalable vector graphics intousr/share/icons/hicolor/scalable/apps/. - MIME Associations: Preserved
.opubfile format association inusr/share/mime/packages/openpublisher.xmlwith automatic desktop file bindings.
5. Exclusion of First-Run Reset Flag
- Omitted
reset_firstrun.flagfrom the AppImage payload. This ensures the First-Run Wizard only runs once and user preferences persist properly across application sessions (while keeping the flag available in the source tree for clean.runinstaller deployments).
6. Standardized Naming Convention
- Standardized the generated output binary name to
OpenPublisher-5-x86_64.AppImage, satisfying all AppImageKit and AppImageHub linters.
🧪 Verification & Validation Results
The updated AppImage build was verified through the standard Linux packaging test suite:
| Test / Check | Tool | Result | Details |
|---|---|---|---|
| Desktop Entry Validation | desktop-file-validate |
Passed | 0 errors, 0 warnings |
| AppStream Metadata Validation | appstreamcli validate-tree |
Passed | 0 errors, 0 warnings |
| Superblock Offset Integrity | Binary inspection | Passed | Valid SquashFS 4.0 superblock at offset 196,608, 1M block size, xz compression |
| Payload Verification | File tree inspection | Passed | reset_firstrun.flag excluded; openpublisher and chrome_crashpad_handler present with 0755 permissions |
| AppImage Naming Compliance | AppImage linter | Passed | Conforms to <Name>-<Version>-<arch>.AppImage pattern |
✅ Checklist Completed
- [x] Compression: Rebuilt SquashFS image using
mksquashfswith-comp xz -b 1M -root-owned -noappendfor universal compatibility. - [x] ELF Alignment: Repositioned Section Header Table so
appimage_get_elf_size()lands accurately at offset196,608. - [x] Permissions: Corrected payload permissions to
0755for directories/binaries and0644for data files, resolving sandbox access failures. - [x] AppStream Metadata: Created and validated
usr/share/metainfo/org.openpublisher.OpenPublisher.metainfo.xml. - [x] Desktop Integration: Added
.DirIconroot symlink, high-resolution icons (256x256 and SVG), and.opubMIME types. - [x] First-Run State: Omitted
reset_firstrun.flagfrom payload to prevent recurring onboarding resets. - [x] Naming Convention: Standardized binary filename to
OpenPublisher-5-x86_64.AppImage. - [x] Cachebuster Bump: Bumped all script, stylesheet, and asset cachebusters across
index.htmlandui/dashboard.jsfrom?v=5.1.10to?v=5.1.11.
🎉 Version 5.1.11 - Open Publisher