Data · timeline-ruler
Timeline ruler with event cards
A ruler of years glides under a fixed playhead dot; every event pins a card (date, image or gradient, title, one line) with a spring pop while the camera pans between events and the big odometer year counter rolls through the years in between. Horizontal on 16:9/1:1, vertical on 9:16.
A free, MIT-licensed animated chart from the Opus Motion Library — 616 motions for Remotion, React and plain HTML.

What Timeline ruler with event cards is for
Company history, product roadmaps, "history of X" videos and about-us sections: pass `events` (date, title, body, optional image).
Details
- Category
- Animated charts & data visualisation
- Length
- 17.5 s (524 frames at 30 fps)
- Formats
- 16:9, 1:1, 9:16
- Weight
- light
- Transparent overlay
- no
- Seamless loop
- no
- Text props
- —
- Colour props
backgroundinkaccent- Mood
- photo, hud, ui
- Roles
- subject
Use Timeline ruler with event cards in Remotion, React or HTML
Remotion project
# copy this motion into your Remotion project
node cli/mgl.mjs add timeline-ruler --to ../my-app/src
# render an mp4 (run in the library folder)
node cli/mgl.mjs render timeline-ruler --props '{"background":"#F1ECE2","ink":"#1A1A1F","accent":"#E4572E"}'
# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export timeline-ruler --as mp4 --props '{"background":"#F1ECE2","ink":"#1A1A1F","accent":"#E4572E"}'React / Next.js
import {MotionPlayer} from 'opus-motion-library/web';
<MotionPlayer
motion="timeline-ruler"
props={{background: '#F1ECE2', ink: '#1A1A1F', accent: '#E4572E'}}
playOnView
loop="auto"
/>Plain HTML / WordPress
<script src="opus-motion.element.js" defer></script>
<opus-motion motion="timeline-ruler"
props='{"background":"#F1ECE2","ink":"#1A1A1F","accent":"#E4572E"}'>
</opus-motion>Compose spec (multi-scene video)
{
"width": 1920,
"height": 1080,
"fps": 30,
"scenes": [
{
"motion": "timeline-ruler",
"props": {
"background": "#F1ECE2",
"ink": "#1A1A1F",
"accent": "#E4572E"
}
}
]
}Timeline ruler with event cards props
10 parameters — change any of them to make the motion yours.
| Prop | Default | What it does |
|---|---|---|
events | [{"date":"1998","title":"The first sketch","body":"Two people, one whiteboard, a very l… | [{date: "1998" (a 4-digit year is parsed), title, body?, image?: public path, icon?: name}] |
orientation | "auto" | 'auto' (vertical on portrait) | 'horizontal' | 'vertical' |
scale | "linear" | 'linear' = gaps proportional to years (clamped) · 'even' = equal gaps |
cardStyle | "light" | 'light' | 'dark' |
panFrames | 26 | camera pan between events (20-30) |
holdFrames | 58 | hold on each event (45-75) |
showCounter | true | show the odometer year counter |
background | "#F1ECE2" | background colour |
ink | "#1A1A1F" | ruler / counter colour |
accent | "#E4572E" | playhead, markers and dates |
Related motions

Ground-plane ruler
Distances, spans and heights on real photos — sports, architecture, travel, history ("the first flight covered 120 ft").
ground-plane-ruler
Gantt timeline
Schedules and roadmaps: project plans, launch timelines, sprint plans, production calendars, course or treatment plans. Pass tasks as…
gantt-timeline
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
Crowd tracks
Footfall / mobility / network-activity explainers, smart-city and retail-analytics films, "everyone is connected" beats; drop a crowd…
crowd-tracks
Node network
Network effects, communities, knowledge graphs, AI agents, social-proof and "everything connects" beats.
node-network
Orbit system
Astronomy teaching, "ecosystem" metaphors for products (a platform and its satellites), timelines of cycles, a hero background for space…
orbit-system
Notes & credits
Technique sources:
- prompt-corpus: timeline-ruler (44 cases)
- awesome-opus5-5-videos prompts (MIT) — technique only