Data · gauge-kpi-dial
Gauge KPI dial
A 240-degree dial gauge: coloured zone bands sweep on, tick labels appear, the needle swings to the value with a small overshoot and wobble while a big KPI number counts up in the colour of the zone it is in, with a target marker and zone legend.
A free, MIT-licensed animated chart from the Opus Motion Library — 616 motions for Remotion, React and plain HTML.

What Gauge KPI dial is for
One headline KPI with a good / ok / bad reading: NPS, uptime, conversion rate, utilisation, health score, goal progress. Set value, min, max, zones, prefix / suffix.
Details
- Category
- Animated charts & data visualisation
- Length
- 5.0 s (150 frames at 30 fps)
- Formats
- 16:9, 1:1, 9:16
- Weight
- light
- Transparent overlay
- yes
- Seamless loop
- no
- Text props
labeltitlesubtitleprefix- Colour props
accentbackgroundink- Mood
- hud
- Roles
- subject
Use Gauge KPI dial in Remotion, React or HTML
Remotion project
# copy this motion into your Remotion project
node cli/mgl.mjs add gauge-kpi-dial --to ../my-app/src
# render an mp4 (run in the library folder)
node cli/mgl.mjs render gauge-kpi-dial --props '{"label":"Customer satisfaction","title":"Satisfaction score","subtitle":"Current quarter against target","prefix":"","accent":"#2F6FED","background":"#0F1722","ink":"#EEF2F7"}'
# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export gauge-kpi-dial --as webm-alpha --props '{"label":"Customer satisfaction","title":"Satisfaction score","subtitle":"Current quarter against target","prefix":"","accent":"#2F6FED","background":"#0F1722","ink":"#EEF2F7"}'React / Next.js
import {MotionPlayer} from 'opus-motion-library/web';
<MotionPlayer
motion="gauge-kpi-dial"
props={{
label: 'Customer satisfaction',
title: 'Satisfaction score',
subtitle: 'Current quarter against target',
prefix: '',
accent: '#2F6FED',
background: '#0F1722',
ink: '#EEF2F7',
}}
playOnView
loop="auto"
/>Plain HTML / WordPress
<script src="opus-motion.element.js" defer></script>
<opus-motion motion="gauge-kpi-dial"
props='{"label":"Customer satisfaction","title":"Satisfaction score","subtitle":"Current quarter against target","prefix":"","accent":"#2F6FED","background":"#0F1722","ink":"#EEF2F7"}'>
</opus-motion>Compose spec (multi-scene video)
{
"width": 1920,
"height": 1080,
"fps": 30,
"scenes": [
{
"motion": "gauge-kpi-dial",
"props": {
"label": "Customer satisfaction",
"title": "Satisfaction score",
"subtitle": "Current quarter against target",
"prefix": "",
"accent": "#2F6FED",
"background": "#0F1722",
"ink": "#EEF2F7"
}
}
]
}Gauge KPI dial props
21 parameters — change any of them to make the motion yours.
| Prop | Default | What it does |
|---|---|---|
value | 78 | the reading the needle lands on |
min | 0 | dial minimum |
max | 100 | dial maximum |
target | 85 | target marker position (outside min..max = no marker) |
label | "Customer satisfaction" | caption under the big number |
title | "Satisfaction score" | headline (empty = none) |
subtitle | "Current quarter against target" | small line under the headline (empty = none) |
prefix | "" | text before numbers |
suffix | "%" | text after numbers, e.g. "%" |
decimals | 0 | decimal places on the big number |
zones | [{"to":40,"color":"#E5484D","label":"Needs work"},{"to":70,"color":"#F5A524","label":"O… | colour bands [{to, color, label?}] ascending by "to"; empty = one accent arc that fills to the value |
accent | "#2F6FED" | colour used when there are no zones |
ticks | 5 | number of tick intervals around the dial |
tickDecimals | 0 | decimals on tick labels |
showLegend | true | legend of the labelled zones |
targetLabel | "Target" | word before the target number |
background | "#0F1722" | page colour, or "transparent" |
ink | "#EEF2F7" | text, needle and track colour |
fontFamily | "" | CSS font family (empty = Space Grotesk) |
startAt | 8 | frame the dial starts drawing |
speed | 1 | animation speed multiplier |
Related motions

Progress rings stats
Goal progress and KPI sets: completion rates, daily targets, quota attainment, fitness-style stats, survey scores. Each ring has its own…
progress-rings-stats
Bar chart race
Rankings over time: market share by year, top products by quarter, followers by month, league tables, "who is winning" stories. Give the…
bar-race
Donut breakdown
Share-of-total stories on any brand: revenue by channel, budget split, traffic sources, survey answers, market share. Replace data,…
donut-breakdown
Funnel conversion
Sales and signup funnels, hiring pipelines, checkout drop-off, content-to-lead stories, any "how many survive each step" breakdown.…
funnel-conversion
Stacked area flow
Composition over time: revenue by product line, traffic by source, energy mix, users by plan, time spent by activity. Replace xLabels and…
stacked-area-flow
Waterfall bridge
Explaining how one number became another: revenue bridge, profit walk, budget variance, headcount change, price-volume-mix. Give the…
waterfall-bridge
Notes & credits
Technique sources:
- original round-3 chart motion