@mimir-iiif/explorer
v0.7.5
Published
Mimir IIIF explorer viewer (image, presentation, AV, and 3D) built on OpenSeadragon.
Readme
Mimir IIIF Explorer
Idea
Mimir IIIF Explorer is a modular IIIF viewer focused on image, AV, and 3D experiences with a clean, modern UI. It is designed as a small, embeddable library that renders a complete interface inside a host container.
This project is developed with Codex and human oversight.
Current Features
- IIIF Presentation v2/v3 manifest parsing with multi-language labels and metadata.
- OpenSeadragon image viewer with sequence navigation, book mode, and continuous mode.
- Audio/video playback with timeline controls and start-time support.
- 3D model viewing with Three.js controls (lighting and camera).
- Image filters: rotate, flip, brightness, contrast, greyscale, RGB channels.
- Region focus for ImageApiSelector with optional blur outside region.
- Download current image as full-res JPEG.
- Dark mode with auto/app/manual modes.
- Responsive layout with adaptive panel behavior.
- Cookie-based bookmarks (grouped by manifest and page).
- Annotations with list + overlays, single/select and show-all modes.
- Fulltext OCR (ALTO + HOCR) with line overlays and list sync.
- Collections view with gallery, pagination, list/grid toggle, and collection linking.
- URL query support (
?manifest=...,?page=...,?time=...) for auto-loading.
Future Features
- Keyboard navigation and accessibility pass.
- Theming API for typography, spacing, and component overrides.
- Plugin hooks for custom panels and rendering modes.
- Optional externalized dependencies for smaller bundles.
Install
npm i @mimir-iiif/explorerBasic Usage
import MimirExplorer from '@mimir-iiif/explorer';
const explorer = new MimirExplorer('mimir-container', {
primaryColor: '#451F8D',
darkMode: 'auto'
});
// Later, when you have a manifest URL:
// explorer.loadManifest('https://example.org/iiif/manifest.json');