Skip to content

lookbkdev/lookbk-skills / skills/signal-glitch-hero

signal-glitch-hero

Verified

Build a website hero where your own photograph and headline arrive through a corrupted broadcast signal that locks on - vertical hold, horizontal sync and colour burst lock in turn while a stream joined without a key frame smears its macroblocks until a refresh sweeps the frame clean - then holds a sharp, readable frame for about 70% of a 12-second loop; the pointer is interference that drags blocks and tears lines. Your photo, colours, fonts and copy; lockup or editorial layout; dark or light pages with on-brand failure colours. Raw WebGL1, no libraries. One self-contained HTML page plus a paste-in embed on the Motion Heroes kit v2, checked at four widths, a title-safe grade that guarantees the headline's contrast over the photo, a still picture for reduced motion and failures, and a frame-exact looping 1080p MP4. Use for a film, TV, streaming or radio brand, a festival, an audio or camera product, a launch or any brand whose photo deserves an entrance.

Signal Glitch Hero

The first screen of a website, shown the way a receiver shows a channel it is tuning in. Your photograph and your headline are one broadcast frame (the letters are burned into the picture; the page keeps the real text for readers and search). The frame reaches the screen through two real chains, each with its own lock, and every artefact you see is one named failure that ends when its circuit locks:

  • The cable (analog). Vertical hold: the frame rolls upward, the blanking bar between frames passing through, and slows to a stop. Horizontal sync: the lines shear, the top of the frame flags, the lines jitter, then the oscillator rings once and settles. Colour: the colour killer holds the picture monochrome (on a light page it takes the paper's white, not grey) until the colour burst locks; colour then swings into hue and sits off the edges by a chroma delay that settles to zero.
  • The stream (compressed). Joined without a key frame, the decoder has only an empty reference: motion vectors drag and stretch the macroblocks (the datamosh melt), some blocks take a wrong vector and copy a neighbour, residuals paint the picture in, detailed blocks first. A rolling intra refresh then sweeps the frame clean, by columns (the headline locks in reading order) or by rows (the picture locks before a headline at the foot).

Then the frame holds, clean and still: 8.5 of every 12 seconds at the defaults, with one 0.2 s burst error that the next refresh repairs. At the end the signal fades (blocks freeze and drift, colour is lost, the frame accelerates into a roll) straight into the next acquisition, so the loop closes with no cut. The plates under the lede and the call to action are the receiver's own on-screen display, keyed over the picture after the decoder: they never tear, and while the signal is unlocked a clean margin, a hairline and a soft shadow show them sitting on top of it.

On a live page the pointer is interference: its speed becomes the motion vectors of the blocks near it and tears the lines it crosses; standing still lets the stream repair it within a second.

Bring your own photo. The two examples ship pictures made for Lookbk; the hero is meant for yours. The build resizes it to at most 1920 px wide, encodes it as a JPEG of 400 KB or less and ships only that file.

Layouts: the kit's lockup (the photo is the whole hero, the headline fitted across it, a colophon band under it) or editorial (the photo in columns 4 to 12 bleeding off the right edge, the headline at the foot of columns 1 to 8, the copy in a ruled column). On phones the kit's single column, macroblocks at three quarters of their size. No chip, no pill button, no second headline colour.

What you need

  • Node.js 18 or newer. Nothing to install.
  • Your photograph (JPEG, PNG or WebP, ideally 1920 px wide or more), with room for a headline.
  • ffmpeg, to resize and encode the photo at build time and for the video (or set FFMPEG_PATH). Without it a JPEG of 400 KB or less is shipped as it is.
  • Chrome, Chromium or Edge, for the checks and the recording (set CHROME_PATH if it isn't found).
  • Internet access when the page is opened, for the fonts (pinned with integrity hashes).

Steps

1. Collect the brand, the photo and the words

  • Name and a logo (.svg) or the name set in the display face.
  • Your photograph. Look at where the headline will sit: lockup puts it across the middle, editorial at the bottom left. The title-safe grade keeps the headline readable over anything, but a calm area there looks best.
  • Colours: the page ground, the ink at 7:1 on it, one accent (the call to action's rule).
  • The words: a headline of two or three short lines, a lede, one call to action, an optional plain link, up to four links and one bar link.

2. Write hero.json

Copy examples/late-reel/hero.json (dark, lockup, column refresh) or examples/halde/hero.json (light, editorial, row refresh), put your photo next to it, and replace everything.

FieldWhat it isLimit
compositionlockup or editorial–
brand, nav[], actionThe bar28 / 16 / 20
hero.titleThe headline; \n breaks a line (3 lines at most); *words* set the italic in the same colour60
hero.lede, hero.cta, hero.linkThe copy on the plates200 / 26 / 26
thememode, background, ink, accent, plate, fonts { display, body, mono, weight, advance }, rules (editorial)–
motion, metaAs in every Motion Heroes package–

The effect settings:

SettingRangeDefaultWhat it does
picturepath(required)Your photo, relative to hero.json. Resized to at most 1920 px and encoded to 400 KB or less; the build stops if it can't
focusX, focusY0 to 10.5Which part of the photo stays in view when it is cropped to the field
phoneFocusX0 to 10.5focusX on phones (a narrow, tall crop)
cycle10 to 2012Seconds from one acquisition to the next: the loop of the video
acquire1.6 to 3.62.4Seconds from the first sync to a clean lock
fade0.6 to 1.81.1Seconds the signal takes to fade at the end. acquire + fade may be at most 40% of cycle
refreshcolumns, rowscolumnsHow the intra refresh sweeps the frame clean
block8 to 3216Macroblock size in CSS px (phones use three quarters)
mosh0 to 10.8How far the motion vectors drag the blocks
tear0 to 10.7Shear, flagging and line jitter while horizontal sync is unlocked
rolltrue, falsetrueThe frame rolls with its blanking bar until vertical hold locks
chroma0 to 10.7The chroma delay while the colour burst settles
bursttrue, falsetrueOne 0.2 s burst error in the middle of the held frame
buffercolourthe ground, 25% darker or lighterThe decoder's empty reference, seen before the picture arrives
blankingcolour#050505The blanking bar. On a light page use a warm paper tone (the example uses #d6ccbc)
grade3 to 74.5The contrast the headline is guaranteed over the photo (the photo is held darker, or lighter on a light page, in a feathered area under the lines only)
followtrue, falsetrueThe pointer as interference
grain0 to 10.4A fixed grain, the same on every frame so the loop closes

3. Build, check, look, record

node <skill>/scripts/build.mjs hero.json out
node <skill>/scripts/check.mjs out/index.html
node <skill>/scripts/record.mjs out/index.html --still 6 --png out/still.png
node <skill>/scripts/record.mjs out/index.html --still 1.95 --png out/locking.png
node <skill>/scripts/record.mjs out/index.html --still 6 --size 390x844 --scale 2 --png out/phone.png
node <skill>/scripts/record.mjs out/index.html --seconds 12 --size 1920x1080 --fps 30

The build prints the photo's encoded size. Look at the held frame (6 s) for the composition and at 1 to 2.5 s for the acquisition. Record cycle seconds for a seamless loop; the video opens on the acquisition and its poster is the held frame.

4. Put it live

Upload out/index.html with out/assets/, or paste out/embed.html into your page and copy assets/ next to it.

Troubleshooting

  • The build says the photo is over 400 KB: crop it to the part you use, or export it smaller; detailed, noisy photos compress worst.
  • The build says it needs ffmpeg: install ffmpeg (or set FFMPEG_PATH), or save the photo yourself as a JPEG of 400 KB or less.
  • A haze shows around the headline: the title-safe grade is lifting (light page) or dimming (dark page) a busy part of the photo. Move focusX/focusY so the headline sits on a calmer area, or lower grade toward 3.
  • The glitch feels too long: lower acquire and fade, or raise cycle; the held frame is cycle - acquire - fade seconds.
  • No picture, just the headline on a dimmed photo: WebGL isn't available or reduced motion is on; that is the still picture, by design.

Files

  • scripts/build.mjs, scripts/check.mjs, scripts/record.mjs: the entry points (build, page checks, recorder).
  • scripts/kit/: the Motion Heroes kit v2, identical in every v2 package (see KIT.md).
  • scripts/effect/effect.mjs: the settings, checks, the photo's resize and encode, and the still.
  • scripts/effect/effect.js: the programme frame, the title-safe grade and the signal chains (WebGL1).
  • examples/late-reel/, examples/halde/: two examples, each with its photo.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall