HUD · numbered-step-badges
Numbered step badges
Tutorial overlay on a transparent background: numbered badges (1, 2, 3 ...) pop onto points of the footage one after another with a pulse ring and a caption chip, linked by a dotted path that draws on between them. Circle, map-pin or rounded-square badges.
A free, MIT-licensed HUD graphic from the Opus Motion Library — 616 motions for Remotion, React and plain HTML.

What Numbered step badges is for
Number the steps of a how-to on top of a screen recording or screenshot ("1 pick a file, 2 choose a format, 3 export"): pass `steps` with x/y points and your own captions.
Details
- Category
- HUD & sci-fi interface graphics
- 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
steps- Colour props
accentbadgeInklabelBglabelInk- Mood
- photo, editorial
- Roles
- frame, accent
- Pairs with
- Cursor driver (operated UI), Tooltip pointer, Spotlight dim focus
- Avoid
- Replace the sample captions (Search for a file / Pick a chart ...).
Use Numbered step badges in Remotion, React or HTML
Remotion project
# copy this motion into your Remotion project
node cli/mgl.mjs add numbered-step-badges --to ../my-app/src
# render an mp4 (run in the library folder)
node cli/mgl.mjs render numbered-step-badges --props '{"steps":[{"x":0.14,"y":0.044,"label":"Search for a file"},{"x":0.55,"y":0.3,"label":"Pick a chart","side":"left"},{"x":0.43,"y":0.64,"label":"Check the totals"},{"x":0.855,"y":0.904,"label":"Save it"}],"accent":"#2F6BFF","badgeInk":"#FFFFFF","labelBg":"#12151C","labelInk":"#FFFFFF"}'
# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export numbered-step-badges --as webm-alpha --props '{"steps":[{"x":0.14,"y":0.044,"label":"Search for a file"},{"x":0.55,"y":0.3,"label":"Pick a chart","side":"left"},{"x":0.43,"y":0.64,"label":"Check the totals"},{"x":0.855,"y":0.904,"label":"Save it"}],"accent":"#2F6BFF","badgeInk":"#FFFFFF","labelBg":"#12151C","labelInk":"#FFFFFF"}'React / Next.js
import {MotionPlayer} from 'opus-motion-library/web';
<MotionPlayer
motion="numbered-step-badges"
props={{
steps: [
{x: 0.14, y: 0.044, label: 'Search for a file'},
{x: 0.55, y: 0.3, label: 'Pick a chart', side: 'left'},
{x: 0.43, y: 0.64, label: 'Check the totals'},
{x: 0.855, y: 0.904, label: 'Save it'},
],
accent: '#2F6BFF',
badgeInk: '#FFFFFF',
labelBg: '#12151C',
labelInk: '#FFFFFF',
}}
playOnView
loop="auto"
/>Plain HTML / WordPress
<script src="opus-motion.element.js" defer></script>
<opus-motion motion="numbered-step-badges"
props='{"steps":[{"x":0.14,"y":0.044,"label":"Search for a file"},{"x":0.55,"y":0.3,"label":"Pick a chart","side":"left"},{"x":0.43,"y":0.64,"label":"Check the totals"},{"x":0.855,"y":0.904,"label":"Save it"}],"accent":"#2F6BFF","badgeInk":"#FFFFFF","labelBg":"#12151C","labelInk":"#FFFFFF"}'>
</opus-motion>Compose spec (multi-scene video)
{
"width": 1920,
"height": 1080,
"fps": 30,
"scenes": [
{
"motion": "numbered-step-badges",
"props": {
"steps": [
{
"x": 0.14,
"y": 0.044,
"label": "Search for a file"
},
{
"x": 0.55,
"y": 0.3,
"label": "Pick a chart",
"side": "left"
},
{
"x": 0.43,
"y": 0.64,
"label": "Check the totals"
},
{
"x": 0.855,
"y": 0.904,
"label": "Save it"
}
],
"accent": "#2F6BFF",
"badgeInk": "#FFFFFF",
"labelBg": "#12151C",
"labelInk": "#FFFFFF"
}
}
]
}Numbered step badges props
16 parameters — change any of them to make the motion yours.
| Prop | Default | What it does |
|---|---|---|
steps | [{"x":0.14,"y":0.044,"label":"Search for a file"},{"x":0.55,"y":0.3,"label":"Pick a cha… | array of {x, y (0-1 point), label?, n? (badge text), side?: auto|left|right|top|bottom, at?} |
badgeStyle | "circle" | circle | pin | square |
size | 64 | badge diameter in u |
connect | true | draw a dotted path between consecutive badges |
accent | "#2F6BFF" | badge fill and path colour |
badgeInk | "#FFFFFF" | number colour |
labelBg | "#12151C" | caption chip fill |
labelInk | "#FFFFFF" | caption chip text colour |
fontFamily | "stub" | CSS font-family for numbers and captions |
firstNumber | 1 | number of the first badge |
startAt | 8 | frame of the first badge |
stagger | 36 | frames between badges |
speed | 1 | animation speed multiplier |
exitAt | 0 | frame everything fades at (0 = just before the end) |
demoBackground | false | true paints a neutral mock screen behind (previews); false = transparent overlay |
demoTone | "light" | light | dark mock screen |
Related motions

Spotlight dim focus
Walk a viewer through parts of a screen recording one region at a time ("first the search bar, then the chart, then save"): pass `regions`…
spotlight-dim-focus
Tooltip pointer
Explain a control in a product tour, onboarding walkthrough or screen-recording tutorial: pass `tips` with the target x/y, a title and a…
tooltip-pointer
Cursor driver (operated UI)
Every UI demo, SaaS launch, tutorial and app preview: lay it over browser-mockup / device-mockup / ui-shape-morph with keys in % of the…
cursor-driver
Blur / pixelate redact region
Hide names, emails, keys or faces in a screen recording or screenshot walkthrough: pass `regions` (0-1 rects) with a `mode` and a label…
blur-redact-region
Scribble circle highlight
Circle the button, underline the setting, box the table or highlight the number in any screen recording: pass `marks` with the region (x,…
scribble-circle-highlight
Zoom inset box
Show tiny UI detail legibly in a screen recording (a menu item, a number, a toggle): set `zooms` with the source region, the inset…
zoom-inset-box
Notes & credits
Transparent overlay: steps are 0-1 points; badgeStyle circle|pin|square. pin badges sit above their point, so keep pin points below ~15% of the frame height.
Technique sources:
- screen-recording tutorial annotation