Converting Sozi presentations to PDF or video

Translations: Fran├žais, Portugu├¬s do Brasil, Deutsch

sozi-to-pdf and sozi-to-video are command-line tools that you can use to export a presentation to a single PDF document or to a video. The source code is available in the Sozi-export repository. These tools are independent from the presentation editor. They have been tested only for GNU/Linux.


The PDF exporter depends on pdfjam, a shell script for manipulating PDF files. The video exporter is based on libav. Users of Debian-based distributions can install the texlive-extra-utils and libav-tools packages.

apt-get install texlive-extra-utils libav-tools

Both tools are available from a single NPM package. Install node.js 0.10 or later (Linux users can use the NodeSource distributions), then:

npm install -g sozi-export

Convert a Sozi presentation to PDF

sozi-to-pdf [options] presentation.sozi.html


The width, height and resolution options specify the geometry of the browser window where the presentation is rendered. The paper and portrait options specify the page format to use in the final PDF document.

The include option is always applied before the exclude option. Frames lists have the following syntax:

For instance: -i 2,4:6,10:12:18 will include frames 2, 4, 5, 6, 10, 12, 14, 16, 18.

Convert a Sozi presentation to video

sozi-to-video [options] presentation.sozi.html


Known issues and limitations

These tools uses a headless web browser for rendering. PhantomJS and SlimerJS both have benefits and limitations:

Currently, the PDF export tool renders each frame to a PNG image and joins them into a PDF document.