<div class="kw-pro kw-pro-panel kw-pro-tbar"><output class="kw-pro-tc kw-pro-tc--md">01<i>:</i>04<i>:</i>10<i>:</i>07</output><div class="kw-pro-transport" role="toolbar" aria-label="Program transport"><button class="kw-pro-btn" type="button" aria-label="Mark in (I)" title="Mark in (I)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M14 4H9v16h5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Mark out (O)" title="Mark out (O)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 4h5v16h-5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to in (Shift I)" title="Go to in (Shift I)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M9 5H6v14h3M20 12h-9m3-3.5L10.5 12l3.5 3.5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Back one frame (Left arrow)" title="Back one frame (Left arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5 5h2v14H5zM19 5v14L8.5 12z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Play backwards (J)" title="Play backwards (J)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 4.5v15L5 12z"/></svg></button><button class="kw-pro-btn kw-pro-btn--play" type="button" aria-label="Play (Space or L)" title="Play (Space or L)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M7 4.5v15l12-7.5z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Forward one frame (Right arrow)" title="Forward one frame (Right arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 5h2v14h-2zM5 5v14l10.5-7z"/></svg></button><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to out (Shift O)" title="Go to out (Shift O)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15 5h3v14h-3M4 12h9m-3-3.5 3.5 3.5-3.5 3.5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn" type="button" aria-pressed="false" aria-label="Loop playback (Command L)" title="Loop playback (Command L)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M17 3l3 3-3 3M4 11V9a3 3 0 0 1 3-3h13M7 21l-3-3 3-3M20 13v2a3 3 0 0 1-3 3H4"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Add marker (M)" title="Add marker (M)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M6 3h12v11l-6 6-6-6z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Match frame (F)" title="Match frame (F)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="4" width="8" height="7" rx="1"/><rect x="13" y="13" width="8" height="7" rx="1"/><path d="M11 7.5h3a3 3 0 0 1 3 3V13"/></svg></button></div><span class="kw-pro-sp"></span><span class="kw-pro-dim">In → out</span><span class="kw-pro-tc">00<i>:</i>00<i>:</i>06<i>:</i>06</span></div>
<div class="kw-pro" style="display:flex;flex-wrap:wrap;gap:16px;align-items:center"><div class="kw-pro-shuttle" role="img" aria-label="Shuttle: playing forwards at 2 times"><span>◀ 8×</span><span>◀ 4×</span><span>◀ 2×</span><span>◀ 1×</span><span data-stop>K</span><span>1× ▶</span><span data-on>2× ▶</span><span>4× ▶</span><span>8× ▶</span></div><span class="kw-pro-dim">L pressed twice: forwards at 2×</span></div>
<div class="kw-pro kw-pro-panel kw-pro-tbar"><output class="kw-pro-tc kw-pro-tc--md">01<i>:</i>04<i>:</i>10<i>:</i>07</output><div class="kw-pro-transport" role="toolbar" aria-label="Program transport"><button class="kw-pro-btn" type="button" aria-label="Mark in (I)" title="Mark in (I)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M14 4H9v16h5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Mark out (O)" title="Mark out (O)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 4h5v16h-5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to in (Shift I)" title="Go to in (Shift I)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M9 5H6v14h3M20 12h-9m3-3.5L10.5 12l3.5 3.5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Back one frame (Left arrow)" title="Back one frame (Left arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5 5h2v14H5zM19 5v14L8.5 12z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Play backwards (J)" title="Play backwards (J)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 4.5v15L5 12z"/></svg></button><button class="kw-pro-btn kw-pro-btn--play" type="button" aria-label="Pause (K)" title="Pause (K)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M6.5 4.5h4v15h-4zM13.5 4.5h4v15h-4z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Forward one frame (Right arrow)" title="Forward one frame (Right arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 5h2v14h-2zM5 5v14l10.5-7z"/></svg></button><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to out (Shift O)" title="Go to out (Shift O)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15 5h3v14h-3M4 12h9m-3-3.5 3.5 3.5-3.5 3.5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn" type="button" aria-pressed="false" aria-label="Loop playback (Command L)" title="Loop playback (Command L)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M17 3l3 3-3 3M4 11V9a3 3 0 0 1 3-3h13M7 21l-3-3 3-3M20 13v2a3 3 0 0 1-3 3H4"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Add marker (M)" title="Add marker (M)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M6 3h12v11l-6 6-6-6z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Match frame (F)" title="Match frame (F)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="4" width="8" height="7" rx="1"/><rect x="13" y="13" width="8" height="7" rx="1"/><path d="M11 7.5h3a3 3 0 0 1 3 3V13"/></svg></button></div><span class="kw-pro-sp"></span><span class="kw-pro-dim">Playing</span></div>
What it is
The deck controls of a viewer or a session. Editors drive it from the keyboard (J, K, L, I, O, arrows) and use the buttons to learn the keys or when a hand is on the mouse. The order is the one every editor’s muscle memory expects: marks on the outside, play in the middle, steps beside it.
When to use
- Under every source and program viewer (the compact form, inside Video player).
- Across the top of a sound session, where it drives the shared playhead.
When not to
- In a phone review screen: show three 44px labelled buttons (back one frame, play, forward one frame) and nothing else.
- For media that is not frame-based (a music player, a podcast): use a simple play control.
Anatomy in use
- Marks: Mark in, Mark out. Go to in and Go to out sit beside the steps.
- Steps and play: Back one frame, Play backwards, Play, Forward one frame. Play becomes Pause while running and is the only filled button.
- Utilities: Loop (a toggle), Add marker, Match frame.
- Shuttle gauge: nine stops from 8× backwards to 8× forwards. It shows what J and L have done, so a person who pressed L three times sees 4× and not a mystery.
Writing
Every button has a name that says the key: Mark in (I), Play backwards (J). The tooltip is the same text.
Play centred and filled, steps either side, marks at the ends, keys in every tooltip.
A row of identical outline icons in a new order, with no tooltip and no shuttle speed.
Anatomy
- Row: 32px tall, 4px padding,
--k-pro-panel, 1px--k-pro-line; groups separated by a 1px × 16px rule. - Buttons: 24 × 24px, 4px corners, 14px glyphs in
--k-text-2; hover--k-pro-controland--k-text. - Play: 28 × 24px,
--k-textfill,--k-pro-on-toneglyph. The only filled control. - Toggle on (Loop):
--k-pro-controlground, 1px--k-pro-line-strong. - Shuttle gauge: 9 cells, 22px tall, 11px figures; the current speed is filled with
--k-pro-playhead; K (stop) is a letter in the middle.
Tokens
| Token | Light | Dark |
|---|---|---|
--k-pro-panel |
#f6f7f9 | #19191b |
--k-pro-control |
#ffffff | #2a2a2e |
--k-pro-line |
#d3d9e0 | rgba(255, 255, 255, .09) |
--k-text |
#0f172a | #e3e3e3 |
--k-text-2 |
#5b6779 | #9ca3af |
--k-pro-playhead |
#c4502f | #f28b71 |
--k-pro-on-tone |
#ffffff | #1b221e |
--k-radius-control |
6px | |
--k-tap |
44px |
Numbers
| Part | Value |
|---|---|
| Row height | 32px |
| Button | 24 × 24px, glyph 14px |
| Play | 28 × 24px |
| Gap | 2px inside a group, 1px rule + 6px between groups |
| Under a thumb | every button 44 × 44px; marks and utilities move into the ⋯ menu |
React
Use the HTML below with kwark.css. The example shows the markup and styling. Supply any application behavior described on this page.
HTML and CSS
Works anywhere with kwark.css.
<div class="kw-pro kw-pro-panel kw-pro-tbar"><output class="kw-pro-tc kw-pro-tc--md">01<i>:</i>04<i>:</i>10<i>:</i>07</output><div class="kw-pro-transport" role="toolbar" aria-label="Program transport"><button class="kw-pro-btn" type="button" aria-label="Mark in (I)" title="Mark in (I)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M14 4H9v16h5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Mark out (O)" title="Mark out (O)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 4h5v16h-5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to in (Shift I)" title="Go to in (Shift I)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M9 5H6v14h3M20 12h-9m3-3.5L10.5 12l3.5 3.5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Back one frame (Left arrow)" title="Back one frame (Left arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5 5h2v14H5zM19 5v14L8.5 12z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Play backwards (J)" title="Play backwards (J)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 4.5v15L5 12z"/></svg></button><button class="kw-pro-btn kw-pro-btn--play" type="button" aria-label="Play (Space or L)" title="Play (Space or L)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M7 4.5v15l12-7.5z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Forward one frame (Right arrow)" title="Forward one frame (Right arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 5h2v14h-2zM5 5v14l10.5-7z"/></svg></button><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to out (Shift O)" title="Go to out (Shift O)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15 5h3v14h-3M4 12h9m-3-3.5 3.5 3.5-3.5 3.5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn" type="button" aria-pressed="false" aria-label="Loop playback (Command L)" title="Loop playback (Command L)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M17 3l3 3-3 3M4 11V9a3 3 0 0 1 3-3h13M7 21l-3-3 3-3M20 13v2a3 3 0 0 1-3 3H4"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Add marker (M)" title="Add marker (M)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M6 3h12v11l-6 6-6-6z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Match frame (F)" title="Match frame (F)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="4" width="8" height="7" rx="1"/><rect x="13" y="13" width="8" height="7" rx="1"/><path d="M11 7.5h3a3 3 0 0 1 3 3V13"/></svg></button></div><span class="kw-pro-sp"></span><span class="kw-pro-dim">In → out</span><span class="kw-pro-tc">00<i>:</i>00<i>:</i>06<i>:</i>06</span></div>
<div class="kw-pro" style="display:flex;flex-wrap:wrap;gap:16px;align-items:center"><div class="kw-pro-shuttle" role="img" aria-label="Shuttle: playing forwards at 2 times"><span>◀ 8×</span><span>◀ 4×</span><span>◀ 2×</span><span>◀ 1×</span><span data-stop>K</span><span>1× ▶</span><span data-on>2× ▶</span><span>4× ▶</span><span>8× ▶</span></div><span class="kw-pro-dim">L pressed twice: forwards at 2×</span></div>
<div class="kw-pro kw-pro-panel kw-pro-tbar"><output class="kw-pro-tc kw-pro-tc--md">01<i>:</i>04<i>:</i>10<i>:</i>07</output><div class="kw-pro-transport" role="toolbar" aria-label="Program transport"><button class="kw-pro-btn" type="button" aria-label="Mark in (I)" title="Mark in (I)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M14 4H9v16h5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Mark out (O)" title="Mark out (O)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 4h5v16h-5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to in (Shift I)" title="Go to in (Shift I)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M9 5H6v14h3M20 12h-9m3-3.5L10.5 12l3.5 3.5"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Back one frame (Left arrow)" title="Back one frame (Left arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5 5h2v14H5zM19 5v14L8.5 12z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Play backwards (J)" title="Play backwards (J)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 4.5v15L5 12z"/></svg></button><button class="kw-pro-btn kw-pro-btn--play" type="button" aria-label="Pause (K)" title="Pause (K)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M6.5 4.5h4v15h-4zM13.5 4.5h4v15h-4z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Forward one frame (Right arrow)" title="Forward one frame (Right arrow)"><svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M17 5h2v14h-2zM5 5v14l10.5-7z"/></svg></button><button class="kw-pro-btn kw-pro-x" type="button" aria-label="Go to out (Shift O)" title="Go to out (Shift O)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15 5h3v14h-3M4 12h9m-3-3.5 3.5 3.5-3.5 3.5"/></svg></button><span class="kw-pro-sep"></span><button class="kw-pro-btn" type="button" aria-pressed="false" aria-label="Loop playback (Command L)" title="Loop playback (Command L)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M17 3l3 3-3 3M4 11V9a3 3 0 0 1 3-3h13M7 21l-3-3 3-3M20 13v2a3 3 0 0 1-3 3H4"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Add marker (M)" title="Add marker (M)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M6 3h12v11l-6 6-6-6z"/></svg></button><button class="kw-pro-btn" type="button" aria-label="Match frame (F)" title="Match frame (F)"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="3" y="4" width="8" height="7" rx="1"/><rect x="13" y="13" width="8" height="7" rx="1"/><path d="M11 7.5h3a3 3 0 0 1 3 3V13"/></svg></button></div><span class="kw-pro-sp"></span><span class="kw-pro-dim">Playing</span></div>
Behaviour
- J: play backwards; pressed again 2×, 4×, 8×. L: the same forwards. K: stop. K held with J or L: slow (1/4×) in that direction. K held with ← / →: one frame.
- The gauge and the Play/Pause button are one state; never let them disagree.
Keyboard
| Key | Does |
|---|---|
| Space | Play / pause |
| J / K / L | Backwards, stop, forwards; repeat J or L for 2×, 4×, 8× |
| ← / → | One frame back / forward |
| ⇧ ← / ⇧ → | One second back / forward |
| I / O | Mark in / out; ⌥ I / ⌥ O clear |
| ⇧ I / ⇧ O | Go to in / out |
| ⌘ L | Loop on / off |
| M | Add marker |
| F | Match frame |
ARIA
- The row is
role="toolbar"with anaria-labelthat names its viewer (Program transport); arrow keys move between buttons inside it. - Loop is a toggle with
aria-pressed. Play announces Playing and Paused at 01:04:10:07 in a polite live region, never every frame. - The shuttle gauge is
role="img"with the speed in words.
Rules
- Must keep the order: marks, go to in, step back, play backwards, play, step forward, go to out.
- Must put the shortcut in every button name and tooltip.
- Always show shuttle speed and direction when J or L is pressed more than once.
- Never fill any button except Play/Pause.
- Always grow every transport button to 44px under a thumb.
AI readiness test
Task. Put a transport under the program viewer of a dailies tool.
Give the agent. Transport bar, Timecode display, Video player.
Constraint. Desktop and phone; phone has no keyboard.
A reliable answer
- Desktop order marks–steps–play–steps–marks
- Keys in names
- Shuttle gauge for J/L
- Phone shows only back one frame, play, forward one frame at 44px
- Live region on play and stop only