video-pipeline

Table of Contents

🔍 Metadata Extraction

📂 Location
📄 File Format
🔄 Fallback Behavior
🧪 Example

🔍 Metadata Extraction

This page describes how the LCS Pipeline reads and interprets per-clip metadata, especially from notes.json files used to guide title generation, overlays, and social copy.

📂 Location

For each clip file, the system expects a corresponding file named:

<clipname>.notes.json

This file should reside in the same directory as the clip (hits/, misses/, outtakes/, or montages/).

📄 File Format

Each notes.json file contains:

Field	Required?	Description
`highlight`	✅ Yes	Short, vivid sentence summarizing the moment
`tags`	Optional	List of keywords (used in social media metadata)
`gag_name`	Optional	Alternative title, meme reference, or inside joke

🔄 Fallback Behavior

If no notes.json is found:
- For hits/, misses/, or outtakes/: the user is prompted to enter one interactively.
- For montages/: the system attempts to auto-title from the filename.

🧪 Example

{
  "highlight": "Gramps sticks a 3-elim clutch with only 2 HP left!",
  "tags": ["Fortnite", "Clutch", "ZeroBuild"],
  "gag_name": "The Wrinkle Reaper"
}

Next page: Metadata Format