1
Metadata Format
Gramps edited this page 2025-08-05 22:03:29 -07:00

📄 Metadata Format

This page documents the schema and structural expectations of notes.json files used by the LCS Pipeline.


📁 File Name Convention

Each notes.json file must be:

  • Named: <clipname>.notes.json
  • Stored in the same folder as its clip

🧱 Field Definitions

Field Type Required Description
highlight string Yes A short, engaging summary of the moment
tags array No List of hashtags/keywords
gag_name string No Optional meme-style or alt title

🧠 Notes

  • highlight must be under ~100 characters (for overlays + social)
  • tags will be used to generate hashtags and platform metadata
  • gag_name is used for meme variants, overlays, or alt titling

🔄 Evolution

This format is designed to evolve. Fields like tone, voice_note, and priority were considered and deliberately excluded for simplicity.


🧪 Example

{
  "highlight": "Double knock with a single pump shot 😱",
  "tags": ["Pump", "Knockout", "Fortnite"],
  "gag_name": "Old Man Boomstick"
}

Next page: Metadata History