Type · number-counter
Number counter
Huge thin-mono counter that ticks or odometer-rolls through dwell keyframes, with unit, label and derived readouts (pressure, light, temperature, percent).
A free, MIT-licensed text animation from the Opus Motion Library — 616 motions for Remotion, React and plain HTML.

What Number counter is for
Depth/altitude/speed meters, growing stats, countdowns, progress percentages and scoreboards.
Details
- Category
- Text animations & kinetic typography
- Length
- 6.0 s (180 frames at 30 fps)
- Formats
- 16:9, 1:1, 9:16
- Weight
- light
- Transparent overlay
- yes
- Seamless loop
- no
- Text props
keyframeslabelunitprefixreadoutLabelskicker- Colour props
labelColornumberColoraccenttileColorblockColor- Image props
src- Mood
- dark, hud
- Roles
- type
- Pairs with
- Star glint flare, Flow lines (wind / heat / steam / waves), Confetti burst, Isometric bar-chart staircase
- Avoid
- Set label, unit ('' to hide 'm'), readouts [] and keyframes — defaults are the DEPTH dive sample.
Use Number counter in Remotion, React or HTML
Remotion project
# copy this motion into your Remotion project
node cli/mgl.mjs add number-counter --to ../my-app/src
# render an mp4 (run in the library folder)
node cli/mgl.mjs render number-counter --props '{"keyframes":[[0,0],[14,0],[62,760],[96,868],[168,10935],[180,10935]],"label":"DEPTH","unit":"m","prefix":"","readoutLabels":[],"kicker":"","labelColor":"#6c95ac","numberColor":"#a9d8ee","accent":"#ED3821","tileColor":"#2B3038","blockColor":"#111111","src":""}'
# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export number-counter --as webm-alpha --props '{"keyframes":[[0,0],[14,0],[62,760],[96,868],[168,10935],[180,10935]],"label":"DEPTH","unit":"m","prefix":"","readoutLabels":[],"kicker":"","labelColor":"#6c95ac","numberColor":"#a9d8ee","accent":"#ED3821","tileColor":"#2B3038","blockColor":"#111111","src":""}'React / Next.js
import {MotionPlayer} from 'opus-motion-library/web';
<MotionPlayer
motion="number-counter"
props={{
keyframes: [[0, 0], [14, 0], [62, 760], [96, 868], [168, 10935], [180, 10935]],
label: 'DEPTH',
unit: 'm',
prefix: '',
readoutLabels: [],
kicker: '',
labelColor: '#6c95ac',
numberColor: '#a9d8ee',
accent: '#ED3821',
tileColor: '#2B3038',
blockColor: '#111111',
src: '',
}}
playOnView
loop="auto"
/>Plain HTML / WordPress
<script src="opus-motion.element.js" defer></script>
<opus-motion motion="number-counter"
props='{"keyframes":[[0,0],[14,0],[62,760],[96,868],[168,10935],[180,10935]],"label":"DEPTH","unit":"m","prefix":"","readoutLabels":[],"kicker":"","labelColor":"#6c95ac","numberColor":"#a9d8ee","accent":"#ED3821","tileColor":"#2B3038","blockColor":"#111111","src":""}'>
</opus-motion>Compose spec (multi-scene video)
{
"width": 1920,
"height": 1080,
"fps": 30,
"scenes": [
{
"motion": "number-counter",
"props": {
"keyframes": [
[
0,
0
],
[
14,
0
],
[
62,
760
],
[
96,
868
],
[
168,
10935
],
[
180,
10935
]
],
"label": "DEPTH",
"unit": "m",
"prefix": "",
"readoutLabels": [],
"kicker": "",
"labelColor": "#6c95ac",
"numberColor": "#a9d8ee",
"accent": "#ED3821",
"tileColor": "#2B3038",
"blockColor": "#111111",
"src": ""
}
}
]
}Number counter props
38 parameters — change any of them to make the motion yours.
| Prop | Default | What it does |
|---|---|---|
keyframes | [[0,0],[14,0],[62,760],[96,868],[168,10935],[180,10935]] | [[frame, value], …] monotone-cubic; put two close keys to dwell (slow down) near a landmark |
mode | "roll" | roll (odometer digit strips with motion blur) | tick (re-typeset each frame) | lock (digits spin, lock one by one) | scramble (glyph noise + trail + drop) | flap (split-flap tiles) | clock (time-lapse clock) |
label | "DEPTH" | small tracked label above the number |
unit | "m" | unit after the number ("" = none) |
prefix | "" | text before the number (e.g. "$", "×") |
decimals | 0 | decimal places (tick mode; roll mode uses integers) |
separator | " " | thousands separator (" " thin space, ",", "") |
readouts | ["pressure","light","temp"] | derived stats under the number: pressure | light | temp | percent | rate |
readoutLabels | [] | override the readout labels (same order) |
layout | "center" | center (big, standalone) | hud (top-left overlay block like video23) |
gauge | false | semicircle gauge above the number (video17 anticipation meter); centre layout only |
size | 300 | number size in px at 1080p (auto-shrinks to fit) |
labelSize | 28 | label size in px at 1080p (centre layout) |
labelColor | "#6c95ac" | |
numberColor | "#a9d8ee" | |
accent | "#ED3821" | |
backdrop | "ocean" | ocean | ink | dunes | … scene behind |
linkBackdrop | true | ocean backdrop darkens with the value (log scale) like a dive |
src | "" | optional public/ image behind |
lockStart | 14 | lock / scramble / flap modes: frame the first character locks (or flips) |
lockStep | 5 | lock mode: frames between one character locking and the next (a sixteenth note at your tempo) |
lockOrder | "ltr" | lock / scramble: ltr | rtl character lock order |
glyphs | "" | scramble: glyph set the unlocked digits flicker through (empty = digits) |
accentOnLock | false | locked characters flash in the accent colour for 6 frames |
flashFrame | false | one-frame brightness flash when a character locks |
progressBar | false | thin accent progress bar under the number while it locks |
flapFrom | null | flap mode: starting value (default = first keyframe value); ends on the max keyframe |
flapStagger | 3 | flap mode: frames between tiles starting to flip |
flipFrames | 8 | flap mode: frames one tile flip takes (0.26 s = 8) |
tileColor | "#2B3038" | flap mode: tile colour |
callout | "" | flap mode: text that pops under the number after the last flip (e.g. "×2") |
clockStart | 25200 | clock mode: start time in seconds since midnight (25200 = 07:00) |
clockRate | [[0,24],[90,24],[120,1]] | clock mode: [[frame, rate]] time-lapse speed; the clock integrates it |
speedTag | true | clock mode: show ×N TIME-LAPSE / ×1 REAL TIME tag |
block | "" | block background colour behind the number (hook look, e.g. #FFD60A); "" = none |
blockColor | "#111111" | number colour on the block |
kicker | "" | hook line slamming in above the number |
rollDuration | 0.45 | block hook: seconds of the scale slam |
Related motions

Confetti burst
Celebrations, completions, level-ups, "chaos" beats; small counts make an impact puff on a landing or tap.
confetti-burst
Flow lines (wind / heat / steam / waves)
Show air, heat, smell, sound or time: breeze over a landscape, a hot day, a hot meal, a ripple/time wipe.
flow-lines
Isometric bar-chart staircase
Metric stories (declines, rankings, progress through steps) as a friendly looping hero animation.
iso-bar-chart
Star glint flare
Specular highlight on a logo, product edge, blade, badge or coin; "shiny / new / premium" accents.
star-glint
Big stat slide
The "one number" beat of a pitch or keynote deck, KPI reveals, annual-report highlights, data-led social posts and explainer videos that…
big-stat-slide
Live chart / ECG traces
Growth / vital-sign / metric beats, "in sync" relationship moments, "it got worse" data moments.
live-chart
Notes & credits
Technique sources:
- video23 0:03-1:20
- video19 0:13.6-0:14.3
- video17 0:03.0-0:04.4