Tips & Tricks

• Migrating Sozi Presentations to PDF

Migrating Sozi Presentations to PDF

Convert Sozi Presentations to PDF

Convert exported .sozi.html presentations into PDF files using the official Sozi exporter or a lightweight Node.js-based migration script.

Overview

Sozi is an SVG-based presentation tool that creates zooming and animated presentations. Presentations are typically exported as a single .sozi.html file.

If you need a printable, archivable, or shareable version, you can convert the presentation into a PDF.

TL:DR

# Install exporter
npm install -g sozi-export

# Install pdfjam (macOS)
brew install texlive

# Convert presentation
sozi-to-pdf presentation.sozi.html presentation.pdf

Or use the lightweight alternative:

node sozi-pdf-migrations.js

Option 1: Official Sozi Export

The recommended approach uses sozi-export, which understands Sozi's frame definitions and exports each frame exactly as designed.

Prerequisites

Install:

• Node.js
• sozi-export
• pdfjam (included in TeX Live)

Install Sozi Export

npm install -g sozi-export

Install pdfjam

macOS

brew install texlive

Ubuntu / Debian

sudo apt install texlive-extra-utils

Windows

Install TeX Live:

https://www.tug.org/texlive/

Convert a Presentation

sozi-to-pdf presentation.sozi.html presentation.pdf

Each Sozi frame becomes a separate PDF page.

Batch Conversion

macOS / Linux

for f in *.sozi.html; do
  sozi-to-pdf "f""{f%.sozi.html}.pdf"
done

Windows PowerShell

Get-ChildItem *.sozi.html | ForEach-Object {
  sozi-to-pdf .Name(_.Name -replace '\.sozi\.html$', '.pdf')
}

---

Option 2 — Node.js Migration Script

If you already have Node.js/npm available and do not want to install TeX Live or pdfjam, you can use the custom migration script provided by LNC Docs Resources.

This provides a lightweight alternative for converting Sozi presentations to PDF using only npm-based tooling.

Download

• sozi-pdf-migrations.js

Usage

node sozi-pdf-migrations.js

Use this approach when you want to avoid installing TeX Live and only require a Node.js-based solution.

---

Troubleshooting

pdfjam executable not found

Verify that pdfjam is installed:

which pdfjam

If required, add TeX binaries to your PATH:

export PATH="/Library/TeX/texbin:$PATH"

Missing Frames

Ensure you convert the exported .sozi.html file and not the original .svg file.

Correct

presentation.sozi.html

Wrong

presentation.svg

DeckTape Errors or Timeouts

Generic presentation exporters such as DeckTape do not provide native Sozi support and may produce detached-frame errors or timeout during export.

Use either:

sozi-to-pdf

or the provided

sozi-pdf-migrations.js

script instead.

---