Kerf
Try the player

A Video.js 10 skin built on one cut. The picture makes room for the controls, so they always sit on solid ground, in your product's own colour.

kerf, noun. The slot a saw leaves in the material it cuts.

Player
Video.js 10.3, HTML and CSS
Film
Sparvek launch, 46 s, Mux
Customise
--media-accent-color
--media-border-radius
Licence
Apache 2.0

Three layers, one surface

The picture at the bottom. The frame cut to make room. The notches that rise from it.

Desktop, paused

Over the brightest frame in the film.

  1. 1
    FrameSix pixels of your product's surface around the picture. Outer radius 20, inner 14, so every corner is concentric.
  2. 2
    Time tabA step of the frame, flush left. Current and total time in tabular numerals, so nothing jitters.
  3. 3
    BandThe controls' notch. A solid surface, so contrast never depends on what is playing.
  4. 4
    Chapter kerfsThe film's five scenes, cut into the seek track as 3 px gaps.
  5. 5
    BladeThe playhead is a 4 px blade with a 3 px cut around it. It reads on fill, buffer and track alike.
  6. 6
    IconsThe official Video.js solid set at 20 px, in 44 px targets on every screen size.

Everything rises from the frame

Previews and menus grow out of the band, from the control that opened them.

Scrubbing. The preview window carries the Mux storyboard frame and its chapter.
Settings. Flush right, its corner square, the picture's corner redrawn above it.

At home in any product

Kerf takes the host's surface, accent and radius. No fork, no rebuild.

It wears your product

On a dark streaming app, Kerf takes its orange and its 26 px corners. Nothing else changes.

Two properties, one attribute

Accent and radius in your stylesheet, the surface on the skin root. No fork, no rebuild.

/* your stylesheet */
.kerf {
  --media-accent-color: #f2552c;
  --media-border-radius: 26px;
}

<!-- the skin root -->
<media-container class="media-skin kerf"
  data-surface="dark">
data-surface="light" data-surface="auto" data-motion="reduce" data-poster-controls="show"

Light, for a lesson

A white frame, a cobalt accent, 12 px corners.

Quiet, for release notes

Violet on a soft lilac page, settings rising flush right.

Any radius, still concentric

Set the outer corner. The inner one and every notch follow.

One accent

It fills the seek bar, the active rate and play on hover. Nowhere else.

States

Same frame, same radii, one accent. Drawn here; every one of them runs on the Player page.

Phone

The player decides by its own width, not the screen's. Targets stay 44 px.

The numbers behind the cut

One radius system, two speeds, no exceptions.

Outer radius = inner radius + frame: 20 = 14 + 6. The time tab's base fillet and its top corner share a 10 px radius, so the step reads as one cut.

Motion

Rise
200 ms, cubic-bezier(.2, .8, .2, 1). Revealed from its base, out of the band, never past the frame.
Sink
120 ms ease-in, back into the band. Faster out than in.
Poster
Before the first play the band folds away. A pointer, a tap or Tab brings it back at once.
Interrupted
Transitions, not keyframes: a menu closed mid-rise turns back from where it is.
Reduced
Every change is instant. Tabs still appear at their trigger.

Made for everyone

Accessibility is the structure, not a layer on top.

Readable over any picture

Controls never sit on footage. They sit on the frame: ink on frame is 17:1 on dark and 18:1 on light, the same over a white sky or a black night.

17:1 dark18:1 light

Every control by keyboard

SpaceK←→JL↑↓MCFEsc

Tab follows the screen, left to right. Escape closes a menu and returns focus to its button.

Focus you can see

A 2 px ink ring with a 2 px cut on every button, menu item and on the blade itself.

Big enough for a thumb

44 px targets on every screen size. The seek bar is 44 px tall, the blade 24 by 44.

Calm on request

Reduced motion makes every change instant. Reduced transparency changes nothing: every surface is already solid.

Named for screen readers

Labels, states and announcements come from Video.js and its translations, including right to left.

Forced colours

Canvas for the frame, CanvasText for ink, Highlight for the fill and the focus ring.

Design thinking

Most players float their controls over the picture, then fight the picture for contrast with gradients and blur. Kerf cuts the picture instead. The controls live in a notch of the player's own frame, a solid surface in the host product's colour, so they read the same over a white sky or a black night.

Everything that opens rises out of that frame from the control that asked for it, and sinks back when the film plays. Transient feedback hangs from the top edge. One radius system, one accent, the official solid icons, tabular time. Familiar to use, unmistakable to look at.

Add Kerf to any page

Plain HTML and CSS on Video.js 10. Copy it in, own it.

  1. 1

    Install Video.js 10

    npm install @videojs/html
  2. 2

    Copy the skin

    Take skin/src/video/ and skin/src/styles/ from the Kerf repository, then import it once.

    import './video/skin';
  3. 3

    Wrap your video

    Put your media where the skin marks it. Any Video.js media works: a video file, HLS or Mux.

    <video-player>
      <!-- skin.html, with your media inside -->
      <mux-video src="https://stream.mux.com/{id}.m3u8"></mux-video>
    </video-player>
  4. 4

    Set your look

    .kerf {
      --media-accent-color: #d4f53c;
      --media-border-radius: 20px;
    }
    /* on the skin root: data-surface="light" | "auto",
       data-motion="reduce", data-poster-controls="show" */

Kerf on the Sparvek film

See it cut.

Scrub the chapters, open the menus, change the accent and the radius. Every switch is a property your product can set.

Open the player