What Is Universal Viewer?
Universal Viewer (UV) is an open-source viewer built on the IIIF (International Image Interoperability Framework) standards. As its name suggests, its defining characteristic is universality: it can display images, audio, video, 3D models, and PDFs through a single unified interface. It is released under the MIT license and implemented in TypeScript.
While Mirador is perhaps the most well-known IIIF viewer, Universal Viewer stands out through its broad media format support. You can explore various content types on the examples page.
Multi-Format Support
Universal Viewer handles a wide range of media types.
Images: High-resolution images can be smoothly zoomed and panned. UV supports the IIIF Image API for efficient tiled image delivery and also supports Deep Zoom, enabling stress-free browsing of very large images.
Audio and Video: UV can play audio and video content defined through the IIIF Presentation API 3. Timeline-based navigation allows users to quickly jump to specific points in longer recordings.
3D Models: Museum objects, architectural models, and other 3D content can be displayed directly in the browser. Users can rotate and zoom to examine objects from any angle.
PDF: PDF documents can be viewed directly within the viewer, making it convenient for serving digitized textual materials without requiring additional software.
Institutional Adoption
Universal Viewer is used by libraries, museums, and archives around the world.
- British Library: Uses UV to provide access to its vast digital collections.
- Wellcome Library: Serves medical history materials through UV. Wellcome has been one of the key institutions involved in UV’s development.
- National Library of Wales: Delivers Welsh historical resources through UV.
- Internet Archive: Leverages UV for browsing its large-scale digital archive.
The adoption by these major institutions in production environments demonstrates UV’s stability and reliability.
Key Features
Tree Navigation
When browsing multi-page manuscripts or books, UV provides a tree-structured overview of pages, allowing users to jump directly to any section. It leverages the Structures (Range) information in IIIF Manifests to offer navigation that follows the logical structure of a document, such as chapters and sections. This is particularly powerful for digitized classical texts and manuscripts.
Thumbnail Panel
A panel displaying thumbnails of all pages allows users to visually locate specific pages. This greatly improves the browsing experience for content with many pages.
Search Within Manifests
UV supports the IIIF Content Search API, enabling full-text search within manifests that have associated text. For OCR-processed documents, users can quickly find specific passages by keyword.
Full-Screen Mode
Full-screen display using the entire browser window provides an immersive viewing experience, especially valuable for high-resolution images and detailed manuscripts.
Embedding
UV can be embedded in external web pages using an IFRAME tag. This is useful for institutions that want to integrate digital collections into their own websites. Configuration is JSON-based and highly customizable.
Support for IIIF Presentation API 2 and 3
Universal Viewer supports both IIIF Presentation API 2 and 3. API 3 introduced enhanced support for audio and video, and UV was one of the first viewers to implement this specification. Existing API 2 manifests continue to work without issues, making UV a reassuring choice for institutions in the process of migrating between API versions.
Comparison with Other IIIF Viewers
Several IIIF viewers are available, each with different strengths.
| Viewer | Images | Audio/Video | 3D | Annotation Editing | Comparison |
|---|---|---|---|---|---|
| Universal Viewer | Yes | Yes | Yes | Limited | Limited |
| Mirador | Yes | Limited | No | Yes | Yes |
| OpenSeadragon | Yes | No | No | No | No |
Mirador excels at annotation editing and side-by-side comparison of multiple manifests. It is the better choice for research scenarios requiring detailed image analysis.
OpenSeadragon is a lightweight viewer specialized in image zoom and pan. It is ideal when you simply need to display images without additional complexity.
Universal Viewer has the broadest media format coverage. It is the optimal choice when you need to serve collections that include not just images but also audio, video, and 3D content through a unified interface.
Conclusion
Universal Viewer is a versatile viewer that unlocks the full potential of IIIF. In a landscape dominated by image-centric viewers, its ability to handle audio, video, 3D, and PDF content is unmatched. Its adoption by major institutions such as the British Library is a testament to its reliability. If you are building a digital archive or considering publishing IIIF content, take a moment to explore the examples page and see what UV can do.