hyperframes inspect
Dump composition metadata — duration, fps, tracks, and asset dependencies — for tooling, CI, and pre-render sanity checks.
hyperframes inspect reads a composition and prints its metadata without rendering a single frame. It is the introspection endpoint for editors, CI gates, and any tool that needs to know the shape of a comp.
Synopsis
bash
hyperframes inspect <file> [flags]Default output is a human-readable summary. Pair with --json for tooling.
Flags
| Flag | Default | Meaning |
|---|---|---|
--frames | off | Include per-frame timing for every track. |
--tracks | on | Include the track list. Turn off for a minimal summary. |
--deps | on | Include the asset dependency list with shas. |
--vars | off | List declared variables and defaults. |
Common invocations
$ hyperframes inspect comp.html
comp.html
duration 5s
fps 60
size 1920x1080
tracks 3
deps 2JSON output
json
{
"command": "inspect",
"status": "ok",
"exit_code": 0,
"duration": 5,
"fps": 60,
"width": 1920,
"height": 1080,
"tracks": [
{ "name": "h1", "start": 1.0, "duration": 4.0, "fade": "both" },
{ "name": "img.logo", "start": 0.0, "duration": 5.0 },
{ "name": "video.b", "start": 1.5, "duration": 3.0, "src": "b-roll.mp4" }
],
"deps": [
{ "path": "music.mp3", "sha": "a1b23c4d5e6f7890abcdef1234567890" },
{ "path": "logo.svg", "sha": "f8e4d2c1b0a9876543210fedcba98765" }
],
"vars": []
}With --frames, each track gains a frames array of { frame, opacity, transform } records.
Exit codes
0— inspection complete.1— file missing, unreadable, or schema invalid.
Tips
- Cache
inspect --jsonin CI to detect unintended duration drift across PRs. - The
depsarray is the contract for asset caching layers. Two runs with matchingdepsand matching flags will render identical bytes. - For very large compositions, skip
--frames— it can be megabytes of JSON. inspectnever launches a browser. It is safe to run in minimal CI images that have no chromium.
Next
- HyperFrames CLI — full command index.
- HTML schema — what the inspector is reading.