Journal

Signal Viewport: a Video.js v10 skin for people who value every second

A skin for Video.js v10. The player below is the real thing, in its mono theme.

I watch a lot of video while working, and one thing always annoys me: the timeline. It is a thin line, it is hard to hit with a thumb, and when I want a specific moment I have to guess. So when the Video.js Skins Design Challenge came up, I made the timeline the whole point.

Signal Viewport is a skin for Video.js v10 built around one idea: the picture is a quiet frame, the controls live on their own surface directly under it, and the seek bar is drawn like a ruler.

The picture is never covered.

Nothing sits on top of the video. No gradient over the frame, no glass, no controls that appear on the picture just as the best shot arrives. The panel is a solid strip below it: signal red by default, white in the mono theme you see on this page. Captions, menus, and messages have a fixed place above that strip, so they never fight the controls.

A ruler you can read, aim at, and type into.

The seek bar has short and long ticks. The step between them is picked from the video’s length, and the labels are picked from the ruler’s real width, so they never collide whether a film lasts two minutes or three hours. The playhead is a pin. Hover and a small chip tells you the time; chapters and frame previews sit right on the ruler. And when you know the time, you can just type it. Click the time, press 2, 1: the colons appear by themselves, and Enter takes you to 0:21.

Numbers that look like an instrument.

Everything that is a measurement (elapsed time, total time, ruler labels, status) is set in a monospaced face, so digits line up and read like a gauge. Words and menus use a calm sans. The red is #E52600, chosen so that both black and white text on it stay readable (at least 4.5:1 for both).

Small things that matter.

  • One settings menu: Speed, Quality, Captions, Chapters, and an optional Colour switch. Each section shows up only if the video offers it.
  • It remembers your speed, mute, caption language, and where you stopped.
  • Every state is designed, not left to defaults: keyboard focus, loading (the pin steps along the ticks), and errors with “Try again” first.
  • It adapts to the width of the player itself, from wide video to a vertical phone frame.
  • Tap the picture to pause or play. Every control is at least 48 px, so a thumb can hit it.
  • The player’s own motion is only quick colour changes, and even those stop when your system asks for reduced motion.

Works for everyone.

Every control can be reached with the keyboard and shows a clear focus ring; menus open with Enter and close with Escape. Captions and status messages sit on solid plates, so they stay readable over bright and dark footage.

Try it.

The player above is the skin itself, not a recording. Press play, drag along the ruler, type a time, open the menu, switch the colour, go full screen. The film streams from Mux as adaptive video up to 1080p. The film and its music are my own work.

  • Live demo: https://signal-viewport.pages.dev
  • Source code: https://github.com/trusovanaty/signal-viewport
  • Ukrainian version: https://signal-viewport.pages.dev/?lang=uk

All posts