01 The ring
A lens solves fine control with a scale that turns under a fixed witness mark. Here the scale is time. The
moment you are watching always sits under the mark, and a second there is always the same distance: the
ring turns at one pace, for a trailer or a three-hour film. Drag it, flick it, swipe sideways on a
trackpad, or click a moment to bring it to the mark.
02 The record
A progress fill only knows where the playhead is. Witness keeps what you have seen: marks fill with paint
as they pass the mark, and the rail above the ring is drawn from the stretches that actually played. Skip
ahead and the gap stays bare.
03 The way back
Jump away from something you were watching and the place you left gets a second mark, in amber. Press
Z, or the button that appears, to return to it.
04 The basics
The rail is a standard Video.js slider, and every control is a real, labelled element you can reach from
the keyboard, in every language Video.js speaks. Contrast keeps a floor whatever the picture is, motion
calms down when you ask it to, and the layout answers to the player's width, not the window's.
Use it
Witness is used like a packaged Video.js skin: one stylesheet, one module, one element around your media. It
needs no build step.
<link rel="stylesheet" href="witness/skin.css" />
<script type="module" src="witness/skin.js"></script>
<video-player>
<witness-skin>
<video src="film.mp4" playsinline></video>
</witness-skin>
</video-player>
It accepts custom properties under the names the packaged skins use: --media-accent-color for
the witness mark, --media-border-radius, --media-font-family,
--media-object-fit and --media-object-position.