Skip to content

Latest commit

 

History

History
187 lines (137 loc) · 16.8 KB

README.md

File metadata and controls

187 lines (137 loc) · 16.8 KB
Raw

Universal Viewer

Backers on Open Collective Sponsors on Open Collective Build Status FOSSA Status License

examples     google group     twitter     #slack 


npm install universalviewer@beta --save

Contributors

Contributors

Features:

  • Zoomable

    OpenSeadragon image zooming using the IIIF image API

  • Embeddable

    YouTube-style embedding with deep links to specific pages/zoom regions.

  • Themable

    Fork the UV theme on github to create your own.

  • Configurable

    The UV has its own visual configuration editor allowing all settings to be customised.

  • Extensible

    Supports IIIF Presentation API v3 (in development), allowing 3D, audio, video, and pdf viewing experiences.

More about the Universal Viewer

Stable Builds

See the GitHub releases page.

Getting Started

For a "hello world" getting started example see uv-hello-world.

For an example of how to use the Universal Viewer in a website starter project that uses biiif to generate your IIIF data, see uv-app-starter.

Building the Universal Viewer

All command-line operations for building the UV are scripted using Grunt which is based on Node.js. To get set up:

  1. Install Node.js, if you haven't already

  2. Install the grunt command line interface:

    npm install -g grunt-cli

  1. Clone the universalviewer repository and examples sub module:

    git clone https://github.com/UniversalViewer/universalviewer.git --recursive

  2. On the command line, go in to the universalviewer folder

  3. Run

    npm install

If switching between branches, ensure that you check out the correct branch in the examples sub-repository too. By default this should be gh-pages.

Debug Builds

To build the debug version of the viewer, just run (on the command line, in the universalviewer folder):

grunt build

This will compile the .less files into .css and .ts files into .js.

Distribution Builds

To build the distribution version of the UV, just run (on the command line, in the universalviewer folder):

grunt build --dist

Examples

To view the examples run:

grunt examples

Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

Sponsors

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]

License

The Universal Viewer is released under the MIT license.