Preliminary

For oStorybook to function you must have Java installed, (minimum version 1.8.0_45.). However, the use of Java 11, or even 17, did not show any difficulty.

For Windows users

1. Download the exe file, with name oStorybook-X.y.z.exe (X,y.z indicate the version)
2. Start the installation by running this file (Double click on this file to start the installation)

For Mac OS X users

1. Download the tar.gz file and commence installation in the usual way

For any Debian based systems:

1. Download file oStorybook-X.y.z.deb;
2. Open a terminal window and run the usual installation command

sudo dpkg -i oStorybook-X.y.z.deb

3. Check that a shortcut has been created on your Desktop (if you are using Gnome). If not, make a shortcut using your usual method.

The ArchLinux community will provide standard packaging for their system: see here

For other Linux distributions, or in case of difficulties, use this method of installing the Zip file:

1. Download the file oStorybook-X.y.z.zip.
2. Extract its content into a local folder (I recommend naming the folder oStorybook, for easy identification)
3. Check that the file oStorybook.jar or Storybook.jar is in that folder.
4. Use the .bat or .sh file to build the correct program launcher for your operating system