meta.json

meta.json é o arquivo de metadados que acompanha cada conjunto de quadros no modo quadro.

Sua função é informar ao sistema como reproduzir corretamente a sequência: FPS real, número de frames, duração e referência de áudio.

Estrutura de pastas

deathvideo/
  videos/   # fontes .mp4 / .webm
  frames/   # conjuntos gerados no modo frames
  cache/    # cache usado no modo vídeo direto

Dentro de cada conjunto em deathvideo/frames/ são gerados os seguintes:

-frame_%06d.png

Campo	Tipo	Descrição
`fps_real`	`number` (flutuante)	Real FPS detectado para reprodução.
`total_frames`	`integer`	Total de quadros exportados.
`duration_ms`	`integer`	Duração total em milissegundos.
`audio_path`	`string \| null`	Caminho de áudio no set; se não houver áudio, use `null`.
`created_at`	`string` (ISO-8601)	Carimbo de data e hora de criação.

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

As caixas usam frame_%06d.png, por exemplo: frame_000001.png.
Se houver áudio, audio_path aponta para o arquivo do mesmo conjunto (normalmente audio.wav).
Se não houver áudio, use audio_path: null para manter a convenção definida acima.