Annotation frontend for the Media Ecology Project
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Media Ecology Project Image

Release version Build status Dependency status

Waldorf is a replacement video player for HTML5 videos which allows for viewing, creating, and modifying user-made annotations conforming to the W3C Web Annotation data model, and was created for the Media Ecology Project.

This project is in an early alpha phase. As such, please note that it's still rough around the edges; documentation and clarifying information will be fleshed out further as the project progresses.

How to Use

The following instructions are for using this plugin with your website. You can find the latest version of the plugin in the Releases; if you'd like to build the plugin yourself, see How to Build.



You will need to import the above prerequisites and the files from the latest release on your page.

You can then use jQuery to reference a video object, and call annotate() on it; the plugin will do the rest.



You can see a full example at /testpage/.


Information forthcoming.

Known Issues

For some reason, the vertical offset of the annotations are wrong (slightly raised) when the Chrome dev tools are open and the video is fullscreen. If anyone has an idea why, please let us know.

How to Build

The following instructions are for building the plugin on your own machine.

This project is written in ES6 and is transpiled by Babel and Browserify into a bundled file.

Note that this project was developed with Visual Studio Code. It is highly recommended that you also use this.


  • NPM


  1. Install the dependencies with NPM.
npm install


Building is done using Grunt. You can run any of the tasks with grunt taskName.


  • build - Bundles the source files into /dist/.
  • make_release - Builds and compresses the final product for release.
  • preview - Sets up live development environment with BrowserSync. Loads /testpage/.

Built With

  • Grunt
  • Babel
  • Browserify



This project is licensed under the MIT License. Please see the file for details.