Download Latest Version openpublisher5g_amd64-windows.exe (81.1 MB)
Home / 5.5.3
Name Modified Size InfoDownloads / Week
Parent folder
5.5.3_ Per-Page Individual Themes _ Multi-Page Theme Studio Customization Persistence source code.tar.gz 2026-10-07 22.5 MB
5.5.3_ Per-Page Individual Themes _ Multi-Page Theme Studio Customization Persistence source code.zip 2026-10-07 22.7 MB
README.md 2026-10-07 12.4 kB
OpenPublisher-5-x86_64.AppImage 2026-10-07 166.4 MB
openpublisher5_amd64-windows-portable.exe 2026-10-07 183.2 MB
openpublisher5_amd64-windows.exe 2026-10-07 165.2 MB
openpublisher5_amd64-macos.dmg 2026-10-07 233.1 MB
openpublisher5_amd64-linux.run 2026-10-07 193.4 MB
openpublisher5_amd64-linux.rpm 2026-10-07 215.4 MB
openpublisher5_amd64-linux.flatpak 2026-10-07 153.6 MB
openpublisher5_amd64-linux.deb 2026-10-07 156.2 MB
openpublisher5_amd64-freebsd.pkg 2026-10-07 185.5 MB
Totals: 12 Items   1.7 GB 0

πŸš€ Summary

Version 5.5.3 of Open Publisher introduces a major creative enhancement: Per-Page Individual Themes, allowing every page in a multi-page publication to have its own completely independent background theme, custom color palette, and fine-tuned slider adjustments (or remain completely unthemed).

Prior to this release, background themes were treated as document-wide styling, meaning changing a theme affected every page uniformly. While resolving a multi-page background state desynchronization issue found by @tallulah95 in the Theme Studio, the entire background and theme lifecycle was decoupled and refactored to support true page-by-page independence.

Users who previously adjusted Theme Studio sliders (Hue Shift, Saturation, Contrast, Brightness, Texture Opacity, and Pattern Zoom) on a page also encountered a visual reset when navigating between multiple pages: upon switching to another page and returning, the live canvas reverted to its unadjusted default appearance until a slider was touched, even though the UI sliders remained in their custom positions and exported prints retained the custom hue.

With v5.5.3:

  • Per-Page Individual Themes: Each page now possesses its own dedicated themeSettings profile. Page 1 can feature a concrete texture with an emerald 180Β° hue shift, Page 2 can use a rich black leather texture with 75Β° hue, and Page 3 can remain clean, unthemed white.
  • Robust .opub Metadata Persistence: Every page's individual theme ID, palette colors, texture URL, and all 6 slider adjustments are serialized directly into the .opub file format under docData.pages[i].themeSettings. Saving, closing, and reloading a document restores every page's exact styling with 100% fidelity.
  • Synchronous Theme Restoration: Moved theme reconstruction to execute synchronously at the end of renderPage(), eliminating DOM destruction race conditions and eradicating the 500ms visual flash.
  • Immediate CSS Filter Reapplication: Background containers now receive their computed CSS filter directly upon restoration, ensuring the canvas instantly matches the slider values without requiring user interaction.
  • Complete Attribute Synchronization: Synchronized all six theme adjustment attributes (sat, bri, con, hue, tex, size) using strict definedness checks (!== undefined), ensuring 0Β° hue values and custom contrast/sizes are never lost.
  • Unthemed Page Isolation: Unthemed and ignoreBackground pages cleanly purge all data-theme-* attributes, remove orphan theme containers, and reset the Theme Studio UI controls to clean defaults via window.resetThemeStudioUI().
  • Clean Document Loading & Index Reset: io/publisher-file-loader.js now resets state.currentPageIndex = 0 on document load and safely migrates legacy document-level theme metadata without overwriting per-page styles.
  • Comprehensive Cachebuster Synchronization: Synchronized all asset queries in index.html, Service Worker cache (open-publisher-v5-5-3), and subsystem headers to v5.5.3.

🎨 New Feature: Per-Page Individual Themes

Publications often require distinct visual atmospheres across different sections: a dramatic dark cover page, textured feature spreads, and clean white body pages. In v5.5.3, Open Publisher gives users total freedom over every page's background:

  1. Independent Theme Selection: Selecting a theme from the Page Design ribbon or Theme Studio applies strictly to the currently active page.
  2. Individual Fine-Tuning: Adjusting Hue Shift, Saturation, Brightness, Contrast, Texture Opacity, or Pattern Zoom applies only to the current page. Switching pages instantly updates the UI sliders, badges, and gradient tracks to reflect that specific page's adjustments.
  3. Unthemed Flexibility: Add blank pages or toggle "Ignore Background" without losing theme styling on other pages. Unthemed pages display a crisp white canvas with controls reset to defaults.
  4. WYSIWYG Print & Export Alignment: The editor canvas, thumbnail sidebar previews, HTML export, and native PDF print spooler all render the exact per-page theme layers in perfect parity.

πŸ’Ύ .opub File Format & Metadata Storage

Individual page themes are fully preserved when saving to Open Publisher's native .opub (JSON) format.

Page Object Structure in .opub:

:::json
{
  "title": "My Magazine",
  "orientation": "portrait",
  "format": "A4",
  "dpi": 96,
  "pages": [
    {
      "id": 1728340192831,
      "width": "794px",
      "height": "1123px",
      "background": "#ffffff",
      "themeSettings": {
        "saved": true,
        "id": "concrete-wall",
        "name": "Concrete Wall",
        "type": "texture",
        "c1": "#94a3b8",
        "c2": "",
        "url": "https://www.transparenttextures.com/patterns/concrete-wall.png",
        "sat": "100",
        "bri": "100",
        "con": "100",
        "hue": "180",
        "tex": "100",
        "size": "100"
      },
      "elements": []
    },
    {
      "id": 1728340195123,
      "width": "794px",
      "height": "1123px",
      "background": "#ffffff",
      "themeSettings": {
        "saved": true,
        "id": "black-leather",
        "name": "Black Leather",
        "type": "texture",
        "c1": "#1e293b",
        "c2": "",
        "url": "https://www.transparenttextures.com/patterns/leather.png",
        "sat": "100",
        "bri": "100",
        "con": "100",
        "hue": "75",
        "tex": "100",
        "size": "100"
      },
      "elements": []
    },
    {
      "id": 1728340197456,
      "width": "794px",
      "height": "1123px",
      "background": "#ffffff",
      "themeSettings": null,
      "elements": []
    }
  ]
}

Key Metadata Guarantees:

  • Full Adjustment Fidelity: Every slider value (sat, bri, con, hue, tex, size) is stored as explicit strings, preserving values like hue: "0" or con: "125".
  • Unthemed Cleanliness: Unthemed pages store "themeSettings": null, guaranteeing that blank pages never inherit leftover theme layers upon reopening.
  • Backward Compatibility: When opening older .opub files that contain a top-level docData.themeSettings object without per-page themes, io/publisher-file-loader.js smoothly migrates the root theme onto Page 1 while leaving subsequent pages intact.

πŸ” Problems Solved & Technical Enhancements

  1. Canvas Filter Desynchronization on Multi-Page Navigation:
  2. Root Cause: core/pages.js called restoreThemeFromSave() before paper.innerHTML = '', destroying the restored theme container. While an asynchronous 500ms setInterval backup eventually recreated the DOM node, it never computed or assigned container.style.filter. Because the slider inputs already matched the page's saved values, needsUpdate evaluated to false, stranding container.style.filter empty until manual slider movement.
  3. Solution in v5.5.3: Moved restoreThemeFromSave() to run synchronously at the very end of renderPage() after all page elements exist. Both the container reconstruction routine and the existing visual verification routine now immediately invoke updateLiveFilters(), applying the CSS filter directly to .op-theme-container.

  4. Missing Theme Attributes in Page Synchronization:

  5. Root Cause: renderPage() previously omitted ts.con (contrast), ts.hue (hue shift), and ts.size (pattern zoom) when mapping themeSettings onto paper attributes, and truthy checks skipped 0 values.
  6. Solution in v5.5.3: Added full attribute synchronization in core/pages.js for all six parameters using !== undefined guards.

  7. Theme Bleed and Residue on Unthemed Pages:

  8. Root Cause: When navigating from a themed page to an unthemed or blank page, renderPage() did not remove data-theme-saved or data-theme-* attributes from #paper.
  9. Solution in v5.5.3: When renderPage() encounters a page without themeSettings or with ignoreBackground: true, it explicitly removes data-theme-saved and all data-theme-* attributes, removes any lingering [data-is-theme="true"] DOM elements, and calls window.resetThemeStudioUI() to return all sliders, numeric badges, and gradient tracks to default values.

  10. Document Loader Viewport Index Alignment:

  11. Root Cause: In io/publisher-file-loader.js, loadDocumentData() set state.pages = data.pages; and called renderPage(state.pages[0]), but omitted setting state.currentPageIndex = 0. If a user opened a file while on page 2 or 3 of an earlier session, state.currentPageIndex remained at the previous index, corrupting subsequent page switch serializations.
  12. Solution in v5.5.3: Added explicit state.currentPageIndex = 0; upon document loading, ensuring seamless page navigation from the moment a file is opened.

πŸ“ Files Modified

File Changes
core/pages.js Synchronized all six theme adjustment attributes (sat, bri, con, hue, tex, size) with !== undefined guards. Added unthemed page attribute cleanup and container removal. Moved restoreThemeFromSave() to the end of renderPage() for synchronous restoration.
core/history.js Updated serializeCurrentPage() to set page.themeSettings = null when data-theme-saved !== 'true'.
extensions/theme-studio.js Added resetThemeStudioUI(). Guarded updateLiveFilters() against writing to unthemed pages. Ensured restoreThemeFromSave() immediately executes updateLiveFilters() on both reconstructed and existing containers when filters mismatch.
io/publisher-file-loader.js Added state.currentPageIndex = 0; on load. Safeguarded legacy data.themeSettings migration so it only populates pages[0] if pages[0].themeSettings does not already exist.
sw.js Bumped Service Worker version and cache name to open-publisher-v5-5-3.
style.css Updated header comments to v5.5.3.
tools/proofing/spellcheck-engine.js Updated engine header docstring to v5.5.3.
ui/dashboard.js Bumped template index and template file fetch queries to ?v=5.5.3.
ui/modals/options-modal.js Updated modal header comment to v5.5.3.
ui/sidebar-context.js Updated sidebar context header comment to v5.5.3.
index.html Updated all 81 script, stylesheet, worker, and asset cachebuster queries to ?v=5.5.3.

βœ… Complete v5.5.3 Feature & Verification Checklist

  • [x] Individual Per-Page Themes: Verified independent themes, palettes, and slider fine-tuning per page across multi-page publications.
  • [x] Complete .opub Save & Reload Lifecycle: Serialized document to .opub JSON structure, loaded via handlePublisherFileLoad, and verified that all pages retain their exact themes, hue adjustments, and unthemed state.
  • [x] Instant Filter Application (0ms - 10ms): Verified that #paper .op-theme-container has its computed CSS filter set synchronously without requiring manual slider movement upon page switching.
  • [x] Unthemed Page Isolation: Verified that blank and "Ignore Background" pages completely clear theme layers, attributes, and reset Theme Studio UI controls to clean defaults.
  • [x] Document Loader Viewport Index Alignment: Verified that loadDocumentData resets state.currentPageIndex = 0 on file load, preventing page overwrite bugs.
  • [x] Legacy .opub Compatibility: Verified older .opub files with root-level themeSettings gracefully load onto Page 0 without crashing or corrupting multi-page workflows.
  • [x] Cachebuster Synchronization: All 81 script, stylesheet, worker, and asset cachebuster queries in index.html updated to ?v=5.5.3.
  • [x] Service Worker Cache: Bumped cache name to open-publisher-v5-5-3.
  • [x] Automated Testing: 100% pass rate across automated visual, multi-page, and persistence test suites.

πŸŽ‰ Version 5.5.3 - Open Publisher

Source: README.md, updated 2026-10-07