Opus Motion ★ Star on GitHub

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.

Gauge KPI dial: three frames of the animated chart, start, middle and end
Gauge KPI dial — start, middle and end of the 5.0-second motion.

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.

  • gauge
  • dial
  • kpi
  • speedometer
  • needle
  • score
  • nps
  • meter
  • chart
  • data
  • infographic
  • count-up
  • dashboard

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
label title subtitle prefix
Colour props
accent background ink
Mood
hud
Roles
subject

Use Gauge KPI dial in Remotion, React or HTML

Remotion project

terminal
# 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

tsx
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

html
<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)

json
{
  "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.

PropDefaultWhat it does
value78the reading the needle lands on
min0dial minimum
max100dial maximum
target85target 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. "%"
decimals0decimal 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
ticks5number of tick intervals around the dial
tickDecimals0decimals on tick labels
showLegendtruelegend 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)
startAt8frame the dial starts drawing
speed1animation speed multiplier

Notes & credits

Technique sources:

  • original round-3 chart motion