# Bin

> The media browser: clips by scene and day in a dense list with take, start timecode, duration, camera and the script line, or as picture thumbnails; circled takes and offline media marked in words.

Source: https://kwark.space/designSystem/components/bin

## Usage

### What it is
Where an assistant editor organises the shoot and an editor finds the take. In Kwark the bin already knows the script: every clip carries its scene, shot, take, whether it was circled on set, and the line it covers.

### When to use
- In an editor or dailies tool: one bin per scene, day or reel.
- As the picker in any tool that places media (a sound session's import, a grade's reference stills).

### When not to
- For reference images and the Look Book: use the [Media grid](https://kwark.space/designSystem/components/media-grid.md).

### Two views
- **List** for finding and sorting: name, take (circled takes ringed), start timecode, duration, camera, script line. Columns drop from the right as the panel narrows; Name and Duration stay.
- **Thumbnails** for choosing by eye: picture at 16:9, duration on the frame, name and take below, the line in screenplay type.

### States
| State | How it shows |
|---|---|
| Selected | Row on `--k-pro-control`, 2px `--k-text` bar at the left |
| Circled take | The take number ringed; tooltip *Circled take* |
| In the cut | *In cut* label |
| Media offline | *Media offline* in `--k-danger`, the row at 60% |
| Has a note | The note under the line, 12px |

**Do:** *12B-1* · take 1 ringed · 14:22:27:00 · 00:00:38:02 · A · “Who put you there?”

**Don't:** *A003C012_221114_R1KQ.mov* · 1.2 GB · modified 14 Nov.

## Style

### Anatomy

1. **Header** (28px): bin name, count, List / Thumbnail switch.
2. **Search** (28px): searches slate, line and notes.
3. **List**: 26px rows, 12px Poppins; timecodes tabular; header row 24px in `--k-text-2` with a 1px rule.
4. **Thumbnails**: 132px minimum width cards, 16:9 picture with 3px corners, 11px duration chip on the frame.
5. **Take ring**: 16px circle, 1px `--k-text`.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-pro-panel` | #f6f7f9 | #19191b |
| `--k-pro-head` | #eceff3 | #202023 |
| `--k-pro-lane` | #fcfcfd | #141416 |
| `--k-pro-line` | #d3d9e0 | rgba(255, 255, 255, .09) |
| `--k-pro-control` | #ffffff | #2a2a2e |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-danger` | #b4382c | #e0685c |
| `--k-font-screenplay` | 'Courier Prime', 'Courier New', monospace |  |

### Numbers
| Part | Value |
|---|---|
| Row | 26px, 12px text, 8px cell padding |
| Card | min 132px, gap 8px |
| Script line | Courier Prime 12px (screenplay text keeps its face) |
| Columns hidden | Line under 620px, Camera and Start under 460px, Take under 300px |

## Code

### 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`.

```html
<section class="kw-pro kw-pro-panel kw-pro-bin" data-view="list" aria-label="Bin: Scene 12, day 7 dailies"><div class="kw-pro-bar"><strong>Scene 12</strong><span class="kw-pro-dim kw-pro-ellip">Day 7 dailies · 7 clips</span><span class="kw-pro-sp"></span><div class="kw-pro-seg" role="group" aria-label="Bin view"><button class="kw-pro-btn" type="button" aria-pressed="true" aria-label="List view" title="List view"><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="M8 6h13M8 12h13M8 18h13M3.5 6h.01M3.5 12h.01M3.5 18h.01"/></svg></button><button class="kw-pro-btn" type="button" aria-pressed="false" aria-label="Thumbnail view" title="Thumbnail view"><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="4" y="4" width="7" height="7" rx="1"/><rect x="13" y="4" width="7" height="7" rx="1"/><rect x="4" y="13" width="7" height="7" rx="1"/><rect x="13" y="13" width="7" height="7" rx="1"/></svg></button></div></div>
  <label class="kw-pro-search"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="11" cy="11" r="7"/><path d="m20 20-3.8-3.8"/></svg><span class="kw-visually-hidden">Search this bin</span><input type="search" placeholder="Slate, line or note" value=""></label><div class="kw-pro-bin__scroll"><table class="kw-pro-table kw-pro-bin__list"><thead><tr><th scope="col">Name</th><th scope="col" class="kw-pro-c-tk">Take</th><th scope="col" class="kw-pro-c-tc">Start</th><th scope="col" class="kw-pro-c-num">Duration</th><th scope="col" class="kw-pro-c-cam">Cam</th><th scope="col" class="kw-pro-c-line">Script line</th></tr></thead><tbody><tr tabindex="-1"><td><span class="kw-pro-bin__name"><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="18" height="16" rx="2"/><path d="M7 4v16M17 4v16M3 9h4M3 15h4M17 9h4M17 15h4"/></svg><b>12A-1</b></span></td><td class="kw-pro-c-tk"><span class="kw-pro-take">1</span></td><td class="kw-pro-c-tc kw-pro-tc">14:18:02:11</td><td class="kw-pro-c-num kw-pro-tc">00:00:41:08</td><td class="kw-pro-c-cam">A</td><td class="kw-pro-c-line"><span class="kw-pro-line">Reel 3 loops on the monitor.</span></td></tr><tr tabindex="-1"><td><span class="kw-pro-bin__name"><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="18" height="16" rx="2"/><path d="M7 4v16M17 4v16M3 9h4M3 15h4M17 9h4M17 15h4"/></svg><b>12A-3</b><span class="kw-pro-used" title="Used in cut v4">In cut</span></span></td><td class="kw-pro-c-tk"><span class="kw-pro-take" data-circled title="Circled take">3</span></td><td class="kw-pro-c-tc kw-pro-tc">14:19:40:03</td><td class="kw-pro-c-num kw-pro-tc">00:00:44:20</td><td class="kw-pro-c-cam">A</td><td class="kw-pro-c-line"><span class="kw-pro-line">Reel 3 loops on the monitor.</span></td></tr><tr aria-selected="true" tabindex="0"><td><span class="kw-pro-bin__name"><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="18" height="16" rx="2"/><path d="M7 4v16M17 4v16M3 9h4M3 15h4M17 9h4M17 15h4"/></svg><b>12B-1</b><span class="kw-pro-used" title="Used in cut v4">In cut</span></span></td><td class="kw-pro-c-tk"><span class="kw-pro-take" data-circled title="Circled take">1</span></td><td class="kw-pro-c-tc kw-pro-tc">14:22:27:00</td><td class="kw-pro-c-num kw-pro-tc">00:00:38:02</td><td class="kw-pro-c-cam">A</td><td class="kw-pro-c-line"><span class="kw-pro-line">“Who put you there?”</span></td></tr><tr tabindex="-1"><td><span class="kw-pro-bin__name"><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="18" height="16" rx="2"/><path d="M7 4v16M17 4v16M3 9h4M3 15h4M17 9h4M17 15h4"/></svg><b>12B-2</b></span></td><td class="kw-pro-c-tk"><span class="kw-pro-take">2</span></td><td class="kw-pro-c-tc kw-pro-tc">14:24:11:07</td><td class="kw-pro-c-num kw-pro-tc">00:00:12:15</td><td class="kw-pro-c-cam">A</td><td class="kw-pro-c-line"><span class="kw-pro-line">“Who put you there?”</span><small>Boom in frame</small></td></tr><tr tabindex="-1"><td><span class="kw-pro-bin__name"><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="18" height="16" rx="2"/><path d="M7 4v16M17 4v16M3 9h4M3 15h4M17 9h4M17 15h4"/></svg><b>12B-4</b><span class="kw-pro-used" title="Used in cut v4">In cut</span></span></td><td class="kw-pro-c-tk"><span class="kw-pro-take" data-circled title="Circled take">4</span></td><td class="kw-pro-c-tc kw-pro-tc">14:27:50:18</td><td class="kw-pro-c-num kw-pro-tc">00:00:39:11</td><td class="kw-pro-c-cam">A</td><td class="kw-pro-c-line"><span class="kw-pro-line">“I didn’t shoot this.”</span></td></tr><tr tabindex="-1"><td><span class="kw-pro-bin__name"><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="18" height="16" rx="2"/><path d="M7 4v16M17 4v16M3 9h4M3 15h4M17 9h4M17 15h4"/></svg><b>12C-2</b><span class="kw-pro-used" title="Used in cut v4">In cut</span></span></td><td class="kw-pro-c-tk"><span class="kw-pro-take" data-circled title="Circled take">2</span></td><td class="kw-pro-c-tc kw-pro-tc">14:41:05:12</td><td class="kw-pro-c-num kw-pro-tc">00:00:22:00</td><td class="kw-pro-c-cam">B</td><td class="kw-pro-c-line"><span class="kw-pro-line">Selvi on the monitor.</span></td></tr><tr data-offline tabindex="-1"><td><span class="kw-pro-bin__name"><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="18" height="16" rx="2"/><path d="M7 4v16M17 4v16M3 9h4M3 15h4M17 9h4M17 15h4"/></svg><b>12D-1</b><span class="kw-pro-offline">Media offline</span></span></td><td class="kw-pro-c-tk"><span class="kw-pro-take">1</span></td><td class="kw-pro-c-tc kw-pro-tc">14:52:13:04</td><td class="kw-pro-c-num kw-pro-tc">00:00:30:09</td><td class="kw-pro-c-cam">B</td><td class="kw-pro-c-line"><span class="kw-pro-line">“Run it from the beginning.”</span></td></tr></tbody></table></div></section>
<section class="kw-pro kw-pro-panel kw-pro-bin" data-view="grid" aria-label="Bin: Scene 12, day 7 dailies"><div class="kw-pro-bar"><strong>Scene 12</strong><span class="kw-pro-dim kw-pro-ellip">Day 7 dailies · 7 clips</span><span class="kw-pro-sp"></span><div class="kw-pro-seg" role="group" aria-label="Bin view"><button class="kw-pro-btn" type="button" aria-pressed="false" aria-label="List view" title="List view"><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="M8 6h13M8 12h13M8 18h13M3.5 6h.01M3.5 12h.01M3.5 18h.01"/></svg></button><button class="kw-pro-btn" type="button" aria-pressed="true" aria-label="Thumbnail view" title="Thumbnail view"><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="4" y="4" width="7" height="7" rx="1"/><rect x="13" y="4" width="7" height="7" rx="1"/><rect x="4" y="13" width="7" height="7" rx="1"/><rect x="13" y="13" width="7" height="7" rx="1"/></svg></button></div></div>
  <label class="kw-pro-search"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="11" cy="11" r="7"/><path d="m20 20-3.8-3.8"/></svg><span class="kw-visually-hidden">Search this bin</span><input type="search" placeholder="Slate, line or note" value=""></label><ul class="kw-pro-bin__grid" role="listbox" aria-label="Clips"><li role="option" aria-selected="false" tabindex="-1"><span class="kw-pro-bin__thumb"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" aria-hidden="true"><rect class="w" width="160" height="90"/><rect class="d" y="60" width="160" height="30"/><rect class="d" x="92" y="21" width="54" height="36" rx="1"/><rect class="m" x="95" y="24" width="48" height="30"/><circle class="f" cx="119" cy="34" r="3.5"/><path class="f" d="M112 54c0-7 3-10 7-10s7 3 7 10z"/><rect class="d" x="115" y="57" width="8" height="4"/><circle class="l" cx="24" cy="27" r="7"/><rect class="f" x="23" y="34" width="2" height="26"/><path class="b" d="M48 62c0-11 8-16 18-16s18 5 18 16z"/><circle class="s" cx="66" cy="37" r="7.5"/><path class="h" d="M58.5 37a7.5 7.5 0 0 1 15 0c-1-4-4-6-7.5-6s-6.5 2-7.5 6z"/></svg><span class="kw-pro-tc">00:41:08</span></span><span class="kw-pro-bin__cap"><b>12A-1</b><span class="kw-pro-take">1</span></span><span class="kw-pro-line">Reel 3 loops on the monitor.</span></li><li role="option" aria-selected="false" tabindex="-1"><span class="kw-pro-bin__thumb"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" aria-hidden="true"><rect class="w" width="160" height="90"/><rect class="d" y="60" width="160" height="30"/><rect class="d" x="92" y="21" width="54" height="36" rx="1"/><rect class="m" x="95" y="24" width="48" height="30"/><circle class="f" cx="119" cy="34" r="3.5"/><path class="f" d="M112 54c0-7 3-10 7-10s7 3 7 10z"/><rect class="d" x="115" y="57" width="8" height="4"/><circle class="l" cx="24" cy="27" r="7"/><rect class="f" x="23" y="34" width="2" height="26"/><path class="b" d="M48 62c0-11 8-16 18-16s18 5 18 16z"/><circle class="s" cx="66" cy="37" r="7.5"/><path class="h" d="M58.5 37a7.5 7.5 0 0 1 15 0c-1-4-4-6-7.5-6s-6.5 2-7.5 6z"/></svg><span class="kw-pro-tc">00:44:20</span></span><span class="kw-pro-bin__cap"><b>12A-3</b><span class="kw-pro-take" data-circled title="Circled take">3</span></span><span class="kw-pro-line">Reel 3 loops on the monitor.</span></li><li role="option" aria-selected="true" tabindex="0"><span class="kw-pro-bin__thumb"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" aria-hidden="true"><rect class="w" width="160" height="90"/><circle class="l" cx="26" cy="22" r="11" opacity=".35"/><circle class="l" cx="46" cy="33" r="5" opacity=".25"/><path class="b" d="M40 90c0-19 19-29 44-29s44 10 44 29z"/><rect class="s" x="76" y="52" width="16" height="14"/><ellipse class="s" cx="84" cy="40" rx="17" ry="21"/><path class="h" d="M66 42c0-17 8-25 19-25s18 8 18 23c-4-9-10-13-18-13s-14 7-19 15z"/><path class="m" d="M99 29c4 5 5 13 3 21l-3 4c2-9 2-17 0-25z" opacity=".85"/></svg><span class="kw-pro-tc">00:38:02</span></span><span class="kw-pro-bin__cap"><b>12B-1</b><span class="kw-pro-take" data-circled title="Circled take">1</span></span><span class="kw-pro-line">“Who put you there?”</span></li><li role="option" aria-selected="false" tabindex="-1"><span class="kw-pro-bin__thumb"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" aria-hidden="true"><rect class="w" width="160" height="90"/><circle class="l" cx="26" cy="22" r="11" opacity=".35"/><circle class="l" cx="46" cy="33" r="5" opacity=".25"/><path class="b" d="M40 90c0-19 19-29 44-29s44 10 44 29z"/><rect class="s" x="76" y="52" width="16" height="14"/><ellipse class="s" cx="84" cy="40" rx="17" ry="21"/><path class="h" d="M66 42c0-17 8-25 19-25s18 8 18 23c-4-9-10-13-18-13s-14 7-19 15z"/><path class="m" d="M99 29c4 5 5 13 3 21l-3 4c2-9 2-17 0-25z" opacity=".85"/></svg><span class="kw-pro-tc">00:12:15</span></span><span class="kw-pro-bin__cap"><b>12B-2</b><span class="kw-pro-take">2</span></span><span class="kw-pro-line">“Who put you there?”</span></li><li role="option" aria-selected="false" tabindex="-1"><span class="kw-pro-bin__thumb"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" aria-hidden="true"><rect class="w" width="160" height="90"/><circle class="l" cx="26" cy="22" r="11" opacity=".35"/><circle class="l" cx="46" cy="33" r="5" opacity=".25"/><path class="b" d="M40 90c0-19 19-29 44-29s44 10 44 29z"/><rect class="s" x="76" y="52" width="16" height="14"/><ellipse class="s" cx="84" cy="40" rx="17" ry="21"/><path class="h" d="M66 42c0-17 8-25 19-25s18 8 18 23c-4-9-10-13-18-13s-14 7-19 15z"/><path class="m" d="M99 29c4 5 5 13 3 21l-3 4c2-9 2-17 0-25z" opacity=".85"/></svg><span class="kw-pro-tc">00:39:11</span></span><span class="kw-pro-bin__cap"><b>12B-4</b><span class="kw-pro-take" data-circled title="Circled take">4</span></span><span class="kw-pro-line">“I didn’t shoot this.”</span></li><li role="option" aria-selected="false" tabindex="-1"><span class="kw-pro-bin__thumb"><svg class="kw-pro-pic" viewBox="0 0 160 90" preserveAspectRatio="xMidYMid slice" aria-hidden="true"><rect class="d" width="160" height="90"/><rect class="m" x="12" y="9" width="136" height="70"/><rect class="f" x="12" y="62" width="136" height="17" opacity=".55"/><circle class="f" cx="80" cy="34" r="9"/><path class="f" d="M62 79c0-15 8-23 18-23s18 8 18 23z"/></svg><span class="kw-pro-tc">00:22:00</span></span><span class="kw-pro-bin__cap"><b>12C-2</b><span class="kw-pro-take" data-circled title="Circled take">2</span></span><span class="kw-pro-line">Selvi on the monitor.</span></li><li role="option" aria-selected="false" tabindex="-1" data-offline><span class="kw-pro-bin__thumb"><span class="kw-pro-offline">Media offline</span><span class="kw-pro-tc">00:30:09</span></span><span class="kw-pro-bin__cap"><b>12D-1</b><span class="kw-pro-take">1</span></span><span class="kw-pro-line">“Run it from the beginning.”</span></li></ul></section>
```

## Accessibility

### Keyboard
| Key | Does |
|---|---|
| ↑ / ↓ | Move selection (list); arrows in four directions (thumbnails) |
| Enter | Open the clip in the source viewer |
| ⌘ F | Focus search |
| Space | Play the selected clip in the source viewer |

### ARIA
- The list is a `<table>` with `scope="col"` headers; selection is `aria-selected` on rows with a roving `tabindex`.
- Thumbnails are `role="listbox"` with `role="option"` cards.
- Circled and offline are written as text, not only drawn.

## For agents

### Rules

- **Must** show scene, shot and take for every clip and mark circled takes.
- **Must** write Media offline in words on the clip.
- **Always** keep Name and Duration visible at any width.
- **Never** sort by file name by default; sort by slate.
- **Always** let search find script lines and notes, not only names.

### AI readiness test

**Task:** Build the dailies bin for shoot day 7.

**Give the agent:** Bin, Edit timeline, Timecode display.

**Constraint:** Two cameras, A and B; the script supervisor's circled takes are imported.

**A reliable answer:**
- Slate names
- Circled takes ringed
- Start and duration timecode tabular
- Script line column
- Offline written in words
- List and thumbnail views
