Tamerlane is a lightweight IIIF (International Image Interoperability Framework) viewer built to make exploring, navigating, and searching annotated IIIF Presentation 3.0 resources simple and intuitive. Rather than aiming to be feature‑heavy, it focuses on delivering a clear, user‑friendly experience for working with annotated resources.
IIIF Cookbook: Basic Newspaper
A demo of the viewer is available with content from the Wellcome Collection: The chemist and the druggist. Please note, search is only available for Content Search 2.0 endpoints.
To explore your own IIIF Presentation 3.0 Manifest or Collection, simply enter its URL on the Tamerlane demo site.
The following example demonstrates searching a collection that has been indexed using the Annosearch search service:
- Clone the repository:
git clone https://github.com/tamerlaneviewer/tamerlane.git
cd tamerlane- Install dependencies:
npm installnpm startOpen http://localhost:3000 to view the application.
npm run build# Build the Docker image
docker build -t tamerlane .
# Run with docker-compose
docker-compose up-
Via URL Parameter:
http://localhost:3000?iiif-content=https://example.com/manifest.json -
Via Interface: Use the URL input dialog to load a manifest or collection
-
Environment Variable: Set
REACT_APP_IIIF_CONTENT_URLfor a default manifest
The simplest way to embed Tamerlane into any static HTML page is by using an iframe.
Create an HTML file with the following content, and the viewer will be embedded directly into the page.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Tamerlane Embedded Viewer</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<style>
html, body { margin: 0; padding: 0; height: 100%; }
iframe { width: 100%; height: 100%; border: none; }
</style>
</head>
<body>
<iframe
src="https://tamerlaneviewer.github.io/tamerlane/?iiif-content=https://iiif.wellcomecollection.org/presentation/b19974760"
allowfullscreen
allow="clipboard-write"
></iframe>
</body>
</html>You can replace the iiif-content URL with any IIIF manifest you wish to display.
Encountered a bug or have a feature request? Please raise an issue on the GitHub repository.
This project is licensed under the MIT License.