Effect #055 in our rendered series
Hand-drawn callout circle
A wobbled marker circle draws around one tile, the others dim, and a curved arrow points to a handwritten label.
Rendered by us at 1920x1080 over a shot from Tears of Steel (Blender Foundation, CC-BY 3.0). Expand plays the full 1080p file.
Edit in Premiere, Resolve or After Effects? Jump to editor templates. Making many versions of the same video? Use the code route.
Make this effect with
Built and tested by us
Other ways, not tested by us
Use it in a real edit
The demo above already plays the composition over real footage: the clip is a muted <video> layer under the graphics (the file plate.mp4 in the code below). Replace that file with your own clip and render again. To use the graphics in an editor instead, switch the background off and render a transparent MOV (an H.264 MP4 cannot carry transparency):
npx hyperframes render . -o overlay.mov --format mov --fps 24 --variables '{"plate":false}'The routes in full
With Claude Code: the prompt we used
Rendered and tested by us in HyperFrames 0.8.10 on Nov 7, 2026.
Make a 5 second callout where a hand-drawn circle is drawn around one item in a simple mock app card, with a short handwritten label and an arrow, for tutorials and screen recordings. Use a generic mock card with template text, not a real product.
What changed since this prompt: the demo on this page is our second version, 5 seconds long, rebuilt on a shot from Tears of Steel with the same animation idea. The full composition below is the one we rendered; its build log lists every change.
Built by a Claude Code subagent (Sonnet) from the HyperFrames registry block hw-callout-circle, HyperFrames 0.8.10. Claude Code then checked the composition with hyperframes lint and hyperframes check before we rendered it.
What we had to correct (5 notes from the build log):
- 2026-11-06 09:02 lint: 0 errors, 0 warnings. No fixes needed.
- hyperframes check: Layout 0 errors. Contrast failed with text flagged on fading frames only. Quoted: "#csub 1.36:1 (need 3:1, t=0.278s)" (the card is fading in over the dark plate), "#csub 1.61:1 (need 3:1, t=4.722s)" and three tile captions at t=4.722s (the card is fading out). At rest the text passes (no flag between 0.5 s and 4.2 s), so these are fade frames, by design.
- Real defects found by eye in the first render and fixed: (1) the marker circle cut through the first letters of the neighbouring tile's text ("Item three"); tiles are now 330 px wide with 120 px gaps and the loop is 250 by 240 px, so it stays clear of the neighbour's text. (2) Tiny red dots showed before the pen drew (round line caps on a fully hidden dash); the three strokes now start at opacity 0 and appear as each one starts drawing. (3) Dimmed tiles went to 0.45 opacity and were hard to read; now 0.6.
- Render: flash check passed. Frames at 0.5, 1.2, 1.9, 2.6, 3.4 and 4.0 s checked again by eye after the fixes.
- v2 (7 Nov 2026): real footage from Tears of Steel, plates dz_bridge. Circles real things on the bridge shot. Positions are hard-coded for this shot (no real edit). First render had a broken variables attribute (an apostrophe in the item label ended the attribute and hid the footage); fixed with an HTML entity.
With HyperFrames code
Rendered and tested by us in HyperFrames 0.8.10 on Nov 7, 2026.
npx hyperframes add hw-callout-circle
npx hyperframes render . -o out.mp4 --fps 24Settings you can change without rebuilding (pass them with --variables):
| Setting | Name | Type | Default |
|---|---|---|---|
| Pen colour | stroke | color | #ff5a5f |
| Handwritten label (blank uses the item name) | label | string | |
| Circled item | item | enum | 2 |
| Show background | plate | boolean | true |
Our full composition (index.html, 7 KB)
<!doctype html>
<html lang="en" data-composition-variables='[
{"id":"stroke","type":"color","label":"Pen colour","default":"#ff5a5f"},
{"id":"label","type":"string","label":"Handwritten label (blank uses the item name)","default":""},
{"id":"item","type":"enum","label":"Circled item","default":"2","options":[{"value":"1","label":"Celia's face"},{"value":"2","label":"Robot hand"},{"value":"3","label":"Canal houses"}]},
{"id":"plate","type":"boolean","label":"Show background","default":true}
]'>
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=1920, height=1080" />
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@500;800&family=Caveat:wght@700&display=block" rel="stylesheet" />
<script src="gsap.min.js"></script>
<style>
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
html, body { width: 1920px; height: 1080px; overflow: hidden; background: transparent; }
#root { position: relative; width: 100%; height: 100%; overflow: hidden; background: transparent; }
.vid { position: absolute; left:0; top:0; width:1920px; height:1080px; object-fit: cover; }
#dim { position: absolute; inset: 0; background: #000; opacity: 0; }
#svg { position: absolute; left: 0; top: 0; width: 1920px; height: 1080px; overflow: visible; pointer-events: none; }
#chip { position: absolute; top: 840px; height: 120px; padding: 0 44px; display: flex; align-items: center; border-radius: 28px; background: rgba(14,18,28,0.92); border: 2px solid rgba(255,255,255,0.14); font-family: "Caveat", cursive; font-weight: 700; font-size: 84px; white-space: nowrap; opacity: 0; }
#ltxt { display: inline-block; }
</style>
</head>
<body>
<div id="root" data-composition-id="main" data-start="0" data-duration="5" data-fps="24" data-width="1920" data-height="1080">
<video class="plate vid" src="plate.mp4" muted playsinline data-start="0" data-duration="5"></video>
<div id="dim"></div>
<svg id="svg" viewBox="0 0 1920 1080"><path id="circ" fill="none" stroke-width="9" stroke-linecap="round" stroke-linejoin="round"></path><path id="arrow" fill="none" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"></path><path id="ah" fill="none" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"></path></svg>
<div id="chip"><span id="ltxt"></span></div>
</div>
<script>
window.__timelines = window.__timelines || {};
(function () {
const v = window.__hyperframes.getVariables();
if (!v.plate) document.querySelectorAll(".plate").forEach((e) => (e.style.display = "none"));
const tl = gsap.timeline({ paused: true });
function mulberry32(a) { return function () { a |= 0; a = (a + 0x6D2B79F5) | 0; let t = Math.imul(a ^ (a >>> 15), 1 | a); t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t; return ((t ^ (t >>> 14)) >>> 0) / 4294967296; }; }
const rnd = mulberry32(7);
const stroke = /^#[0-9a-fA-F]{6}$/.test(v.stroke) ? v.stroke : "#ff5a5f";
const item = Math.min(3, Math.max(1, parseInt(v.item, 10) || 2));
const ITEMS = [
{ cx: 1310, cy: 220, rx: 160, ry: 190, name: "Celia" },
{ cx: 1085, cy: 645, rx: 150, ry: 150, name: "Celia's robot hand" },
{ cx: 1790, cy: 160, rx: 120, ry: 190, name: "Canal houses" },
];
const IT = ITEMS[item - 1];
const labelText = (typeof v.label === "string" && v.label.trim()) ? v.label.trim() : IT.name;
document.getElementById("ltxt").textContent = labelText;
const chip = document.getElementById("chip"), ltxt = document.getElementById("ltxt");
chip.style.color = stroke;
["circ", "arrow", "ah"].forEach((id) => document.getElementById(id).setAttribute("stroke", stroke));
const cx = IT.cx, cy = IT.cy;
// hand-drawn loop: ellipse, 1.1 turns, seeded wobble, start slightly off the end
const rx = IT.rx, ry = IT.ry, N = 44, turns = 1.12, a0 = -2.3;
const pts = [];
for (let i = 0; i <= N; i++) {
const t = i / N, a = a0 + t * turns * Math.PI * 2;
const grow = 1 + 0.06 * Math.sin(t * 5) + (rnd() - 0.5) * 0.035 + t * 0.07;
pts.push([cx + Math.cos(a) * rx * grow, cy + Math.sin(a) * ry * grow]);
}
function smooth(p) {
let d = "M " + p[0][0].toFixed(1) + " " + p[0][1].toFixed(1);
for (let i = 0; i < p.length - 1; i++) {
const p0 = p[Math.max(0, i - 1)], p1 = p[i], p2 = p[i + 1], p3 = p[Math.min(p.length - 1, i + 2)];
const c1x = p1[0] + (p2[0] - p0[0]) / 6, c1y = p1[1] + (p2[1] - p0[1]) / 6;
const c2x = p2[0] - (p3[0] - p1[0]) / 6, c2y = p2[1] - (p3[1] - p1[1]) / 6;
d += " C " + c1x.toFixed(1) + " " + c1y.toFixed(1) + " " + c2x.toFixed(1) + " " + c2y.toFixed(1) + " " + p2[0].toFixed(1) + " " + p2[1].toFixed(1);
}
return d;
}
const circ = document.getElementById("circ"), arrow = document.getElementById("arrow"), ah = document.getElementById("ah");
circ.setAttribute("d", smooth(pts));
// label chip sits below the circled tile, centred on it and kept inside the safe margin
const fs = labelText.length > 16 ? 64 : 84; chip.style.fontSize = fs + "px";
const chipW = Math.min(1200, 88 + Math.round(labelText.length * fs * 0.48));
chip.style.width = chipW + "px";
let chipLeft = cx - chipW / 2;
chipLeft = Math.max(130, Math.min(1790 - chipW, chipLeft));
chip.style.left = chipLeft + "px";
chip.style.justifyContent = "center";
// curved arrow from chip top up to the circle bottom
const ax0 = Math.max(chipLeft + 60, Math.min(chipLeft + chipW - 60, cx)), ay0 = 836;
const ax1 = cx + 6, ay1 = cy + ry * 1.12 + 14;
const bend = (item === 1 ? 70 : item === 3 ? -70 : 55);
arrow.setAttribute("d", "M " + ax0 + " " + ay0 + " C " + (ax0 + bend) + " " + (ay0 - 25) + " " + (ax1 - bend) + " " + (ay1 + 50) + " " + ax1 + " " + ay1);
ah.setAttribute("d", "M " + (ax1 - 30) + " " + (ay1 + 38) + " L " + ax1 + " " + ay1 + " L " + (ax1 + 34) + " " + (ay1 + 36));
const cl = circ.getTotalLength(), al = arrow.getTotalLength(), hl = ah.getTotalLength();
circ.style.strokeDasharray = cl + " " + cl; arrow.style.strokeDasharray = al + " " + al; ah.style.strokeDasharray = hl + " " + hl;
tl.fromTo("#dim", { opacity: 0 }, { opacity: 0.22, duration: 0.5, ease: "power2.out" }, 1.1);
tl.fromTo(circ, { opacity: 0 }, { opacity: 1, duration: 0.01 }, 1.2);
tl.fromTo(arrow, { opacity: 0 }, { opacity: 1, duration: 0.01 }, 2.1);
tl.fromTo(ah, { opacity: 0 }, { opacity: 1, duration: 0.01 }, 2.5);
tl.fromTo(circ, { strokeDashoffset: cl }, { strokeDashoffset: 0, duration: 0.8, ease: "power2.inOut" }, 1.2);
tl.fromTo(arrow, { strokeDashoffset: al }, { strokeDashoffset: 0, duration: 0.45, ease: "power2.inOut" }, 2.1);
tl.fromTo(ah, { strokeDashoffset: hl }, { strokeDashoffset: 0, duration: 0.2, ease: "power1.out" }, 2.5);
tl.fromTo(chip, { opacity: 0, y: 24, rotation: -3 }, { opacity: 1, y: 0, rotation: -1.5, duration: 0.2, ease: "power2.out" }, 2.45);
tl.fromTo(ltxt, { clipPath: "inset(-20% 102% -20% -4%)" }, { clipPath: "inset(-20% -4% -20% -4%)", duration: 0.5, ease: "power1.inOut" }, 2.55);
tl.to(["#dim", "#chip", "#svg"], { opacity: 0, duration: 0.5, ease: "power2.in" }, 4.4);
window.__timelines["main"] = tl;
})();
</script>
</body>
</html>
With Remotion
We have not built this effect in Remotion. If you use it, read its licence first: Individuals (personal or commercial use), organisations or teams with a total headcount of 3 or less, non-profits, and anyone evaluating Remotion before commercial use. A company does not qualify merely because it is unprofitable. Everyone not eligible for the Free License needs a Company License. Remotion licence FAQ, checked Nov 4, 2026.
In your editor: Premiere, Resolve, After Effects, CapCut
We have not reviewed an editor template for this effect yet.
Variations
The same composition rendered again with different settings. Nothing was rebuilt.
{"stroke":"#3b82f6","item":"1"}{"stroke":"#e6245f","item":"3","label":"Amsterdam canal houses"}{"stroke":"#ff5a5f","item":"2","label":"Celia's robot hand on the railing"}Spec and test details
- Engine
- HyperFrames 0.8.10, GSAP 3.14.2 (local copy)
- Length and frame rate
- 5 seconds at 24 fps, rendered at 1920x1080
- Video files on this page
- H.264: 1920x1080 for Expand (4693.3 KB), 1280x720 in the page (1554.6 KB), 640x360 in galleries (371.1 KB), no audio
- Picture check
- The 1080p file scores VMAF 97.75 against our render master and keeps 99% of its edge detail (measured by us with FFmpeg libvmaf and OpenCV)
- Footage
- Thom and Celia talking on a canal bridge, trees and canal houses behind, static camera, daylight (Tears of Steel, 0:26)
- Tested in editors
- None yet
- Flash check
- Passed: at most 0 general and 0 red flashes in any second. automated approximation of WCAG 2.3.1 on a 96x54 grid, whole loop including the restart; not a certification.
- Licence
- Composition adapted by us from the HyperFrames registry (Apache-2.0); text fonts from Google Fonts under the SIL Open Font License.
- Last tested
- Nov 7, 2026
- Machine
- Laptop: AMD Ryzen 7 7735U (8 cores, 16 threads), 31 GB RAM, Windows 11 Home; CPU rendering
Technical details: render times and file sizes
- Render of the 5-second master: 61.1 s (2 render workers, on the laptop above).
- full.mp4: 4693.3 KB
- hero.mp4: 1554.6 KB
- hero.webp: 65.5 KB
- tile.mp4: 371.1 KB
- tile.webp: 22.7 KB
- Variation "subtle": rendered in 64.7 s, 376.5 KB
- Variation "bold": rendered in 66.6 s, 370.6 KB
- Variation "long": rendered in 55 s, 372.3 KB
Credits
- Built from the HyperFrames registry component hw-callout-circle by HeyGen (Apache-2.0), adapted by us.
- Fonts from Google Fonts, under the SIL Open Font License.
- Footage: Tears of Steel, (c) Blender Foundation, mango.blender.org, licensed CC-BY 3.0. We cropped the shots to 16:9 and laid our graphics over them.
- Editor templates and other routes on this page belong to their creators, who are credited on each card.
Related effects and jobs
Page checked on Nov 4, 2026.


