Opus Motion ★ Star on GitHub

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.

Number counter: three frames of the text animation, start, middle and end
Number counter — start, middle and end of the 6.0-second motion.

What Number counter is for

Depth/altitude/speed meters, growing stats, countdowns, progress percentages and scoreboards.

  • counter
  • number
  • hud
  • odometer
  • stats
  • scramble
  • lock
  • digit lock
  • split flap
  • departure board
  • clock
  • time-lapse
  • hook
  • kpi
  • glyph

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
keyframes label unit prefix readoutLabels kicker
Colour props
labelColor numberColor accent tileColor blockColor
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

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

tsx
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

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

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

PropDefaultWhat 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. "$", "×")
decimals0decimal 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)
gaugefalsesemicircle gauge above the number (video17 anticipation meter); centre layout only
size300number size in px at 1080p (auto-shrinks to fit)
labelSize28label size in px at 1080p (centre layout)
labelColor"#6c95ac"
numberColor"#a9d8ee"
accent"#ED3821"
backdrop"ocean"ocean | ink | dunes | … scene behind
linkBackdroptrueocean backdrop darkens with the value (log scale) like a dive
src""optional public/ image behind
lockStart14lock / scramble / flap modes: frame the first character locks (or flips)
lockStep5lock 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)
accentOnLockfalselocked characters flash in the accent colour for 6 frames
flashFramefalseone-frame brightness flash when a character locks
progressBarfalsethin accent progress bar under the number while it locks
flapFromnullflap mode: starting value (default = first keyframe value); ends on the max keyframe
flapStagger3flap mode: frames between tiles starting to flip
flipFrames8flap 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")
clockStart25200clock 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
speedTagtrueclock 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
rollDuration0.45block hook: seconds of the scale slam

Notes & credits

Technique sources:

  • video23 0:03-1:20
  • video19 0:13.6-0:14.3
  • video17 0:03.0-0:04.4