abner

A/B testing for videos. Point it at two (or more) video files — different encodes, different upscalers, different grades of the same content — and flip between them while they play in frame-locked sync.

abner original.mp4 encoded.mp4
abner --view delta original.mp4 encoded.mp4
abner a.mp4 b.mp4 c.mp4          # three-way works too
abner                            # launch window — drag clips onto it

--view takes overlay, sbs, delta, split, checker or blend, so every mode is reachable from the command line.

Drag and drop

Run abner with no arguments and drag clips onto the launch window. One file fills slot A and the window keeps waiting; two land as A and B and start playing; more add C, D… — in the order the platform hands them over, which for a Finder multi-select is the order they appear in that window, so drop them one at a time if it matters which is A. Dropping onto a running comparison adds streams — hold ⌘ while dropping to replace the whole set instead. A single path on the command line (abner reference.mp4) opens the same half-filled window.

Every load rewinds all streams to 0, so an arrival is frame-locked with what was already playing rather than joining mid-flight.

Born out of the switchblade project's graphics stack: in-process libav decode (VideoToolbox for h264/hevc/prores), a wgpu renderer with mip-chained video textures (no minification shimmer on 4K sources), idle-throttled render loop, and mpv-style fake fullscreen.

Sync model

One master clock drives every stream. Players decode into small bounded queues; each frame the app pops everything due and shows the newest. Flipping the displayed video (Enter) switches textures, not players — the other stream was already decoding the same instant, so the flip is seamless and time never jumps. Pause stops the clock (backpressure stalls every decoder for free); framesteps are exact seeks whose landing frame's true pts is adopted back into the clock, so stepping can't accumulate drift.

Keys

Key	Action
Enter	flip to the next video (in overlay mode)
Space	pause / play
< > (or , .)	frame-step back / forward
← →	seek ±1s
1…9	show clip 1, 2, … (A, B, …) directly
V / Shift-V	next / previous view, cycling through:
	overlay — videos stacked, flip with Enter (the classic A/B)
	side-by-side — all videos in a row
	delta — amplified |A−B| difference (-/= adjusts gain)
	split — vertical wipe, divider follows the pointer
	checker — checkerboard mix (-/= adjusts tile size)
	blend — dissolve between A and B (-/= adjusts mix)
pinch	photo-style zoom on the pointer — every video pans/zooms to the same spot
drag / scroll	pan while zoomed (synced across videos)
M	toggle mask painting on the focused video (pauses on entry)
+ / -	enlarge / shrink the brush in mask mode (= also enlarges)
S	save the focused mask in mask mode
Z	reset zoom
[ ]	slow down / speed up playback (0.25×–4×; Backspace resets)
F	fullscreen (borderless, same Space, instant)
Tab	toggle the info overlay (filename, path, res, fps, codec, bitrate, size, duration)
Q	quit
Esc	leave fullscreen, else quit

In compare modes (delta/split/checker/blend) the pair is the active video vs the next one; Enter rotates which pair you're looking at. Big letter badges mark what you're seeing — A hugs the left edge, B the right. With the overlay hidden, Enter still flashes the letter briefly so you know where you are.

Mask painting

Press M with a comparison loaded. The focused video fills the window with a 50% red overlay. Click or drag to paint with the circular brush: painted pixels become 50% blue, replacing red rather than stacking another tint. + / - changes brush diameter (shown in source-image pixels); pinch to zoom and scroll to pan. The brush outline follows the same transform as the image. Enter (or a clip's number key) switches the focused video and its separate mask. M or Esc hides the layer and restores the comparison view; masks persist in memory, and playback stays paused until Space.

S saves beside the focused video: example.mov becomes example.mask.png. The PNG is 8-bit grayscale at the displayed video's native resolution (including its display rotation), with painted blue = white (255) and untouched red = black (0). Saving runs in the background and reports success or failure on the right of the status line; a successful save replaces an existing file at that path. Masks apply to the whole clip, not an individual frame. They start blank each session; existing PNG masks are not loaded automatically. Replacing the video set clears its masks.

For a direct visual check without keyboard automation: abner --mask a.mp4 b.mp4. The ordinary --view selection is restored when leaving mask mode.

The HUD

Corner brackets frame the active stream, an A|B toggle in the title bar shows what's on screen, and the top-left block lists every clip's filename, resolution, fps, codec, bitrate, size, duration and path. Along the bottom sits a transport — prev / play-pause / next, a seek bar you can click and drag, and the view and timecode readout. The transport is hover-revealed: it fades out after a few seconds of stillness and any pointer movement brings it back. Beneath it a status line stays put, vim/helix style — dark blue in A/B, dark red while masking: a chip on the left names the input mode (A/B TEST or MASK) and keycaps beside it list that mode's keys; mask mode adds the focused clip, brush size and save status on the right. Tab hides the whole HUD (the status line stays in mask mode).

Ideas for more views

• Loupe — a magnifier following the pointer showing A|B split at 4–8× inside the ring
• Flicker — auto-alternate A/B every N frames (temporal delta your eyes compute)
• Vertical split / horizontal wipe
• Heatmap delta — false-color per-pixel error with a scale
• Signed delta — grey = equal, warm = A brighter, cool = B brighter

Requirements

• macOS (first target; the shader/loop are portable, fullscreen + font paths are mac-specific)
• ffmpeg 8.x — the ffprobe CLI for metadata and the dev libraries the in-process decoder links against (brew install ffmpeg provides both)

Build

cargo build --release
./target/release/abner --help
./packaging/build-app.sh --open      # self-contained Abner.app (bundles the ffmpeg dylibs, ad-hoc codesigns)
./packaging/build-app.sh --install   # …and copy it to /Applications

The bundle carries its own copies of the ffmpeg libraries, so it runs on a machine without Homebrew; the ffprobe CLI it shells out to at startup is still looked up on PATH (--with-cli-tools copies that in too). The app icon is assets/app-icon.png — drop a new square PNG there and both the bundle's .icns and the bare binary's Dock icon follow. Double-clicking a video on the bundle doesn't load it yet (see TASKS.md).

cargo test runs the regression suite: master-clock draining, exact seek, two-player sync, framestep adoption, reader-thread cleanup (including a reader wedged in libav I/O on a FIFO), redraw cadence. It generates tiny test clips with ffmpeg under $TMPDIR.

A startup ffprobe that doesn't return within 30s (a file on a volume that has gone away) is an error rather than a hang; a decoder whose seek fails is marked failed in the HUD rather than silently drifting out of sync.

License

MIT