mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-03 20:37:30 +00:00
Miguel Ángel
5a92fe7e5e
* fix(cli): beats given a media file points to hyperframes audio instead of a folder error * fix(cli): beats names the folder for a composition file and syncs the skills manifest
18 lines
955 B
Markdown
18 lines
955 B
Markdown
# Generate a project beat grid
|
|
|
|
Use `hyperframes beats` when an existing HyperFrames project needs the Studio-compatible beat file for its music track. This is a CLI utility, not a complete video workflow.
|
|
|
|
```bash
|
|
npx hyperframes beats
|
|
npx hyperframes beats ./my-video
|
|
npx hyperframes beats ./my-video --json
|
|
```
|
|
|
|
`beats` takes the project folder, never a media file. For the beats of one audio or video file, run `npx hyperframes audio <file> --only beats --json`.
|
|
|
|
The project must contain a local music `<audio>` source. Mark it with `data-timeline-role="music"`; an id containing `music`, `bgm`, or `soundtrack` is also recognized. The command decodes that file with ffmpeg, tracks its beats, and writes `beats/<audio-relative-path>.json`.
|
|
|
|
If the track has no steady beat, the command fails and writes nothing. If ffmpeg is missing, run `npx hyperframes doctor`.
|
|
|
|
For a whole video cut to a music track, see `/hyperframes` → `references/film.md`.
|