From 8503d5b4ed4125b0d8aee5f44b4638b210b338f9 Mon Sep 17 00:00:00 2001
From: Gramps <llamachileshop@gmail.com>
Date: Fri, 25 Jul 2025 19:41:59 -0700
Subject: [PATCH] Created Thumbnail Generation (markdown)

---
 Thumbnail-Generation.md | 57 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 Thumbnail-Generation.md

diff --git a/Thumbnail-Generation.md b/Thumbnail-Generation.md
new file mode 100644
index 0000000..3b61595
--- /dev/null
+++ b/Thumbnail-Generation.md
@@ -0,0 +1,57 @@
+# Thumbnail Generation
+
+This page documents how thumbnail images are generated for the Llama Chile Shop automated video pipeline.
+
+---
+
+## ✅ Logic Overview
+
+* Thumbnails are only generated for **widescreen** videos.
+* Vertical (Shorts) videos are **skipped** due to YouTube limitations.
+* Thumbnail is generated **after upload** (to ensure `video_id` exists).
+* Image is created using **FFmpeg** and saved locally.
+
+---
+
+## 🎯 Thumbnail Extraction
+
+**Function:** `generate_thumbnail(video_path: str, output_path: str) -> str`
+
+* Extracts a representative frame using FFmpeg's `thumbnail` filter.
+* Scales the image to 1280x720.
+* Saves the file as `<stem>_thumb.jpg`.
+
+---
+
+## 🎨 Branding Rules
+
+* All thumbnails should follow the Llama Chile Shop palette:
+
+  * Font color: `#f7338f`
+  * Shading color: `#10abba`
+  * Shadowing color: `#1c0c38`
+* Style: Bold, comic-influenced, Fortnite-inspired.
+
+---
+
+## 🧩 Output Path
+
+* Thumbnail saved alongside the video using the pattern:
+
+  ```
+  <filename_stem>_thumb.jpg
+  ```
+
+---
+
+## 🔄 Limitations
+
+* No thumbnails for vertical videos.
+* Currently generates from video content; future versions will allow full AI-based image generation.
+
+---
+
+## 📌 Dependencies
+
+* `ffmpeg` must be installed and available in system PATH.
+* Part of `thumbnail_utils.py`.