meta.json

meta.json is the metadata file that accompanies each set of frames in frame mode.

Its function is to tell the system how to correctly play the sequence: actual FPS, number of frames, duration and audio reference.

Folder structure

deathvideo/
  videos/   # source .mp4 / .webm
  frames/   # sets generated in frames mode
  cache/    # cache used by direct video mode

Files generated when exporting frames

Within each set in deathvideo/frames/ the following are generated:

• frame_%06d.png
• audio.wav (optional)
• meta.json

Final outline

Field	Type	Description
fps_real	number (float)	Real FPS detected for playback.
total_frames	integer	Total exported frames.
duration_ms	integer	Total duration in milliseconds.
audio_path	string | null	Audio path on set; if there is no audio, use null.
created_at	string (ISO-8601)	Creation timestamp.

Complete example

{
  "fps_real": 29.97,
  "total_frames": 892,
  "duration_ms": 29763,
  "audio_path": "audio.wav",
  "created_at": "2026-03-02T18:35:11Z"
}

Naming convention

• The boxes use frame_%06d.png, for example: frame_000001.png.
• If there is audio, audio_path points to the file of the same set (normally audio.wav).
• If there is no audio, use audio_path: null to maintain the convention defined above.