Skip to content
This repository has been archived by the owner. It is now read-only.
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

#We recommend that developers now use:

Navigate sequences of images in a zoomable, extensible interface.


Google group

Stable Builds

See the GitHub releases page.


Please see the wiki for instructions on how to customise the player for your own projects.

First Time Setup

All command-line operations for building the Wellcome Player are scripted using Grunt which is based on Node.js. We are using Node for this project because it provides a powerful cross-platform collection of tools with minimal setup overhead. To get set up:

  1. Install Node.js, if you haven't already
  2. Install the Grunt command line interface (if you haven't already); on the command line, run npm install -g grunt-cli
  3. Clone the 'player' repository
  4. On the command line, go in to the 'player' folder
  5. Run git submodule init
  6. Run git submodule update
  7. Run npm install

Debug Builds

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


This will compile the .less files into .css and .ts files into .js with sourcemaps to aid in debugging.

Release Builds

To build the release version of the player, just run (on the command line, in the 'player' folder):

grunt build

The built files appear in the 'build' folder.

If you want to build tar and zip files for distribution (they will also appear in the 'build' folder), use:

grunt package

Note that the 'build' folder is masked with .gitignore; it's just for your local use, and won't be checked in to the repository.


To view the examples run:

grunt serve


The Wellcome Player is released under the MIT license. For details, see the file LICENSE.txt.