Continue to the content

Workshop Working with IIIF images in education, communication and research

Survey on the impact of this workshop

Have you already attended the Mmmonk IIIF Workshop? If so, we would be very grateful if you could spare five minutes of your time to complete our questionnaire.

We will use the results for a presentation on IIIF education at the IIIF conference at the Getty Museum and UCLA in Los Angeles in June. With our presentation, we aim to contribute to improving the usability of IIIF for individual end-users.

About the Workshop

  • Topic: The benefits of digital Images in IIIF format for education, research, and public engagement.
  • Focus: Medieval manuscripts, but also applicable to other types of objects.
  • Methodology: Brief explanation + inspiring examples + assignments for participants.
  • Intended audience: No IT knowledge required. Suitable for anyone working with digital images of books, paintings, prints, coins, etc. Previous participants include staff and students at: KU Leuven, Ghent University, European Lettering Institute, Columbia University, Flemish Heritage Libraries, National Library of Slovenia, York University, University College Cork, IIIF Consortium, Musea Brugge, the Flemish Institute for Archives, Ghent University Library and the Library of Congress.
  • Practical information: 120 minutes, in-person or online.
  • Interested? Contact us to schedule a workshop at your institution or explore the workshop at your own pace below. We particularly welcome 'train-the-trainer' sessions.

IIIF in a really tiny nutshell

  • IIIF = International Image Interoperability Framework
  • Digital innovation for more efficient and sustainable management, sharing, and use of digital images. A brief explanation of IIIF can be found here.
  • Applied by a growing number of institutions worldwide, for instance BnF, Vatican Library, Getty Museum, University Libraries of Ghent/Cambridge/Hongkong/São Paulo/Lagos, the Smithsonian, and the French National Archives. Check out the community map of IIIF implementations.
Map of IIIF implementations
Map of IIIF implementations - Source: https://iiif.io/community/map/

Some benefits of IIIF for end-users

  1. Smaller carbon footprint: IIIF eliminates unnecessary duplication of images and supports minimal computing. As a result, we need less energy for servers and data transfer.
  2. Easy and enhanced viewing options across institutions: Thanks to IIIF, digital images are no longer confined to local systems. Say goodbye to switching between different websites and user interfaces! You can seamlessly bring together images from various institutions in a uniform working environment.
  3. Dynamic images with rich context: When you use a IIIF image in editorial content (e.g. blog or virtual exhibition), your reader has the option to zoom out to see the larger picture and has access to additional information in the metadata descriptions.
  4. Open source tools for working with images in education, communication, research, and even gaming.
  5. Community: IIIF is developed by an enthusiastic community of cultural heritage specialists and IT developers. The results are always open source, allowing everyone to contribute to innovation.

Visit the IIIF Consortium website for more information on the benefits of IIIF.

Good to know before you start

  • Bookmark this page. We'll often refer to external websites.
  • Manifest URLs: Every digital object (book, painting, drawing, sculpture...) that is available in IIIF has a manifest URL. The manifest URL is the key to use this object in IIIF tools. But... not every object is available (yet) in IIIF.
  • IIIF tools and websites do not depend on the institutions (libraries, museums, archives) that manage collections. They are developed by a community of developers and special collections specialists.
    • Viewers are designed to consult manuscripts. Universal Viewer and Mirador are two of the most widely used IIIF viewers.
    • Guided viewing tools are designed to create virtual tours. Mmmonk works with the Exhibit tool, but there are other tools available.
    • The IIIF Consortium website contains a list of interesting IIIF tools.

Find and copy the manifest URL

What are we looking for?

A manifest is the "packaging" in json code for the digital images and metadata. Each manifest has a URL (i.e. the information in your browser's address bar). This URL is stable and is the key to work with the images and metadata.

A manifest URL contains the words IIIF and manifest(s). For instance:

IIIF is used by a growing number of institutions, but is not yet used everywhere, so the object of your choice might not yet have a manifest URL.

Some examples of where and how to find manifest URLs

Specific institutions: Look for the words 'IIIF manifest URL' or the IIIF logo in the metadata (descriptions) of an item in the institution's online catalogue. Some examples, all starting from an item's individual record (catalogue description):

  • Ghent University Library > go to ‘For developers’
  • KU Leuven > go to ‘View online’ > open the manuscript in Teneo > go to ‘information’ (‘Permalink IIIF manifest’)
  • Gallica BnF > click on the IIIF logo in the left sidebar > click on the information 'i' logo in the right upper corner to open the metadata for the object > the manifest is at the bottom of the metadata
  • Cambridge University Digital Library Many options, among others the obvious 'Manifest URL' button.
  • Getty Museum > Filter on 'open content images' > search for object > manifest is at the bottom of the record, under 'APIs & other identifiers'
  • Musea Brugge > manifest is at the bottom of the record, under 'Linked Open Data'
  • Library of Congress > 'manifest' is listed at the bottom of the record > open the manifest > copy the URL
  • For an extensive (but not exhaustive) list, visit the Guides to finding IIIF resources on the IIIF.io website.

Global platforms with IIIF resources (not exhaustive):

  • Biblissima IIIF Collections: This website tries to gather all of the available manifests of manuscripts and rare books in the world (but is not exhaustive yet). Some 100.000 IIIF compliant manuscripts and rare books! Includes giant collections like Gallica (BnF) and e-codices.
  • Fragmentarium: Circa 5400 IIIF compliant medieval manuscript fragments.
  • Internet Archive: Millions of texts, images, audio and video available in IIIF. The manifests URLs are not published but can be reconstructed quite easily by inserting an item's identifier into a URL structure (see this 3-step guide).
  • FranceArchives: National aggregator for French archives. IIIF already implemented for these collections, and growing.
  • Wikidata: Contains manifest URLs for thousands of objects (but not consistently). You can search directly in Wikidata, or search for the item you are interested in on Wikipedia > click on 'wikidata item' > the manifest URL is listed under 'statements' (e.g. The Kiss by Gustave Klimt).

Mmmonk: Go to the page of a manuscript (e.g. this breviary) > the link is right below the viewer.


Copy the URL

  • Select and copy the URL. This is the key you need to work with this object.
  • Sometimes it will also be possible to drag and drop the IIIF logo next to the URL.
  • If you click on the URL, the manifest will open in your web browser. You will see a page filled with json code. Don't panic! You don't need the code, only the URL.


Shortcut for this workshop

For the purpose of this workshop you can save time by using manifests from our hand-picked list of interesting items.


Assignment

Find the Manifest URL for one of the items below. Share the URL in the meeting chat or show it to the workshop leader.

  • Musea Brugge: Jheronimus Bosch, Last Judgment, ca. 1500 (inv. 0000.GRO0208.I)
  • Victoria & Albert Museum: Unknown artist, The Dacre Beasts - The Red Bull, ca. 1507-1525 (inv. W.6:1 to 5-2000)
  • Gallica (Bibliothèque nationale de France): La New Home [machine à coudre] : médaille d'or, Paris 1889 : [affiche]

Share a detail on an image via Universal Viewer

You have found an interesting detail in a manuscript and wish to share this with someone or to save it for yourself. Instead of downloading the image or taking a screen shot, you can share or bookmark a URL with coordinates.

Detail of an image in Universal Viewer
Detail of an image in Universal Viewer

How to

  1. Select and copy the manifest URL of the object of your choice, for instance https://sharedcanvas.be/IIIF/m....
  2. Open the website https://universalviewer.io/
  3. Copy the URL to ‘Paste the URL of a IIIF manifest here to see the UV in action!’
  4. Browse the manuscript and zoom in on an interesting detail. (Watch how the coordinates in the URL change as you zoom or move. The coordinates make it possible to share a specific area of an image.)
  5. Copy the URL with the coordinates or use the share button in the viewer. Share the URL in a message, copy it to a document, or bookmark the page.

Assignment 1 (manuscript)

Find the coat of arms of Abbot Jan Crabbe in Ms. 157/188 from Bruges Grootseminarie. Zoom in on this detail and share it with another participant (via chat or mail) or save it in your browser.

manifest URL https://sharedcanvas.be/IIIF/m...

Assignment 2 (painting)

Find the parakeet on the painting Madonna with Canon Joris Van der Paele by Jan van Eyck (Groeningemuseum Bruges). Zoom in on this detail and share it with another participant (via chat or mail) or save it in your browser.

manifest URL painting: https://dam.museabrugge.be/iii...

Compare objects in Mirador

You have found an interesting manuscript at the British Library and wish to compare it with a manuscript from Bruges Public Library and a painting from the Getty Museum in Los Angeles. Each of these institutions has their own viewers, with specific rules and functionalities. This can be burdensome for researchers, going back and forth between websites. The Mirador viewer allows you to gather these objects (images + descriptions!) in a single uniform viewing environment.

Comparing cyclopes in the Mirador viewer
Comparing cyclopes in the Mirador viewer

How to

  1. Select and copy the manifest URL of your object.
  2. Open the website https://mirador-dev.netlify.app/__tests__/integration/mirador/. (Close the examples by Van Gogh and of Krishna.)
  3. Click ‘start here’.
  4. Click ‘add resource’.
  5. Add the manifest URL and click ‘add’. Your object is now the first in the list of resources.
  6. Click on your object to add it to your collage.
  7. Repeat these steps as often as you wish to add objects to your collage.
  8. Save your collage by clicking on the three dots in the menu on the right. Hit 'export workspace' > ‘view workspace configuration’, select the body of text and save it to a document or notepad for later use. Open a collage by importing the saved text into ‘import workspace’.

Assignment 1 - Compare two manuscripts

Compare two manuscript copies of De natura rerum by Thomas of Cantimpré. Open both books on the folio with a miniature of a cyclops.

Assignment 2 - Create your own collage

Find images of a specific iconographical topic using the Biblissima Portal. Make a collage in Mirador with at least three images.

Tip: Take into account that the website's descriptions are written in French and/or English. Searching for terms like Apocalypse, dragon, Jerusalem… yields the best results for this assignment.

Assignment 3 - Add items to an existing collage

We have prepared collages on Behemoth, Boethius, Juvenal and cyclopes for you to play with.

  • Go to this page,
  • select a collage,
  • import the code into a Mirador workspace,
  • and start adding items to the collage.

Create a virtual tour with Exhibit

You'd like to create an online exhibition on one or more manuscripts. Instead of collecting, cropping and uploading images, you can collect manifest URLs in the Exhibit tool. You can even alternate the images with YouTube videos for a more dynamic effect. Visitors can zoom in and out on the images and can easily consult the metadata of the images. As a result, the images are not separated from their context!

Creating a virtual tour with Exhibit
Creating a virtual tour with Exhibit

Examples

How to

  1. Go to https://mmmonk.vercel.app/ > ‘Create an Exhibit’
  2. Choose the format (Kiosk plays automatically, Scroll lets visitors scroll through the tour, Slide is a slideshow, Quiz presents multiple choice questions)
  3. Fill in the required fields and ‘create exhibit’. You can always come back to this menu to make changes.
  4. Bookmark the URL or save it in a document. Exhibit does not use accounts and log-ins. The URL is the only way to return to your work.
  5. Click ‘add item’.
  6. Paste a manifest URL in the bar at the bottom and click 'import'.
  7. Select this resource in the list of resources and hit 'add to exhibit'.
  8. Browse through the manuscript to the page of your choice and zoom in on the detail of your choice.
  9. Hit the '+' bar ('add new'). This opens the annotation module. Write your annotation. You can still modify the image at this point.
  10. Hit the 'check' button below the annotation to save the annotation and the image. Would you like to show another page in the same manuscript? Then browse through the manuscript to the detail of your choice, click on '+', and create a new step in your tour.
  11. Add as many items/resources as you wish. This can also be a YouTube video.
  12. Go to 'preview' to preview your tour. Hit 'share' to share or embed your tour.

Troubleshooting

Error report when you import a manifest? Is it possible you've already added this manuscript and that it is already in your list of resources? If not, check the URL for errors.

Assignment

Select a few manifest URLs from our list and create a tour or quiz. (Bookmark the URL of your workspace!)

Alternatives

Currently, Exhibit and Storiiies are the most popular free IIIF storytelling tools. What are the main differences?

  • Exhibit accommodates book materials (i.e. manifests with multiple images = pages or folios) and allows you to integrate YouTube videos into the guided viewing.
  • Storiiies is very popular in museums. It allows you to work with one single image. Access the free editor tool here. Some neat examples here, including a guided viewing of Hans Holbein's The Ambassadors.
  • Annonatate has the advantage that you can save your work to a Github repository. But this means you need some familiarity with data management to work with Annonatate.
  • A bit more advanced: create digital archives and exhibitions with Padlet, Google Sites, CollectionBuilder or Wax. See the Minimal Digital tutorials by Alison Harvey (AHRC-RLUK).
  • List of other tools on the IIIF Consortium's website.

Embed a viewer on your website

You have written a blogpost or have created an online course on manuscripts (or other objects). Instead of uploading static images to your website, you can embed a IIIF-viewer to offer a richer experience to your audiences.

This viewer is embedded on this webpage. You can still zoom in or out, leaf through the book, and you have access to the metadata.

Benefits

Enjoy the functionalities of a viewer (vs. a static, flat image): show a detail but keep the option to zoom out + direct access to metadata descriptions + high resolution + quick + no need to download/save/crop/upload/host images (and pay for server capacity and hosting).

Examples

How to

  1. Retrieve the iframes or div embed code via Universal Viewer (> ‘share’). This functionality is sometimes also available in customized viewers on institutional websites.
  2. Embed the iframes code as an alternative for an uploaded jpg in the CMS of your website. Ask your supplier to provide this option when you design a website.

When you use the iframes code, you (the editor of the webpage) will be able to zoom in on a specific detail (via URL coordinates). This is not an option with div code.

Online course with embedded IIIF viewers (https://spotlight.vatlib.it/latin-paleography)
Online course with embedded IIIF viewers (https://spotlight.vatlib.it/latin-paleography)

Download an image

Although IIIF makes it easy to return to online images (and even details on them), sometimes you just want to download an image. No problem, this is still possible with IIIF!

How to

  1. Go to https://universalviewer.io/
  2. Paste the manifest URL into the bar and hit ‘view’.
  3. Click on the download logo in the lower left corner of the viewer. Select one of the options. 'Source image file (tiff)' will download the image as it was uploaded by the institution.

Rights and attribution

Always verify and respect the conditions for use of the images stated by the owner of the images. The website creativecommons.org can help you understand what the different types of CC licences entail for reusers.

Next level

Some next level tricks to facilitate your use of IIIF resources. Under construction.

Collect manifest URLs with DetektIIIF

DetektIIIF is a browser extension for Chrome and Firefox that detects IIIF resources in websites. It is possible to collect IIIF manifests in a basket and send them to any compatible IIIF application, for instance Mirador and Universal Viewer.

Online training by the IIIF Community

Our Mmmonk workshop focuses on the use and reuse of IIIF images. Do you want to continue learning about IIIF? Then we highly recommend the 5-day online course by the IIIF Community.

The workshop is split into 5 different areas which are covered over the course of 5 days:

  • Day 1 - IIIF Basics
  • Day 2 - Image API Understand what the Image API provides; Be able to change a Image API URL to get access to different parts of an image; Understand the different types of Image API implementations (level0, level1 etc); Know the tools that work with the Image API so you can test your Image API server
  • Day 3 - Presentation API Create, edit and publish a manifest
  • Day 4 - Annotations Create, edit and publish annotations
  • Day 5 - Project demos

Still not enough? You can find advanced training materials at https://training.iiif.io and at https://iiif.io/get-started.

IIIF support on Slack

Ask help from the community on Slack! There are dedicated channels for beginners, AV, libraries, museums, IIIF in the classroom...

Awesome IIIF Github

On the Awesome IIIF Github page you'll find helpful links around each of the standards, demonstrations of their use, and tutorials and presentations. The list is especially helpful for orienting new community members and developers.

IIIF Flanders & Netherlands

The IIIF Flanders & Netherlands Network Group (Collegagroep IIIF Vlaanderen en Nederland) provides opportunities to share knowledge and expertise about IIIF among IIIF builders and IIIF educators active in Flanders and the Netherlands. The collective organizes events (e.g. IIIF Friday webinars) and provides tutorials and trainings.

Reduce your digital carbon footprint

"In 2020, EY suggested that digitalization already accounted for 4 percent of global GHG emissions – nearly twice the human carbon dioxide emissions generated by the aviation industry."

"Many organizations do not consider their data carbon footprint and are unknowingly burdened with wasteful digital practices like data duplication, leading to a rise in carbon dioxide production."


(Source: Decoding the digital carbon footprint: exposing the global data challenge, 2020 The Chronicle of Higher Education)

Looking for more ways to reduce the carbon footprint of your work with digital heritage collections? The webinar 'How to create more climate-friendly communications' by Europeana Pro contains useful tips.

Transcribe IIIF manuscripts with FromThePage or Transkribus

FromThePage and Transkribus, two useful tools to digitally transcribe manuscripts, support IIIF.

Drag and drop items into Chronoscope World

Chronoscope World is a viewer initially designed for enhanced exploring of maps. But the viewer can also be used to open any type of IIIF compliant object, e.g. books. The advantage of Chronoscope World as a viewer is that you can drag and drop the IIIF logo or a thumbnail from an online catalogue into the Chronoscope workspace to quickly open the whole book. This makes it a good tool to quickly sift through hundreds of images when you don't really know what you are looking for.

Sparql queries in Wikidata for compounded searches

Wikidata has over 200.000 manifest URLs. Use the Query Service or the Query Builder to generate compounded searches for IIIF items (property 'IIIF Manifest URL', P6108). Find a short guide here.

Live workshops IIIF

This page is used during live workshops by Mmmonk at higher education and GLAM institutions (e.g. KU Leuven, European Lettering Institute, Ghent University, Columbia University, York University). Contact us if you would like to introduce students and staff at your institution to the benefits of working with IIIF in education, communication and research.