From d76f0906cb44986d8faf0adb7ced99a713b462da Mon Sep 17 00:00:00 2001
From: Gramps <llamachileshop@gmail.com>
Date: Tue, 5 Aug 2025 10:14:29 -0700
Subject: [PATCH] Updated Clip Handling Logic (markdown)

---
 Clip Handling Logic.md |  0
 Clip-Handling-Logic.md | 64 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 64 insertions(+)
 delete mode 100644 Clip Handling Logic.md
 create mode 100644 Clip-Handling-Logic.md

diff --git a/Clip Handling Logic.md b/Clip Handling Logic.md
deleted file mode 100644
index e69de29..0000000
diff --git a/Clip-Handling-Logic.md b/Clip-Handling-Logic.md
new file mode 100644
index 0000000..952d87f
--- /dev/null
+++ b/Clip-Handling-Logic.md
@@ -0,0 +1,64 @@
+# Clip Handling Logic
+
+This page explains how the LCS Pipeline processes clips — from raw input files to final uploads.
+
+## Overview
+
+Each clip goes through a multi-stage process:
+
+1. **Discovery**: Files are found in `hits/`, `misses/`, `montages/`, or `outtakes/` folders.
+2. **Metadata Extraction**: Reads `notes.json` if available.
+3. **Title Generation**: Auto or manual titles are generated.
+4. **Rendering**: Intro + title + clip + outro stitched together.
+5. **Upload**: Posted to YouTube (and PeerTube if wide format).
+6. **Archival**: Final metadata and URLs are saved.
+
+## Clip Categories
+
+* `hits/`: Notable eliminations.
+* `misses/`: Funny or fail moments.
+* `montages/`: Pre-trimmed highlight reels.
+* `outtakes/`: Manually marked moments.
+
+## Notes File
+
+Each clip folder may include a `notes.json` with optional metadata:
+
+```json
+{
+  "highlight": "Gramps nails a double headshot!",
+  "tags": ["Fortnite", "Double Kill", "Highlights"],
+  "gag_name": "Senior Sniper Supreme"
+}
+```
+
+## Format Rules
+
+* Vertical clips: Filename ends with `-vert` or `-vertical`.
+* Each clip → one output video.
+* Output stored in `rendered/` subfolder of the session.
+
+## Rendering Pipeline
+
+```text
+[ intro ] + [ dynamic title card ] + [ content ] + [ outro ]
+```
+
+## Publishing Rules
+
+* Vertical: Upload to YouTube Shorts playlist.
+* Wide: Upload to both YouTube Clips and PeerTube.
+
+## Automation Notes
+
+* Title overlays use Fortnite fonts/colors.
+* If `notes.json` is missing, OpenAI fallback generates description.
+* Upload returns YouTube URL for archive.
+
+## Dev Tip
+
+Set debug flag in `config.py` to avoid destructive actions during tests.
+
+---
+
+🧠 Managed and documented by ChatGPT, the official LCS Pipeline wiki boss. 😎