Prerequisites for the workshop

This workshop is meant to be hands-on and interactive. This means you have the option of installing the software and playing with it during the workshop. We would prefer not to spend time during the workshop getting everyone setup, so some things are needed in advance of the workshop.


You will find the workshop more useful if you are able to work with your own images. Although IIIF will work with most image formats for this workshop please convert them to JPEGs. Images of your digitised collections will work well if you are able to bring them.

All machines need the following

For the South Africa workshop there will be some computers available with some of the software pre-installed. If you are brining your own laptop you will need to install all parts but for the provided desktop machine you will only need to install the first two:

1. JSON Viewer

The IIIF APIs provide many of their responses using the JSON format so it is useful to have a viewer which will format this response to make it easier to read. There is a similar plugin for Firefox but as this workshop also uses other Chrome plugins it is recommended to use Chrome.

2. Web Server

For this workshop we will use the Chrome Web Server which is a Chrome browser plugin. It will allow us to play with local IIIF assets. Install from:

And follow these instructions to check the Web server is working.

Personal laptop only requirements:

If you have brought your own machine then you will also need to install the following:

3. Java

In this workshop we will install and run a IIIF Image server and for this you will need Java 11 installed.

To verify you have the correct package installed, you can run the following command from a terminal or command prompt:

$ java -version
# java version "1.11.0_102"

You should see version 1.11.x. For more information on the install options see:

4. Using a text editor

We recommend some familiarity with a text editor before coming to the workshop. If you don't know which text editor to choose, a good, free, open source option is atom.

In this workshop, we will be running commands from a terminal / command prompt. No need to be an expert, but you can get familiar in advance.

If you need help navigation around your computer using a terminal, checkout these quick exercises:

Last modified by Glen Robson 2022-02-17 01:10:04
Created by Glen Robson 2022-02-17 01:10:04

results matching ""

    No results matching ""