Opus Motion ★ Star on GitHub

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.

Timeline ruler with event cards: three frames of the animated chart, start, middle and end
Timeline ruler with event cards — start, middle and end of the 17.5-second motion.

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

  • timeline
  • history
  • roadmap
  • ruler
  • years
  • milestones
  • events
  • cards
  • odometer
  • counter
  • company
  • about
  • data
  • chronology

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
background ink accent
Mood
photo, hud, ui
Roles
subject

Use Timeline ruler with event cards in Remotion, React or HTML

Remotion project

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

tsx
import {MotionPlayer} from 'opus-motion-library/web';

<MotionPlayer
  motion="timeline-ruler"
  props={{background: '#F1ECE2', ink: '#1A1A1F', accent: '#E4572E'}}
  playOnView
  loop="auto"
/>

Plain HTML / WordPress

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

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

PropDefaultWhat 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'
panFrames26camera pan between events (20-30)
holdFrames58hold on each event (45-75)
showCountertrueshow the odometer year counter
background"#F1ECE2"background colour
ink"#1A1A1F"ruler / counter colour
accent"#E4572E"playhead, markers and dates

Notes & credits

Technique sources:

  • prompt-corpus: timeline-ruler (44 cases)
  • awesome-opus5-5-videos prompts (MIT) — technique only