Updated Thumbnail Prompting (markdown)

Thumbnail-Prompting.md

@@ -1,53 +1,49 @@
-# Thumbnail Prompting
+## 🖼️ Thumbnail Prompting
 
-This page documents how thumbnail generation prompts are derived using `notes.txt` as input.
+This page documents how thumbnail prompts are constructed, formatted, and passed to the generation engine to produce YouTube-ready thumbnails.
 
 ---
 
-## 📂 File Requirements
+### 🧠 Prompt Rules
 
-Each clip folder may include an optional file:
+Thumbnail prompts are built from:
 
-```bash
+- The **clip category** (`montage`, `hit`, `miss`, etc.)
-notes.txt  # One or more sentences describing the clip
+- The **tone** and **style keywords** derived from tags or folder context
+- The **clip date**, rendered in `Mon DD YYYY` format
+- A visual signature (always includes the “brand llama”)
+
+---
+
+### 🖼️ Default Prompt Composition
+
+For standard highlight thumbnails:
+
+```
+1280×720 canvas, Fortnite branding, vibrant color
+
+- Top left: YouTube logo
+- Center left (stacked): “FORTNITE” / “LIVE STREAM!” / “with Gramps!”
+- Bottom right: Date (“Aug 03 2025”)
+- Right side: Stylized purple llama (brand mascot)
+
+Use Fortnite-style font and colors: #f7338f (main), #10abba (shadow), #1c0c38 (stroke)
 ```
 
 ---
 
-## 🧠 Prompt Generation
+### 📁 Output Rules
 
-**Function:** `generate_thumbnail_prompt(notes: str) -> str`
+- File size must be < 2MB
-
+- Vertical and horizontal thumbnails may vary in layout
-* Reads content from `notes.txt`
+- If output fails validation (e.g. wrong size or file type), regenerate silently
-* Produces a rich description for thumbnail generation (via OpenAI or DALL·E)
-* Style reflects Llama Chile Shop branding:
-
-  * Whimsical, bold, Fortnite-inspired
-  * Often humorous or chaotic
-  * Includes a stylized llama or parody war/game aesthetic
 
 ---
 
-## 📘 Example
+### 🧪 Prompt Generator Source
 
-**notes.txt:**
+See: `modules/thumbnail_utils.py → generate_thumbnail_prompt()`
-
-```
-Gramps scores Victory Royale with 12 Eliminations
-```
-
-**Generated Prompt:**
-
-```
-Create a Fortnite-style gaming thumbnail based on the moment: "Gramps scores Victory Royale with 12 Eliminations."
-Featuring a stylized llama character with bold comic-style colors. Include dramatic or humorous elements
-(e.g., explosions, dance emotes, intense lighting), and text like 'HIGHLIGHT' or 'VICTORY ROYALE'.
-Use the Llama Chile Shop color palette (f7338f, 10abba, 1c0c38). The vibe should be fun, exaggerated, and chill — inviting viewers to laugh and enjoy the moment.
-```
 
 ---
 
-## 🔮 Future Integration
+Next page: [`YouTube Upload Logic`](./YouTube-Upload-Logic)
-
-* Thumbnail prompts will drive OpenAI image generation (once supported)
-* May also be reused for auto-captioning, social posts, or overlays