Skip to content
A "zooming" presentation editor
JavaScript HTML CSS Python Shell
Branch: master
Clone or download
Latest commit db17788 Nov 17, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Link to community forum May 14, 2018
css Added help tooltips in properties view Jan 6, 2019
debian Debian control syntax Mar 9, 2018
doc Added assets for API documentation Oct 27, 2019
extras/media Presenter is now generated by editor for each presentation Dec 18, 2018
icons Added application icon Feb 18, 2014
installation-assets/linux Added file argument to Exec field of desktop file Feb 17, 2018
js Updated translation files Nov 17, 2019
locales Updated translation files Nov 17, 2019
samples Parallax example: remove frame numbers Oct 20, 2018
templates Presenter style fixes Nov 11, 2019
tools Removed index-webapp.js Oct 19, 2019
vendor/DroidSans Added placeholder and README for the Droid Sans font Aug 6, 2017
.csslintrc Better CSS. CSSLint config Apr 24, 2014
.gitignore Ignore .mo files Oct 19, 2019
.jshintrc Upgrade jshint Aug 5, 2019
Gruntfile.js API documentation in progress Oct 27, 2019
LICENSE Switched to the Mozilla Public License 2.0 Oct 12, 2014
README.jsdoc.md Added assets for API documentation Oct 27, 2019
README.md Added debug info to README Nov 16, 2019
config.default.json Updated README and versions Nov 11, 2019
config.linux-x64.json Upgraded to Electron 6 Aug 5, 2019
index-electron.html Force production mode for inferno Oct 19, 2019
index-webapp.html Removed dependency to bower: fontawesome installed as node module Jan 12, 2019
jsdoc.json Completed documentation of the Controller class Oct 27, 2019
package-lock.json JSDoc : Added @extends Nov 9, 2019
package.json Updated README and versions Nov 11, 2019

README.md

Github Downloads (latest) Github Downloads (total)

Sozi is a presentation tool for SVG documents.

It is free software distributed under the terms of the Mozilla Public License 2.0.

More details can be found on the official web site: http://sozi.baierouge.fr

Building and installing Sozi from sources

Get the source files

Clone the repository:

git clone git://github.com/senshu/Sozi.git

Install the build tools and dependencies

Install Node.js and the Grunt CLI. The build script for Sozi is known to work with Node.js 11 from Nodesource. If you plan to build a Windows executable from Linux or OS X, also install wine. In Debian/Ubuntu and their derivatives, you can type the following commands.

sudo apt install nodejs wine
sudo npm install grunt-cli -g

If you plan to build Debian packages, install the following additional packages:

sudo apt install devscripts debhelper

From the root of the source tree:

npm install

Install the Droid Sans font:

  • Droid Sans as vendor/DroidSans/DroidSans.eot|ttf and vendor/DroidSans/DroidSans-Bold.eot|ttf

Build

To build the desktop application for all platforms, run the following command from the root of the source tree:

grunt

After a successful build, you will get a dist folder that will contain the generated application archives for each platform.

You can customize the build by creating a custom configuration file. See config.default.json and config.linux-x64.json for examples. For instance, if you want to build 64-bit executables for OS X and Linux, the configuration file (config.linux-darwin-x64.json) will look like this:

{
    "platforms": [
        "darwin-x64",
        "linux-x64"
    ]
}

Then run Grunt with the --config option:

grunt --config=config.linux-darwin-x64.json

Other Grunt tasks are available for developers:

Command Effect
grunt electron-archive (default) Build the desktop application and create zip archives for various platforms.
grunt deb Build Debian packages.
grunt electron-build Build the desktop application without creating archives.
grunt web-build Build the web application without uploading it.
grunt pot Extract a template file (locales/messages.pot) for translation.
grunt jsdoc Generate the API documentation.

Install

Since Sozi 18.01, a Debian package is available for users of Debian or Ubuntu-based distributions.

sudo dpkg -i sozi_[...].deb

For other platforms, Sozi is released as a zip/tar.xz archive that you can extract wherever you like.

  • OS X users can drag the Sozi.app subfolder into their Applications folder.
  • Windows and Linux users can run the Sozi executable directly from the extracted folder.

If installation on your specific platform is supported by Sozi, there will be an install folder in the extracted archive containing installation scripts. To install Sozi system-wide:

cd Sozi-[...]/install
sudo ./install.sh

To install Sozi in your home folder:

cd Sozi-[...]/install
./install-local.sh

In many situations, Sozi will not need additional software to be installed. If Sozi complains about missing libraries, here is the list of all the known runtime dependencies of the Sozi executable:

libasound2
libatk1.0-0
libc6
libcairo2
libcups2
libdbus-1-3
libexpat1
libfontconfig1
libfreetype6
libgcc1
libgconf-2-4
libgdk-pixbuf2.0-0
libglib2.0-0
libgtk2.0-0
libnspr4
libnss3
libpango-1.0-0
libpangocairo-1.0-0
libstdc++6
libx11-6
libx11-xcb1
libxcb1
libxcomposite1
libxcursor1
libxdamage1
libxext6
libxfixes3
libxi6
libxrandr2
libxrender1
libxss1
libxtst6

Helping debugging Sozi

While Sozi is running, press F12 to open the developer tools. Check the Console tab for error messages.

Some environment variables will enable debugging features in Sozi:

  • ELECTRON_ENABLE_LOGGING=1 sozi my-presentation.svg will display JavaScript console messages in the current terminal window.
  • SOZI_DEVTOOLS=1 sozi my-presentation.svg will open the developer tools immediately. This can be useful if F12 has no effect or when you want to debug events that happen at startup.
You can’t perform that action at this time.