Effect #054 in our rendered series
Usage arc meter
A half-circle gauge draws on while a number counts up, with a needle tick and a warning colour above a threshold.
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 14, 2026.
Make a 5 second half-circle usage gauge: an arc fills from empty to a sample value with a needle or end dot, a number counts up in the middle and a small caption says Sample usage, then a clean exit, for SaaS and dashboard explainers. Use sample text only.
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 mk-usage-arc, 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, 1 warning. Warning: overlapping GSAP tweens on #num scale at 2.84s (the pop-in and settle tweens met at the same instant).
- 2026-11-06 09:03 lint after moving the settle tween to 2.85s: 0 errors, 0 warnings.
- hyperframes check: "Check passed", 0 errors, 1 warning, 18 info (container_overflow of the oversized #world plate layer and panel_out_of_canvas for the soft blob #b1, both the intentional moving background). Contrast 23/23 pass.
- Render: flash check passed. Frames at 0.6, 1.2, 2.0, 3.0, 4.0 and 4.6 s by eye: arc draws on, number counts, needle tick follows the dot, exit fades cleanly. Noted: the "Sample usage" caption sits close under the number; readable, left as is.
- v2 (14 Nov 2026): rendered again from the current source. Every number on screen comes from our own measured test results (labelled Measured by us, 2026); frames and the poster were checked by eye.
With HyperFrames code
Rendered and tested by us in HyperFrames 0.8.10 on Nov 14, 2026.
npx hyperframes add mk-usage-arc
npx hyperframes render . -o out.mp4 --fps 24Settings you can change without rebuilding (pass them with --variables):
| Setting | Name | Type | Default |
|---|---|---|---|
| Gauge colour | accent | color | #3b82f6 |
| Measurement | metric | enum | wer |
| Warning colour above 80 percent | warning | enum | off |
| Show background | plate | boolean | true |
Our full composition (index.html, 9 KB)
<!doctype html>
<html lang="en" data-composition-variables='[{"id":"accent","type":"color","label":"Gauge colour","default":"#3b82f6"},{"id":"metric","type":"enum","label":"Measurement","default":"wer","options":[{"value":"wer","label":"Caption word error rate, 15.2 percent"},{"value":"series","label":"Numbered reels at 3x views, 23 of 95"},{"value":"visible","label":"Caption phrases visible, 23 of 23"}]},{"id":"warning","type":"enum","label":"Warning colour above 80 percent","default":"off","options":[{"value":"on","label":"On"},{"value":"off","label":"Off"}]},{"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;700;800&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; }
#plate { position: absolute; inset: 0; background: radial-gradient(120% 90% at 30% 40%, #1b2335 0%, #0b0d12 70%); overflow: hidden; }
#world { position: absolute; left: -200px; top: -120px; width: 2400px; height: 1320px; }
.blob { position: absolute; border-radius: 50%; filter: blur(60px); }
.b1 { width: 760px; height: 760px; left: 180px; top: 260px; background: #ff5a1f; opacity: 0.35; }
.b2 { width: 900px; height: 900px; left: 1200px; top: 80px; background: #2f6bff; opacity: 0.45; }
.grid { position: absolute; inset: 0; background-image: linear-gradient(rgba(255,255,255,0.05) 1px, transparent 1px), linear-gradient(90deg, rgba(255,255,255,0.05) 1px, transparent 1px); background-size: 120px 120px; }
#stage { position: absolute; inset: 0; display: flex; align-items: center; justify-content: flex-start; padding-left: 70px; }
#card { position: relative; width: 960px; height: 800px; border-radius: 44px; background: rgba(14,18,28,0.92); border: 2px solid rgba(255,255,255,0.12); box-shadow: 0 40px 90px rgba(0,0,0,0.45); opacity: 0; }
#tag { position: absolute; left: 0; right: 0; top: 52px; text-align: center; font-family: "Inter", sans-serif; font-weight: 700; font-size: 26px; letter-spacing: 0.18em; text-transform: uppercase; color: rgba(255,255,255,0.55); }
#gauge { position: absolute; left: 80px; top: 150px; width: 800px; height: 460px; overflow: visible; }
#readout { position: absolute; left: 0; right: 0; top: 380px; display: flex; flex-direction: column; align-items: center; gap: 6px; }
#num { font-family: "Inter", sans-serif; font-weight: 800; font-size: 150px; line-height: 1; letter-spacing: -0.04em; color: #fff; font-variant-numeric: tabular-nums; }
#cap { white-space: nowrap; font-family: "Inter", sans-serif; font-weight: 700; font-size: 36px; color: rgba(255,255,255,0.7); opacity: 0; }
.end { position: absolute; top: 626px; font-family: "Inter", sans-serif; font-weight: 700; font-size: 28px; color: rgba(255,255,255,0.45); }
#e0 { left: 118px; } #e1 { left: 806px; }
/* footage plate (v2): real footage, pinned, no generated blobs */
#plate { background: #000 !important; }
#world { left: 0 !important; top: 0 !important; width: 1920px !important; height: 1080px !important; transform: none !important; }
#world .blob, #world .grid { display: none !important; }
#pv { position: absolute; left: 0; top: 0; width: 1920px; height: 1080px; object-fit: cover; }
#scrim { position: absolute; inset: 0; background: rgba(0,0,0,0.35); }
/* data family v2: dashboard window over dimmed footage */
#scrim { background: rgba(4,6,12,0.58) !important; }
.win { position: absolute; border-radius: 26px; background: rgba(11,15,25,0.94); border: 2px solid rgba(255,255,255,0.16); box-shadow: 0 30px 80px rgba(0,0,0,0.55); overflow: hidden; font-family: "Inter", "Montserrat", sans-serif; }
.win .bar { position: absolute; left: 0; right: 0; top: 0; height: 64px; background: rgba(255,255,255,0.06); border-bottom: 2px solid rgba(255,255,255,0.10); display: flex; align-items: center; padding-left: 28px; gap: 12px; color: #aab3c5; font-size: 24px; font-weight: 500; }
.win .bar i { width: 16px; height: 16px; border-radius: 50%; background: #ff5f57; display: block; }
.win .bar i:nth-child(2) { background: #febc2e; } .win .bar i:nth-child(3) { background: #28c840; }
.win .bar b { margin-left: 18px; font-weight: 500; }
.chip { position: absolute; font-family: "Inter", "Montserrat", sans-serif; font-weight: 700; font-size: 26px; padding: 8px 20px; border-radius: 999px; background: rgba(255,210,63,0.14); border: 2px solid #ffd23f; color: #ffd23f; white-space: nowrap; }
</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">
<div id="plate"><div id="world"><video id="pv" src="plate.mp4" muted playsinline data-start="0" data-duration="5"></video><div id="scrim"></div><div class="blob b1" id="b1"></div><div class="blob b2" id="b2"></div><div class="grid"></div></div></div>
<div id="stage"><div id="card">
<div id="tag">Caption test</div>
<svg id="gauge" viewBox="0 0 800 460">
<path id="trk" d="M 70 400 A 330 330 0 0 1 730 400" fill="none" stroke="rgba(255,255,255,0.12)" stroke-width="34" stroke-linecap="round"></path>
<path id="fa" d="M 70 400 A 330 330 0 0 1 730 400" fill="none" stroke="#3b82f6" stroke-width="34" stroke-linecap="round"></path>
<path id="fw" d="M 70 400 A 330 330 0 0 1 730 400" fill="none" stroke="#ff5a4d" stroke-width="34" stroke-linecap="butt"></path>
<g id="needle"><line x1="140" y1="400" x2="98" y2="400" stroke="#fff" stroke-width="9" stroke-linecap="round"></line><circle cx="70" cy="400" r="26" fill="#fff"></circle></g>
</svg>
<div id="readout"><div id="num">0%</div><div id="cap">Caption word error rate</div></div>
<div class="chip" style="left:50%;transform:translateX(-50%);top:716px;font-size:24px">Measured by us, 2026</div>
<div class="end" id="e0">0</div><div class="end" id="e1">100</div>
</div></div>
</div>
<script>
window.__timelines = window.__timelines || {};
(function () {
const v = window.__hyperframes.getVariables();
if (!v.plate) document.getElementById("plate").style.display = "none";
const tl = gsap.timeline({ paused: true });
function clamp(n, a, b) { return Math.max(a, Math.min(b, n)); }
const accent = /^#[0-9a-fA-F]{6}$/.test(v.accent) ? v.accent : "#3b82f6";
const METRICS = {
wer: { val: 15.2, tag: "Caption test", cap: "Caption word error rate" },
series: { val: 24.2, tag: "Reel teardowns", cap: "Numbered reels at 3x views" },
visible: { val: 100, tag: "Caption test", cap: "Phrases visible, 23 of 23" },
};
const M = METRICS[v.metric] || METRICS.wer;
document.getElementById("tag").textContent = M.tag; document.getElementById("cap").textContent = M.cap;
const value = M.val;
const warnOn = v.warning !== "off" && v.warning !== false;
const THR = 80, WARN = "#ff5a4d";
const L = Math.PI * 330;
const fa = document.getElementById("fa"), fw = document.getElementById("fw"), needle = document.getElementById("needle"), num = document.getElementById("num");
fa.setAttribute("stroke", accent);
fw.setAttribute("stroke", WARN);
fa.style.strokeDasharray = L + " " + (L * 2);
const prog = { p: 0 };
function paint() {
const p = prog.p;
const accEnd = warnOn ? Math.min(p, THR) : p;
fa.style.strokeDasharray = (accEnd / 100 * L).toFixed(2) + " " + (L * 2).toFixed(2);
fa.style.opacity = accEnd > 0.2 ? "1" : "0";
const wlen = warnOn ? Math.max(0, p - THR) / 100 * L : 0;
fw.style.strokeDasharray = wlen.toFixed(2) + " " + (L * 2).toFixed(2);
fw.style.strokeDashoffset = String(-(THR / 100 * L).toFixed(2));
fw.style.opacity = wlen > 0.2 ? "1" : "0";
needle.setAttribute("transform", "rotate(" + (p * 1.8).toFixed(2) + " 400 400)");
num.textContent = (Number.isInteger(value) ? Math.round(p) : p.toFixed(1)) + "%";
num.style.color = (warnOn && p > THR) ? WARN : "#fff";
}
paint();
tl.fromTo("#card", { opacity: 0, scale: 0.9, y: 30 }, { opacity: 1, scale: 1, y: 0, duration: 0.55, ease: "back.out(1.4)" }, 0.2);
tl.fromTo(prog, { p: 0 }, { p: value, duration: 2.0, ease: "power3.out", onUpdate: paint }, 0.7);
tl.fromTo("#cap", { opacity: 0, y: 20 }, { opacity: 1, y: 0, duration: 0.45, ease: "power3.out" }, 1.9);
tl.fromTo("#num", { scale: 1 }, { scale: 1.08, duration: 0.14, ease: "power2.out" }, 2.7);
tl.to("#num", { scale: 1, duration: 0.5, ease: "elastic.out(1,0.5)" }, 2.85);
tl.to(prog, { p: Math.max(0, value - 3), duration: 0.35, ease: "sine.inOut", onUpdate: paint }, 3.4);
tl.to(prog, { p: value, duration: 0.35, ease: "sine.inOut", onUpdate: paint }, 3.75);
tl.to("#card", { opacity: 0, scale: 0.94, y: -20, duration: 0.5, ease: "power2.in" }, 4.3);
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.
{"accent":"#2fd0a0","metric":"wer"}{"accent":"#a855f7","metric":"series"}{"accent":"#3b82f6","metric":"visible","warning":"off"}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 (4012.9 KB), 1280x720 in the page (1339.2 KB), 640x360 in galleries (321.1 KB), no audio
- Picture check
- The 1080p file scores VMAF 98.65 against our render master and keeps 99% of its edge detail (measured by us with FFmpeg libvmaf and OpenCV)
- Footage
- scientist with glasses behind hologram UI, neon, 5 s (Tears of Steel, 5:02)
- 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 14, 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: 81.1 s (2 render workers, on the laptop above).
- full.mp4: 4012.9 KB
- hero.mp4: 1339.2 KB
- hero.webp: 31.1 KB
- tile.mp4: 321.1 KB
- tile.webp: 11.4 KB
- Variation "subtle": rendered in 72 s, 321.5 KB
- Variation "bold": rendered in 79.9 s, 323.9 KB
- Variation "full": rendered in 82.8 s, 325 KB
Credits
- Built from the HyperFrames registry component mk-usage-arc 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.


