Skip to content

Production-ready animations, transitions, backgrounds, and scenes for Remotion

3.7 KB
Raw Blame
---
title: Beat Count
description: "A big thin numeral counts to 64 in steps locked to a BPM, with a small caption"
component: beat-count
vibe: premium
length: 144
useWhen:
  - "A beat-synced number reveal where the figure steps up in time with a track and squashes on every kick."
  - "A stat moment in a music-driven launch video that needs a thin, heavy-weight numeral and a small caption."
  - "A count from any start value to a target, such as 64 cuts, with a prefix, suffix or decimals."
avoidWhen:
  - "You want a smooth continuous count rather than discrete steps on a beat — use `live-ticker`."
  - "You want the number to build with visible carries between digits — use `carry-count`."
  - "The count should feel heavy and slam in from zero — use `smash-count`."
askedAs:
  - "number counting to the beat"
  - "bpm synced counter"
  - "I want a thin big numeral stepping up in time with the music"
  - "beat-synced number reveal that squashes on every kick"
  - "music video style stat counting"
  - "rhythmic counter"
---

<ComponentPreview name="beat-count" />

<InstallBlock name="beat-count" />

## Usage

```tsx
// src/Root.tsx
import { Composition } from "remotion";
import { BeatCount } from "@/components/remocn/beat-count";

const BeatCountScene = () => <BeatCount value={64} beats={8} bpm={120} label="cuts, each one landing on the kick" />;

export const RemotionRoot = () => (
  <Composition
    id="BeatCount"
    component={BeatCountScene}
    durationInFrames={160}
    fps={30}
    width={1280}
    height={720}
  />
);
```

A big numeral steps from `from` to `value` in `beats` equal jumps, one per beat at the given `bpm`. On each beat it squashes down and thins its weight before releasing, and the last beat rebounds with a spring. A small caption fades in at the top left after the first beat. Pass `value`, `beats`, `bpm`, `label`, and optionally `prefix`, `suffix` and `decimals`. It ships light and dark through the `theme` prop.

<PropsTable title="Props"
  rows={[
    {
      name: "value",
      type: "number",
      default: "64",
      description: "The final number the count lands on.",
    },
    {
      name: "from",
      type: "number",
      default: "0",
      description: "The number shown before the first beat.",
    },
    {
      name: "beats",
      type: "number",
      default: "8",
      description: "How many steps the count takes, one per beat.",
    },
    {
      name: "bpm",
      type: "number",
      default: "120",
      description: "Tempo in beats per minute; 30 at minimum. Sets the frames per step.",
    },
    {
      name: "decimals",
      type: "number",
      default: "0",
      description: "Decimal places shown on the number.",
    },
    {
      name: "prefix",
      type: "string",
      default: "\"\"",
      description: "Text placed before the number, such as a currency sign.",
    },
    {
      name: "suffix",
      type: "string",
      default: "\"\"",
      description: "Text placed after the number, such as a unit.",
    },
    {
      name: "label",
      type: "string",
      default: "\"cuts, each one landing on the kick\"",
      description: "Caption at the top left.",
    },
    {
      name: "accent",
      type: "string",
      description: "Colour of the caption text.",
    },
    {
      name: "background",
      type: "string",
      description: "Stage colour; pass 'transparent' to layer over other footage.",
    },
    {
      name: "speed",
      type: "number",
      default: "1",
      description: "Playback speed multiplier; 1 is the designed pace.",
    },
    {
      name: "theme",
      type: "\"dark\" | \"light\"",
      default: "\"dark\"",
      description: "Ships light and dark.",
    },
  ]}
/>