| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| 5.19.2_ Web Application File Saving Restoration, Defensive File System Fallback _ Version Synchronization source code.tar.gz | 2026-11-08 | 103.6 MB | |
| 5.19.2_ Web Application File Saving Restoration, Defensive File System Fallback _ Version Synchronization source code.zip | 2026-11-08 | 104.1 MB | |
| README.md | 2026-11-08 | 8.5 kB | |
| OpenPublisher5-i386-windowsXP.exe | 2026-11-08 | 56.5 MB | |
| openpublisher5_amd64-windows-portable.exe | 2026-11-08 | 183.2 MB | |
| openpublisher5_amd64-windows.exe | 2026-11-08 | 165.2 MB | |
| openpublisher5_amd64-macos.dmg | 2026-11-08 | 233.1 MB | |
| openpublisher5_amd64-linux.run | 2026-11-08 | 193.4 MB | |
| openpublisher5_amd64-linux.rpm | 2026-11-08 | 215.4 MB | |
| openpublisher5_amd64-linux.flatpak | 2026-11-08 | 153.6 MB | |
| openpublisher5_amd64-linux.deb | 2026-11-08 | 156.2 MB | |
| openpublisher5_amd64-linux.AppImage | 2026-11-08 | 166.4 MB | |
| openpublisher5_amd64-freebsd.pkg | 2026-11-08 | 185.5 MB | |
| Totals: 13 Items | 1.9 GB | 0 | |
π Summary
Version 5.19.2 resolves a critical file saving issue on the OpenPublisher web application where clicking Save or Save As previously failed to download or prompt due to an unintended desktop client detection trap. Standard web browser sessions were inadvertently identified as desktop client shells, causing save requests to route into the native desktop IPC bridge (which logs data to the console for a host wrapper rather than initiating a browser download).
This release permanently removes the misleading detection traps, restores seamless saving and file downloads across all modern and legacy web browsers, implements a defensive multi-tier fallback for the File System Access API, and preserves 100% of the native atomic save bridge for installed desktop applications (NW.js, Electron, and webview wrappers). Application asset cachebusters, the Service Worker cache bucket (open-publisher-v5-19-2-1), and the About dialog have been fully synchronized to v5.19.2.
π’ Community Note: Getting Support & Reporting Issues
[!IMPORTANT] Need help or noticed a problem? Please reach out to us directly!
We recently discovered this web file saving issue after noticing queries on Copilot and AI search engines asking why documents were not saving on
openpublisher.app. Because all developer regression testing had been conducted on the native desktop application variant (where the atomic save bridge worked normally), this web-only issue went unnoticed in prior releases.We want to make sure everyone has a smooth experience, and we could have resolved this much sooner had we known. Please remember that direct links to both our GitHub repository and Facebook page are always available right inside the application's About dialog (
File->About). If you ever experience unexpected behavior, have feature suggestions, or need assistance, please do not hesitate to contact us:
- Email Support: info@openpublisher.app
- GitHub Issues: github.com/rmellis/open-publisher/issues
- Facebook Page: facebook.com/people/OpenPublisher-Free-Desktop-Publishing (www.facebook.com)
π Problems Solved & Root Cause Analysis
1. The Startup Self-Triggering Trap (index.html)
- Background: In version 5.7.2, early property traps (
Object.defineProperty) were added to<head>inindex.htmlto help suppress PWA download buttons when running inside native desktop wrapper shells. Among these traps was a list of animation callbacks:javascript ['startDesktopSaveAnimation', 'finishDesktopSaveAnimation', 'startDesktopLoadAnimation', 'finishDesktopLoadAnimation', 'extractDocumentSnapshot'] - The Issue: In version 5.18.0,
extensions/system-patches.jsdefinedwindow.finishDesktopSaveAnimation = function() { ... }as part of its core startup logic to synchronize document titles after native saves. - The False Positive: The moment
system-patches.jsloaded in any standard browser, assigningwindow.finishDesktopSaveAnimationtriggered the setter inindex.html, immediately invokingmarkAsDesktopClient(). This taggedwindow._isDesktopClient = trueand added theis-desktop-appclass todocument.bodyacross all web sessions. - The Failure: When users clicked "Save" or "Save As" on the web application,
isDesktopEnvironment()returnedtrue. The save engine routed into the desktop bridge:javascript console.log('OP_IPC:' + JSON.stringify({ type: 'OP_SAVE_DATA', payload: payloadStr })); return;In installed desktop wrappers, a background Node/NW.js process intercepts this console output to write files to disk. In a standard web browser, it simply logged a string to DevTools and returned immediately without downloading or prompting.
2. Resolution: Clean Web Mode & Preserved Desktop Bridge
- Removed Animation Traps: Deleted the legacy callback property traps from
index.html. Web sessions now load strictly in web mode (isDesktopApp() === false). - Preserved Desktop Bridge Integrity: Native desktop wrapper detection remains 100% operational through genuine wrapper injection hooks:
window._opBridgeActivereactive property trapwindow.desktopIPCreactive property trap- Computed style inspection on
#coord-display(z-index: 999999andtranslateY(-15px)injected viawebview.insertCSS) - macOS theme detection (
mac-themeon body) - Direct runtime environment checks (
nw,process.versions.electron, and application user agent) - Desktop client applications continue to benefit from atomic disk writes, AES-GCM encryption, snapshot extraction, and file path detachment (
OP_NEW_DOC).
3. Defensive Multi-Tier File System Access API Fallback (extensions/system-patches.js)
- Chromium Native Picker: In supported modern desktop browsers (Chrome, Edge, Opera), saving uses
window.showSaveFilePickerwithsuggestedName: currentTitle + '.opub', opening the native OS Save dialog and automatically renaming the publication in the title bar upon save. - Defensive Catch Fallback: In prior versions, if
showSaveFilePickerthrew an error other thanAbortError(e.g.SecurityErrordue to missing user activation or strict iframe sandbox permissions), the error was logged with no secondary action. The catch block now automatically falls back to generating a direct.opubfile download via a dynamic<a>tag with blob URL. - Clean Cancellations: User cancellations (
AbortError) continue to exit cleanly without creating unwanted downloads.
4. Cross-Browser Save As Support (extensions/system-patches.js)
- Firefox, Safari & Mobile Browsers: In browsers lacking the File System Access API, clicking Save As displays OpenPublisher's built-in modal dialog prompting the user for a new document name before generating a direct
.opubfile download with the updated title. - Modern Chromium Browsers: Clicking Save As launches the OS file picker with the existing title pre-populated, allowing immediate renaming and folder selection.
π Version Synchronization (v5.19.2)
| Component | Target Version | Updated Reference |
|---|---|---|
| Service Worker | v5.19.2 |
open-publisher-v5-19-2-1 in sw.js |
| About Dialog | v5.19.2 |
Free Online Desktop Publishing Tool β’ v5.19.2 in extensions/ui-interactions.js |
| UI Interactions Header | v5.19.2 |
Header documentation in extensions/ui-interactions.js |
| PWA Installer | v5.19.2 |
Registration query sw.js?v=5.19.2 in extensions/pwa-install.js |
| Application Cachebusters | v5.19.2 |
All 98 script and stylesheet links updated to ?v=5.19.2 in index.html |
| Dashboard Controller | v5.19.2 |
Template asset cachebusters updated to ?v=5.19.2 in ui/dashboard.js |
| Template Asset Loaders | v5.19.2 |
getTemplateAssetUrl updated to ?v=5.19.2 in elements/templates/templates.js |
| README Documentation | v5.19.2 |
Badge asset cachebusters updated to ?v=5.19.2 in README.md |
β Checklist Completed
- [x] Restore Webapp Save and Save As file downloads across Chrome, Edge, Firefox, and Safari
- [x] Remove legacy animation callback property traps in
index.htmlpreventing false desktop client tagging - [x] Implement defensive blob download fallback on
showSaveFilePickererrors inextensions/system-patches.js - [x] Verify native desktop client bridge preservation (
OP_SAVE_DATA/OP_NEW_DOC) across all tests - [x] Add prominent support and community note with email, GitHub, and Facebook contact options
- [x] Bump Service Worker cache bucket to
open-publisher-v5-19-2-1insw.js - [x] Synchronize application version and About dialog subtitle to
v5.19.2inextensions/ui-interactions.js - [x] Update all asset cachebusters across
index.html,ui/dashboard.js,elements/templates/templates.js, andREADME.mdto?v=5.19.2 - [x] Maintain clean local git status ready for user push
π Version 5.19.2 - Open Publisher