Update all .md files with Hugging Face Spaces configuration

800x1080_PRINT_EXAMPLE.md

@@ -1,66 +1,12 @@
-# 📐 800x1080 Print on Pages
-
-## What You Get
-
-Each comic page now displays "800x1080" in the bottom-right corner:
-
-```
-┌─────────────────────────────────┐
-│         Page 1                  │
-│  ┌─────────┬─────────┐         │
-│  │         │         │         │
-│  │ Panel 1 │ Panel 2 │         │
-│  │         │         │         │
-│  ├─────────┼─────────┤         │
-│  │         │         │         │
-│  │ Panel 3 │ Panel 4 │         │
-│  │         │         │         │
-│  └─────────┴─────────┘         │
-│                                 │
-│                      [800x1080] │
-└─────────────────────────────────┘
-```
-
-## Features
-
-### Display
-- **Text**: "800x1080" 
-- **Position**: Bottom-right corner
-- **Style**: Monospace font, gray color
-- **Background**: Semi-transparent white
-- **Border**: Light gray border
-
-### Visibility
-- ✅ Shows in browser view
-- ✅ Shows when printing
-- ✅ Shows in PDF export
-- ✅ Shows in saved HTML
-
-## Customization Options
-
-The "800x1080" text appears with:
-- **Font**: Monospace (technical look)
-- **Size**: 14px
-- **Color**: #666 (medium gray)
-- **Padding**: 5px 10px
-- **Border**: 1px solid #ddd
-
-## When You Print
-
-The "800x1080" text will:
-1. Appear on every page
-2. Print in the bottom-right corner
-3. Be clearly visible but not intrusive
-4. Help identify the page resolution
-
-## Alternative Positions
-
-You can move it by adding CSS classes:
-- `top-left`: Top-left corner
-- `top-right`: Top-right corner  
-- `bottom-left`: Bottom-left corner
-- `bottom-right`: Default position
-
-## Result
-
-Now every comic page clearly shows it's rendered at 800x1080 resolution, both on screen and when printed!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

CLEAN_SOLUTION.md

@@ -1,109 +1,12 @@
-# 🎯 Clean Comic Solution
-
-## What This Fixes
-
-### ✅ Problem 1: Color Loss
-- **Issue**: Comic styling was destroying colors
-- **Solution**: REMOVED all comic styling
-- **Result**: Original colors preserved 100%
-
-### ✅ Problem 2: Too Many Panels
-- **Issue**: Generated all frames instead of meaningful ones
-- **Solution**: Smart selection of ONLY 12 key moments
-- **Result**: Concise story with important scenes only
-
-### ✅ Problem 3: Wrong Layout
-- **Issue**: Fixed 2x2 grid (4 panels)
-- **Solution**: Adaptive grid (3x4 for 12 panels)
-- **Result**: Proper comic layout
-
-## 🚀 How to Use
-
-### Option 1: Simple App (Recommended)
-```bash
-python app_simple.py
-```
-- Upload video at http://localhost:5000
-- Automatically generates 12-panel comic
-- Preserves all colors
-- Clean 3x4 grid layout
-
-### Option 2: Direct Test
-```bash
-python test_clean_comic.py
-```
-- Tests with existing video/subtitles
-- Shows frame extraction process
-
-## 📊 What It Does
-
-1. **Analyzes Story**:
-   - Scores each subtitle by importance
-   - Looks for: intro, conflict, emotion, action, conclusion
-   - Selects exactly 12 most meaningful moments
-
-2. **Extracts Frames**:
-   - ONLY extracts frames for selected moments
-   - No wasted processing
-   - Preserves original quality
-
-3. **Creates Layout**:
-   - 3x4 grid for 12 panels
-   - Clean HTML viewer
-   - No styling or effects
-
-## 🎨 Example Selection
-
-From 100+ subtitles → 12 key moments:
-1. "Hello, my name is..." (Introduction)
-2. "But there's a problem!" (Conflict)
-3. "We must find a way..." (Challenge)
-4. "I have an idea!" (Solution)
-5. "Let's do this together" (Teamwork)
-6. "Watch out!" (Action)
-7. "That was close..." (Tension)
-8. "We're almost there!" (Progress)
-9. "This is it!" (Climax)
-10. "We did it!" (Victory)
-11. "Thank you so much" (Resolution)
-12. "Until next time..." (Conclusion)
-
-## 📁 Output
-
-```
-output/
-├── comic_simple.html    # Clean viewer
-└── comic_data.json      # Panel information
-
-frames/final/
-├── frame000.png         # Original colors
-├── frame001.png         # No styling
-├── ...
-└── frame011.png         # 12 total
-```
-
-## 🔧 Key Differences
-
-### Old System:
-- Complex, conflicting code
-- Comic styling ruins colors
-- Generates too many panels
-- Fixed 4-panel layout
-
-### Clean System:
-- Simple, focused code
-- No styling (preserves colors)
-- Exactly 12 meaningful panels
-- Proper grid layout
-
-## ✨ Benefits
-
-1. **Quality**: Original image colors preserved
-2. **Story**: Only important moments selected
-3. **Layout**: Clean 3x4 grid
-4. **Speed**: Faster (less processing)
-5. **Simplicity**: Easy to understand and modify
-
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
 ---
 
-**Just run `python app_simple.py` for perfect results!**
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

CONFLICT_ANALYSIS.md

@@ -1,92 +1,12 @@
-# 🔍 Conflict Analysis: Frame Generation Pipeline
-
-## Executive Summary
-
-After analyzing the entire codebase, I've identified **3 major conflicts** that prevent proper 48-frame generation:
-
-## 1. **Frame Extraction Failure** ❌
-
-**Location**: `backend/keyframes/keyframes_story.py`
-
-**Problem**: 
-- Extracts frames to subdirectories (`frames/sub1/`, `frames/sub2/`, etc.)
-- Tries to copy to `frames/final/` but the copy operation was failing
-- Even after fixing the copy operation, frames might not be extracted properly
-
-**Solution Applied**:
-- Created `backend/keyframes/keyframes_fixed.py` with direct extraction to `frames/final/`
-- No intermediate subdirectories
-- Better error handling and fallback
-
-## 2. **Multiple Filtering Points** ⚠️
-
-**Locations**: Multiple places in `app_enhanced.py`
-
-**Problem**:
-- Step 2: Extracts 48 moments ✅
-- Bubble generation: Was re-filtering to 12 → **FIXED**
-- Page generation: Expects frames but finds 0
-
-**Solution Applied**:
-- Disabled re-filtering in bubble generation (line 421-439)
-- Ensured `_filtered_count = 48` is stored and used consistently
-- Modified bubble generation to use all 48 selected moments
-
-## 3. **Inconsistent Frame Count Tracking** 🔄
-
-**Location**: Throughout `app_enhanced.py`
-
-**Problem**:
-- `_filtered_count` not consistently set
-- Some methods use local frame count, others use filtered count
-- Page generation expects frames that don't exist
-
-**Solution Applied**:
-- Set `self._filtered_count = len(filtered_subs)` after story extraction
-- Ensure this count is used in bubble generation and page layout
-
-## The Complete Flow (After Fixes)
-
-```
-1. Extract Frames (simple method) → All frames
-2. Extract Story → 48 key moments from subtitles
-3. Generate Keyframes → Extract 48 specific frames
-4. Enhance Frames → Apply to all 48 frames
-5. Generate Bubbles → Create bubbles for 48 frames
-6. Generate Pages → 12 pages × 4 panels = 48 total
-```
-
-## Key Integration Point
-
-The main issue was in Step 3 - the `generate_keyframes_story` was:
-1. Not properly extracting frames from video
-2. Failing to copy them to the final directory
-3. Not providing feedback about failures
-
-## What Should Happen Now
-
-With the fixes applied:
-
-1. **Story Extraction**: 89 subtitles → 48 moments ✅
-2. **Frame Extraction**: 48 frames saved directly to `frames/final/` ✅
-3. **Enhancement**: All 48 frames enhanced ✅
-4. **Page Generation**: 12 pages with 2x2 grid ✅
-5. **Total Output**: 48 panels telling complete story ✅
-
-## Verification
-
-Check for these log messages:
-- "📚 Full story: 48 key moments from 89 total"
-- "✅ Total frames in frames/final: 48"
-- "📖 Generating 12-page comic summary (2x2 grid per page)"
-- "✅ Generated 12 pages with 48 total panels"
-
-## If Still Failing
-
-The issue might be:
-1. Video file not accessible
-2. OpenCV not installed properly
-3. Permissions issue with frame directories
-4. The simple frame extraction at the beginning interfering
-
-Run the app again and look for the new logging messages!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

CORRECT_FIX_2x2_GRID.md

@@ -1,83 +1,12 @@
-# ✅ CORRECT FIX: 12 Meaningful Panels in 2x2 Grid Format
-
-## What You Actually Wanted
-
-- **Grid Size**: 2x2 (4 panels per page)
-- **Total Panels**: 12 meaningful story moments
-- **Total Pages**: 3 pages (12 ÷ 4 = 3)
-- **Colors**: Original preserved (no green tint)
-
-## What's Fixed Now
-
-### 1. **2x2 Grid Layout Maintained** ✅
-- Each page has 2x2 grid (4 panels)
-- Each panel takes 1/4 of the page
-- Clean, organized layout
-
-### 2. **12 Meaningful Panels Total** ✅
-- Story extractor selects 12 key moments
-- Filters out unimportant frames
-- Covers intro, conflict, climax, resolution
-
-### 3. **3 Pages Generated** ✅
-- Page 1: Panels 1-4 (Introduction)
-- Page 2: Panels 5-8 (Development/Conflict)
-- Page 3: Panels 9-12 (Climax/Resolution)
-
-### 4. **Colors Preserved** ✅
-- Comic styling disabled
-- No processing that changes colors
-- Original image quality
-
-## 📊 Layout Structure
-
-```
-Page 1:          Page 2:          Page 3:
-┌───┬───┐       ┌───┬───┐       ┌───┬───┐
-│ 1 │ 2 │       │ 5 │ 6 │       │ 9 │ 10│
-├───┼───┤       ├───┼───┤       ├───┼───┤
-│ 3 │ 4 │       │ 7 │ 8 │       │ 11│ 12│
-└───┴───┘       └───┴───┘       └───┴───┘
-  2x2 grid        2x2 grid        2x2 grid
-```
-
-## 🔧 Implementation
-
-### Created: `backend/fixed_2x2_pages.py`
-- `generate_12_panels_2x2_grid()`: Creates 3 pages with 2x2 grid
-- `extract_12_meaningful_frames()`: Selects 12 key moments
-- Proper panel dimensions (row_span=6, col_span=6)
-
-### Modified: `app_enhanced.py`
-- Uses new 2x2 grid generator
-- Extracts exactly 12 meaningful frames
-- Preserves original colors
-
-## 🎯 How It Works
-
-1. **Video Upload** → Extract all subtitles
-2. **Story Analysis** → Score each moment by importance
-3. **Frame Selection** → Pick exactly 12 key moments
-4. **Frame Extraction** → Get frames for those 12 moments only
-5. **Page Generation** → Create 3 pages, 4 panels each (2x2 grid)
-6. **No Styling** → Keep original colors
-
-## ✅ Result
-
-When you run the app now:
-- **12 meaningful story panels** (not all frames)
-- **3 pages with 2x2 grid** (4 panels per page)
-- **Original colors preserved** (no green tint)
-- **Smart story selection** (intro → conflict → resolution)
-
-## 📄 Output
-
-```
-output/
-├── page.html     # Page 1 (panels 1-4)
-├── page2.html    # Page 2 (panels 5-8)
-├── page3.html    # Page 3 (panels 9-12)
-└── panels/       # Individual 640x800 images
-```
-
-The comic generator now creates exactly what you requested: 12 meaningful panels in 2x2 grid format across 3 pages!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

EDITABLE_FORMATS_EXPLAINED.md

@@ -1,92 +1,12 @@
-# 📝 Understanding Editable Formats
-
-## The Reality About PDFs
-
-**PDFs are NOT meant to be edited** like HTML. They're designed to be:
-- Final, static documents
-- Consistent across all devices
-- Print-ready
-- Read-only by nature
-
-## Your Options for Editable Comics
-
-### 1. **HTML = Your Editable Master File** 🌐
-
-Think of it like:
-- **HTML** = Photoshop .PSD file (editable)
-- **PDF** = JPEG export (final output)
-
-**How to use:**
-1. Generate comic → Creates `page.html`
-2. Open in browser → Edit freely
-3. **Save the HTML file** to your computer
-4. Open it anytime to continue editing
-5. Export to PDF when you need to share
-
-### 2. **Self-Contained HTML Package** 📦
-
-I've created a special packager that creates a single HTML file with:
-- All images embedded
-- All editing features
-- No external dependencies
-- Can be shared and edited
-
-```python
-# Run this to create portable HTML
-from backend.html_packager import create_portable_comic
-create_portable_comic()
-# Creates: output/comic_portable.html
-```
-
-### 3. **Online Comic Editor** 🔗
-
-Keep your comic online:
-- Access from anywhere
-- Share editable link
-- Always have latest version
-- No files to manage
-
-## Comparison
-
-| Feature | PDF | HTML | Portable HTML |
-|---------|-----|------|---------------|
-| Editable text | ❌ | ✅ | ✅ |
-| Draggable bubbles | ❌ | ✅ | ✅ |
-| Shareable | ✅ | ⚠️ | ✅ |
-| Self-contained | ✅ | ❌ | ✅ |
-| Works offline | ✅ | ⚠️ | ✅ |
-| Professional output | ✅ | ✅ | ✅ |
-
-## Recommended Workflow
-
-### For Personal Use:
-1. Generate comic
-2. Edit in browser
-3. Bookmark the page
-4. Export PDF when needed
-
-### For Sharing Editable Version:
-1. Generate comic
-2. Create portable HTML
-3. Share the HTML file
-4. Recipients can edit in their browser
-
-### For Final Distribution:
-1. Complete all edits
-2. Export to PDF
-3. Share the PDF (not editable)
-
-## Why This Approach?
-
-1. **Best of both worlds**: Keep editability, export when needed
-2. **No special software**: Just a web browser
-3. **Version control**: Save multiple HTML versions
-4. **Professional output**: PDF for final sharing
-
-## The Bottom Line
-
-- **PDF** = Final, non-editable output
-- **HTML** = Your working, editable file
-- **Portable HTML** = Shareable, editable file
-
-Save your HTML files like you would save any document - they ARE your editable comics!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

EMOTION_BASED_SELECTION.md

@@ -1,78 +1,12 @@
-# 🎭 Emotion-Based Frame Selection
-
-## How It Works (The RIGHT Way)
-
-### Previous Approach (Wrong):
-1. Extract random frames from video
-2. Generate comic
-3. THEN analyze emotions (too late!)
-4. Just show emotion labels
-
-### New Approach (Correct):
-1. **Analyze dialogue emotions FIRST** 📝
-2. **Search video for matching facial expressions** 🔍
-3. **Select frames where face matches dialogue** ✅
-4. **Create comic with perfect emotion matching** 🎭
-
-## The Process
-
-### Step 1: Emotion Analysis of Dialogue
-```
-Dialogue: "I'm so happy to see you!"
-→ Detected emotion: HAPPY (85% confidence)
-```
-
-### Step 2: Video Scanning
-For each dialogue, the system:
-- Scans 2 seconds of video around that dialogue
-- Analyzes facial expressions in multiple frames
-- Checks eye state (avoiding closed eyes)
-- Calculates emotion match scores
-
-### Step 3: Smart Selection
-```
-Frame 1234: Happy face (90% match) + Open eyes ✅
-Frame 1235: Neutral face (20% match) + Open eyes ❌
-Frame 1236: Happy face (85% match) + Half-closed eyes ❌
-Frame 1237: Happy face (88% match) + Open eyes ✅ ← Selected!
-```
-
-### Step 4: Result
-A comic where:
-- Happy dialogue → Happy facial expression
-- Sad dialogue → Sad facial expression
-- Angry dialogue → Angry facial expression
-- And so on...
-
-## Example Output
-
-When enabled, you'll see:
-```
-🎭 Emotion-Based Frame Selection
-📝 Analyzing 48 dialogues for emotions...
-  📖 Dialogue 1: 'Hello! How are you?' → happy
-  📖 Dialogue 2: 'I lost my toy...' → sad
-  📖 Dialogue 3: 'What?! Really?!' → surprised
-
-🎬 Scanning video for matching facial expressions...
-🔍 Finding best frame for dialogue 1: happy emotion
-  ✅ Selected frame with happy face (match: 92%, eyes: open)
-🔍 Finding best frame for dialogue 2: sad emotion
-  ✅ Selected frame with sad face (match: 85%, eyes: open)
-```
-
-## Benefits
-
-1. **More Expressive Comics**: Characters' faces match what they're saying
-2. **Better Storytelling**: Emotions enhance the narrative
-3. **No Awkward Frames**: Avoids closed eyes AND mismatched expressions
-4. **Automatic Selection**: AI does the hard work of finding perfect frames
-
-## Usage
-
-Simply enable "Smart Mode" when generating your comic. The system will:
-1. Analyze all dialogue emotions
-2. Find matching facial expressions
-3. Create a comic with perfect emotion alignment
-
-This creates comics that are not just visually correct (open eyes) but also emotionally coherent!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

EXACT_800x1080_LAYOUT.md

@@ -1,73 +1,12 @@
-# 📐 Exact 800×1080 Combined Print Layout
-
-## Yes, It's Possible!
-
-When you print, the 4 panels (each 400×540) will combine to create exactly 800×1080:
-
-```
-Combined Layout:
-┌───────────────┬───────────────┐
-│   Panel 1     │   Panel 2     │ } 540px
-│   400×540     │   400×540     │
-├───────────────┼───────────────┤
-│   Panel 3     │   Panel 4     │ } 540px  
-│   400×540     │   400×540     │
-└───────────────┴───────────────┘
-    400px           400px
-    
-Total: 800px × 1080px ✓
-```
-
-## What I've Implemented
-
-### Panel Dimensions
-- Each panel: **400px × 540px**
-- Grid: 2×2 (no gaps)
-- Total: **800px × 1080px**
-
-### CSS Applied
-```css
-.comic-grid {
-    grid-template-columns: 400px 400px;
-    grid-template-rows: 540px 540px;
-    gap: 0; /* No gaps */
-    width: 800px;
-    height: 1080px;
-}
-
-.panel {
-    width: 400px;
-    height: 540px;
-}
-```
-
-## Print Result
-
-When you print:
-1. **4 panels** combine seamlessly
-2. **No gaps** between panels
-3. **Exact dimensions**: 800×1080
-4. **Perfect alignment**
-
-## Benefits
-
-- ✅ Pixel-perfect accuracy
-- ✅ No wasted space
-- ✅ Clean grid layout
-- ✅ Predictable sizing
-
-## How It Works
-
-1. **Source panels**: 400×540 each
-2. **Grid layout**: 2×2 with no gaps
-3. **Combined result**: 800×1080
-4. **Print output**: Exact size maintained
-
-## Visual Math
-
-```
-Width:  400 + 400 = 800 ✓
-Height: 540 + 540 = 1080 ✓
-```
-
-Your comic pages will print at exactly 800×1080 pixels!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

EXACT_PAGE_MATCH_800x1080.md

@@ -1,77 +1,12 @@
-# 📏 Exact Page Size = Image Size (800×1080)
-
-## Fixed: Page Now Matches Image Dimensions Exactly
-
-### What Changed:
-
-1. **Page container**: Now exactly 800×1080 (no padding)
-2. **Grid position**: Fills entire page (0,0 to 800,1080)
-3. **Page title**: Moved outside the page box
-4. **Result**: Page dimensions = Image dimensions
-
-### Visual Layout:
-
-```
-Page Title (outside)
-┌─────────────────────┐ ← Page boundary (800×1080)
-│┌─────────┬─────────┐│
-││ 400×540 │ 400×540 ││ ← Grid fills entire page
-│├─────────┼─────────┤│
-││ 400×540 │ 400×540 ││
-│└─────────┴─────────┘│
-└─────────────────────┘
- ↑                   ↑
- 0px               800px
-
-Page height: exactly 1080px
-```
-
-### CSS Applied:
-
-```css
-.comic-page {
-    width: 800px;    /* Exact width */
-    height: 1080px;  /* Exact height */
-    padding: 0;      /* No padding */
-    position: relative;
-    overflow: hidden;
-}
-
-.comic-grid {
-    width: 800px;
-    height: 1080px;
-    position: absolute;
-    top: 0;
-    left: 0;
-    /* Grid fills entire page */
-}
-```
-
-### Benefits:
-
-✅ **Page size = Image size** (800×1080)
-✅ **No extra space** around images
-✅ **Perfect for Unity** import
-✅ **Clean export** without margins
-
-### Unity Integration:
-
-When you screenshot/export:
-- Page is exactly 800×1080
-- No white space or padding
-- Images fill entire area
-- Ready for direct Unity import
-
-### Print Result:
-
-- Prints at exact 800×1080
-- No margins or padding
-- Full image coverage
-- Professional appearance
-
-## Summary
-
-The page container now **exactly matches** the combined image dimensions:
-- Width: 400 + 400 = 800px ✓
-- Height: 540 + 540 = 1080px ✓
-- No extra space anywhere!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

FINAL_12_PAGES_SOLUTION.md

@@ -1,108 +1,12 @@
-# ✅ FINAL SOLUTION: 12 Pages × 2x2 Grid = 48 Panels
-
-## What You Want
-
-- **Grid**: 2x2 (4 panels per page)
-- **Pages**: 12 pages total
-- **Total Panels**: 48 meaningful story panels
-- **Summary**: Story summarization (not all frames)
-- **Colors**: Original preserved
-
-## Implementation
-
-### Created: `backend/fixed_12_pages_2x2.py`
-
-1. **`generate_12_pages_2x2_grid()`**:
-   - Creates exactly 12 pages
-   - Each page has 2x2 grid (4 panels)
-   - Total: 48 panels maximum
-
-2. **`select_meaningful_frames()`**:
-   - Smart story selection algorithm
-   - Allocates panels across story phases:
-     - Pages 1-2: Introduction (8 panels)
-     - Pages 3-6: Development (16 panels)
-     - Pages 7-10: Climax (16 panels)
-     - Pages 11-12: Resolution (8 panels)
-
-## 📊 Layout Structure
-
-```
-Page 1:    Page 2:    Page 3:    ...    Page 12:
-┌───┬───┐  ┌───┬───┐  ┌───┬───┐         ┌───┬───┐
-│ 1 │ 2 │  │ 5 │ 6 │  │ 9 │10 │         │45 │46 │
-├───┼───┤  ├───┼───┤  ├───┼───┤         ├───┼───┤
-│ 3 │ 4 │  │ 7 │ 8 │  │11 │12 │         │47 │48 │
-└───┴───┘  └───┴───┘  └───┴───┘         └───┴───┘
-  Intro    Intro cont. Development       Resolution
-```
-
-## 🎯 Story Distribution
-
-### Pages 1-2 (Introduction)
-- 8 panels total
-- Character introductions
-- Setting establishment
-- Initial situation
-
-### Pages 3-6 (Development)
-- 16 panels total
-- Rising action
-- Conflicts introduced
-- Character interactions
-
-### Pages 7-10 (Climax)
-- 16 panels total
-- Peak tension
-- Major events
-- Turning points
-
-### Pages 11-12 (Resolution)
-- 8 panels total
-- Conflict resolution
-- Endings
-- Final moments
-
-## 🚀 How It Works
-
-1. **Video Analysis**:
-   - Extracts all frames/subtitles
-   - Scores each moment by importance
-
-2. **Smart Selection**:
-   - Picks 48 most meaningful moments
-   - Ensures story coverage
-   - Skips repetitive content
-
-3. **Page Generation**:
-   - Creates 12 pages
-   - 4 panels per page (2x2 grid)
-   - Proper story flow
-
-4. **Color Preservation**:
-   - No comic styling
-   - Original image quality
-   - Natural colors
-
-## ✅ Result
-
-When you run the app:
-- **12 pages** generated
-- **2x2 grid** on each page
-- **48 meaningful panels** total
-- **Story summarized** (not every frame)
-- **Colors preserved** (no green tint)
-
-## 📁 Output
-
-```
-output/
-├── 1.html     # Page 1 (panels 1-4)
-├── 2.html     # Page 2 (panels 5-8)
-├── 3.html     # Page 3 (panels 9-12)
-├── ...
-├── 12.html    # Page 12 (panels 45-48)
-└── panels/    # Individual 640x800 images
-```
-
-The system now generates a complete 12-page comic book with 2x2 grid layout, showing only the most meaningful 48 story moments!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

FINAL_FIX_12_PANELS.md

@@ -1,87 +1,12 @@
-# 🎯 FINAL FIX: 12-Panel Comic with 3x4 Grid
-
-## What Was Wrong
-
-1. **2x2 Grid Issue**: The old panel layout system was forcing 2x2 grid (4 panels)
-2. **HIGH_ACCURACY Mode**: Environment variable was overriding layout
-3. **Multiple Conflicting Systems**: Different parts of code fighting each other
-
-## What's Fixed Now
-
-### 1. **Forced 12-Panel Selection**
-- Modified `_generate_story_pages()` to use fixed 12-panel generator
-- Limits frames to exactly 12 most important ones
-- No more 2x2 grid!
-
-### 2. **Proper 3x4 Grid Layout**
-- Created `backend/fixed_page_generator.py`
-- Generates single page with 3 rows × 4 columns
-- Each panel properly sized (row_span=4, col_span=3)
-
-### 3. **Color Preservation**
-- Comic styling disabled by default
-- `self.apply_comic_style = False`
-- Original image quality maintained
-
-### 4. **Story-Based Selection**
-- Smart story extractor targets 12 panels
-- Selects introduction, conflict, climax, resolution
-- Skips unimportant moments
-
-## 🚀 How It Works Now
-
-1. **Upload Video** → Extracts subtitles
-2. **Story Analysis** → Finds 12 most important moments
-3. **Frame Extraction** → Gets frames for those moments only
-4. **No Styling** → Preserves original colors
-5. **3x4 Grid** → Displays 12 panels properly
-
-## 📊 Layout Details
-
-```
-┌───┬───┬───┬───┐
-│ 1 │ 2 │ 3 │ 4 │  Row 1
-├───┼───┼───┼───┤
-│ 5 │ 6 │ 7 │ 8 │  Row 2
-├───┼───┼───┼───┤
-│ 9 │ 10│ 11│ 12│  Row 3
-└───┴───┴───┴───┘
-    3x4 Grid
-```
-
-## 🔧 Key Changes Made
-
-1. **app_enhanced.py**:
-   - `_generate_story_pages()` now uses fixed 12-panel generator
-   - Forces story-based layout for all comics
-   - Disabled comic styling
-
-2. **backend/fixed_page_generator.py**:
-   - New clean implementation
-   - `generate_12_panel_pages()` creates proper 3x4 grid
-   - Correct panel dimensions
-
-3. **backend/panel_layout/layout/page.py**:
-   - Changed templates from `['6666', '6666', '6666', '6666']` 
-   - To `['333333333333']` (12 panels)
-
-4. **Environment**:
-   - HIGH_ACCURACY = '0' (disabled)
-   - GRID_LAYOUT = '0' (disabled)
-
-## ✅ Result
-
-When you run `python app_enhanced.py` now:
-- ✅ Exactly 12 meaningful story panels
-- ✅ 3x4 grid layout (NOT 2x2)
-- ✅ Original colors preserved
-- ✅ Smart story selection
-
-## 🎨 No More Issues
-
-- **No green tint** (comic styling disabled)
-- **No 4-panel limit** (fixed to 12 panels)
-- **No 2x2 grid** (proper 3x4 layout)
-- **No unnecessary frames** (only important moments)
-
-The comic generator now creates exactly what you wanted: 12 meaningful story panels in a 3x4 grid with original colors!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

FIXES_APPLIED.md

@@ -1,103 +1,12 @@
-# 🔧 Comic Generation Fixes Applied
-
-## ✅ Issue 1: Colorless/Green Comics - FIXED
-
-### Problem:
-- Comic styling was too aggressive
-- Heavy quantization removed colors
-- Images appeared green/monochrome
-
-### Solution Applied:
-- **Comic styling DISABLED by default** (`self.apply_comic_style = False`)
-- Color preservation mode enabled
-- Original image colors maintained
-- No edge effects or quantization
-
-### Result:
-- ✅ Full color images preserved
-- ✅ Natural looking frames
-- ✅ No green tint
-
-## ✅ Issue 2: Only 4 Panels - FIXED
-
-### Problem:
-- Hardcoded to generate 4 panels per page
-- Ignored story importance
-- Missed key moments
-
-### Solution Applied:
-1. **Smart Story Extraction**:
-   - Analyzes ALL subtitles
-   - Scores by importance (emotion, action, length)
-   - Selects 10-15 key moments
-   - Ensures intro, climax, resolution
-
-2. **Story-Based Keyframe Generation**:
-   - Only extracts frames for selected moments
-   - Skips unimportant dialogue
-
-3. **Adaptive Layout**:
-   - 1-6 panels: Single page (2x3)
-   - 7-9 panels: Single page (3x3)
-   - 10-12 panels: Two pages (2x3 each)
-   - 13-15 panels: Multiple pages
-
-4. **Fixed Page Generation**:
-   - Now uses `_generate_story_pages()`
-   - Respects filtered subtitle count
-   - Creates appropriate grid layouts
-
-### Result:
-- ✅ 10-15 meaningful panels (not just 4)
-- ✅ Complete story coverage
-- ✅ Adaptive multi-page layouts
-
-## 📋 Current Configuration
-
-```python
-# In app_enhanced.py:
-self.apply_comic_style = False   # Preserves colors
-self.preserve_colors = True      # Additional safety
-target_panels = 15               # In story extractor
-```
-
-## 🚀 How It Works Now
-
-1. **Video Upload** → Extracts audio/subtitles
-2. **Story Analysis** → Identifies 10-15 key moments
-3. **Smart Keyframes** → Only extracts important frames
-4. **Enhancement** → AI upscaling (max 2K)
-5. **NO Comic Styling** → Preserves original colors
-6. **Adaptive Layout** → 2x3, 3x3, or multi-page
-7. **Panel Export** → 640x800 individual images
-
-## 🎨 Example Output
-
-Instead of:
-- 4 panels with green tint
-- Random frame selection
-- Fixed 2x2 layout
-
-You now get:
-- 10-15 full-color panels
-- Story-driven selection
-- Flexible grid layouts
-- Natural colors preserved
-
-## 💡 Usage
-
-Just run the app normally:
-```bash
-python app_enhanced.py
-```
-
-The fixes are applied automatically:
-- Colors will be preserved
-- Story extraction will select meaningful moments
-- Layout will adapt to content
-
-## 🎯 Summary
-
-The comic generator now creates **full-color, story-driven comics** with **10-15 meaningful panels** instead of colorless 4-panel grids!
-
-All issues have been addressed in the codebase.
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

FIXES_SUMMARY.md

@@ -1,88 +1,12 @@
-# 🔧 Fixes Applied for 12-Page Comic Generation
-
-## Issues Fixed
-
-### 1. **Page Generation Error** ✅
-- **Problem**: `Page.__init__() got an unexpected keyword argument 'panel_arrangement'`
-- **Fix**: Removed `panel_arrangement` parameter from Page constructor
-- **Files**: `backend/fixed_12_pages_2x2.py`, `app_enhanced.py`
-
-### 2. **Subtitle Filtering Error** ✅
-- **Problem**: `No such file or directory: 'audio/temp_subtitles.json'`
-- **Fix**: Added `os.makedirs('audio', exist_ok=True)`
-- **File**: `app_enhanced.py`
-
-### 3. **Layout Optimizer Error** ✅
-- **Problem**: imread trying to read individual characters ('f', 'r', 'a', 'm', 'e', 's')
-- **Fix**: Pass list of frame paths instead of directory string
-- **File**: `app_enhanced.py`
-
-### 4. **Enhancement Issue** ✅
-- **Note**: Enhancement is working but resizing to 2K (1920x1080) as intended
-- This is correct behavior to limit resolution
-
-## Current Configuration
-
-### What the System Does Now:
-
-1. **Extracts Subtitles** → Analyzes story
-2. **Selects Frames** → 48 meaningful moments (or all if less)
-3. **Enhances Images** → Max 2K resolution, preserves colors
-4. **Generates Pages** → 12 pages with 2x2 grid each
-5. **Creates Output** → HTML pages with embedded images
-
-### Layout Structure:
-```
-12 Pages × 4 Panels = 48 Total Panels
-
-Page 1-2:   Introduction (8 panels)
-Page 3-6:   Development (16 panels)  
-Page 7-10:  Climax (16 panels)
-Page 11-12: Resolution (8 panels)
-```
-
-### Each Page:
-```
-┌───┬───┐
-│ 1 │ 2 │  2x2 Grid
-├───┼───┤  4 panels per page
-│ 3 │ 4 │
-└───┴───┘
-```
-
-## To Generate Comics:
-
-1. Start the app:
-   ```bash
-   python app_enhanced.py
-   ```
-
-2. Upload your video
-
-3. The system will:
-   - Extract subtitles
-   - Select 48 meaningful moments
-   - Generate 12 pages
-   - Each page has 2x2 grid
-   - Preserve original colors
-
-## Expected Output:
-
-```
-output/
-├── 1.html      # Page 1 (panels 1-4)
-├── 2.html      # Page 2 (panels 5-8)
-├── ...
-├── 12.html     # Page 12 (panels 45-48)
-├── pages.json  # Comic data
-└── panels/     # Individual 640x800 images
-```
-
-## Notes:
-
-- If video has less than 48 frames, it will use all available frames
-- Empty panels will show first frame as placeholder
-- Colors are preserved (no comic styling applied)
-- Resolution limited to 2K for performance
-
-The system now properly generates 12 pages with 2x2 grid layout!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

FRAME_GENERATION_FIX.md

@@ -1,64 +1,12 @@
-# 🔧 Frame Generation Fix
-
-## The Problem
-
-From your output, I can see:
-1. ✅ System correctly finds 89 subtitles
-2. ✅ Selects 48 moments for full story  
-3. ❌ BUT somewhere it reverts to 12 moments
-4. ❌ Shows "0 frames" when generating pages
-5. ❌ Tries to use "blank.png" which doesn't exist
-
-## Root Cause
-
-The pipeline is inconsistent:
-- **Story extraction**: Selects 48 moments ✅
-- **Keyframe generation**: Should extract 48 frames ❌
-- **Bubble generation**: Filters back to 12 ❌
-- **Page generation**: Finds 0 frames ❌
-
-## What I've Fixed
-
-### 1. Disabled Double Filtering
-- Removed the second filtering in bubble generation
-- Now uses the same 48 moments throughout
-
-### 2. Ensured Consistent Frame Count
-- Set `_filtered_count` to 48 for full story
-- This count is used across all components
-
-### 3. Better Logging
-- Added logging to show frame generation status
-- Shows how many files are in frames/final/
-
-## What Should Happen Now
-
-1. **Story Extraction**: 89 → 48 moments
-2. **Frame Extraction**: 48 frames saved to frames/final/
-3. **Enhancement**: All 48 frames enhanced
-4. **Page Generation**: 12 pages × 4 panels = 48 panels
-5. **Output**: Complete story comic
-
-## Debugging Steps
-
-If frames still aren't generated:
-
-1. Check if frames/final/ directory exists and has files
-2. Check if extract_frames function is working
-3. Check if video path is correct
-4. Check if ffmpeg/cv2 can read the video
-
-## Expected Output After Fix
-
-```
-📖 Extracting complete story...
-✅ Selected 48 evenly distributed moments
-🎯 Generating keyframes...
-✅ Generated 48 keyframes in frames/final/
-📁 Frame files: 48 files in frames/final/
-🎨 Enhancing quality and colors...
-📄 Generating 12 pages with 2x2 grid
-✅ Generated 12 pages with 48 total panels
-```
-
-The system should now generate all 48 frames properly!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

FULL_STORY_QUALITY_FIX.md

@@ -1,100 +1,12 @@
-# 🎯 Full Story & Quality Enhancement Fix
-
-## What Was Wrong
-
-1. **Missing Story Parts**: System was being too selective, skipping important story elements
-2. **Poor Quality/Colors**: Images needed enhancement for better quality and vibrant colors
-
-## What's Fixed Now
-
-### 1. **Full Story Extraction** ✅
-- Created `backend/full_story_extractor.py`
-- Takes **evenly distributed** frames across entire video
-- Ensures complete story: Beginning → Middle → End
-- No more skipping important parts
-- If video has <48 subtitles, uses ALL of them
-
-### 2. **Quality & Color Enhancement** ✅
-- Created `backend/quality_color_enhancer.py`
-- Improves each frame:
-  - **Denoising**: Removes grain/noise
-  - **Sharpening**: Clearer details
-  - **Color Enhancement**: 30% more vibrant colors
-  - **Brightness**: 10% brighter
-  - **Contrast**: 20% more contrast
-  - **Auto White Balance**: Corrects color cast
-  - **Dark Area Enhancement**: Better shadow details
-
-### 3. **Better Story Distribution** ✅
-For 48 panels (12 pages × 4 panels):
-- Pages 1-2: **Introduction** (8 panels)
-- Pages 3-6: **Development** (16 panels)
-- Pages 7-10: **Climax** (16 panels)
-- Pages 11-12: **Resolution** (8 panels)
-
-## 🎨 Enhancement Pipeline
-
-1. **AI Enhancement** (if enabled) → Max 2K resolution
-2. **Quality Enhancement** → Sharper, cleaner images
-3. **Color Enhancement** → Vibrant, natural colors
-4. **Comic Styling** (if enabled) → Or skip to preserve realism
-
-## 📊 How It Works Now
-
-### For Short Videos (<48 subtitles):
-- Uses **ALL** subtitles
-- Complete story, nothing skipped
-- Enhanced quality and colors
-
-### For Long Videos (>48 subtitles):
-- Takes **evenly spaced** samples
-- Covers entire timeline
-- Maintains story continuity
-- No gaps in narrative
-
-## 🚀 Example
-
-**Before**:
-- Selected only "important" moments
-- Missed connecting dialogue
-- Dull colors
-- Story felt incomplete
-
-**After**:
-- Even sampling across entire video
-- Full story preserved
-- Vibrant, enhanced colors
-- Sharp, clear images
-- Complete narrative flow
-
-## 💡 Key Improvements
-
-1. **Story Completeness**:
-   - No more aggressive filtering
-   - Even distribution ensures full coverage
-   - First and last moments always included
-
-2. **Visual Quality**:
-   - Professional-grade enhancement
-   - Natural color correction
-   - Noise reduction
-   - Detail enhancement
-
-3. **Flexibility**:
-   - Works with any video length
-   - Adapts to available content
-   - Maintains 12-page format
-
-## 📁 Output
-
-```
-12 Pages × 2x2 Grid = 48 Enhanced Panels
-
-Each panel:
-- Full story context
-- Enhanced quality
-- Vibrant colors
-- Sharp details
-```
-
-The system now creates a complete, visually stunning comic that tells the FULL story!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

INTERACTIVE_COMIC_EDITOR.md

@@ -1,77 +1,12 @@
-# 🎨 Interactive Comic Editor
-
-## Features Implemented
-
-The generated comics now have **interactive editing capabilities** built right into the output!
-
-### 1. **Text Editing** ✏️
-- **Double-click** any speech bubble to edit its text
-- Type your new text in the textarea that appears
-- Press **Enter** to save (Shift+Enter for new line)
-- Press **Escape** to cancel
-
-### 2. **Drag & Drop** 🖱️
-- **Click and drag** any speech bubble to reposition it
-- Bubbles stay within panel boundaries
-- Smooth visual feedback while dragging
-- Position is saved automatically
-
-### 3. **Auto-Save** 💾
-- All changes are automatically saved to browser's local storage
-- Edits persist even after refreshing the page
-- Each comic maintains its own saved state
-
-### 4. **Visual Feedback** ✨
-- Hover effects on bubbles
-- Editing mode visual indicators
-- Smooth transitions and animations
-- Professional looking interface
-
-## How It Works
-
-When you generate a comic:
-
-1. The output includes all editing functionality
-2. Speech bubbles are automatically interactive
-3. An editing guide appears in the bottom-right corner
-4. Changes save locally in your browser
-
-## User Experience
-
-### Before Editing:
-- Static comic with fixed text and positions
-- No way to correct or improve dialogue
-- Fixed bubble placements
-
-### After Editing:
-- Fix typos or improve dialogue
-- Reposition bubbles for better flow
-- Perfect the comic to your liking
-- Save and share your edited version
-
-## Technical Implementation
-
-The editing features are:
-- Built into the generated HTML
-- No external dependencies needed
-- Works in all modern browsers
-- Lightweight and fast
-
-## Usage Instructions
-
-1. **Generate your comic** normally
-2. **Open the comic** in your browser
-3. **Edit freely**:
-   - Double-click bubbles to edit text
-   - Drag bubbles to reposition
-4. **Changes auto-save** locally
-5. **Export** by printing or screenshot
-
-## Benefits
-
-1. **Fix mistakes**: Correct any dialogue issues
-2. **Improve flow**: Reposition bubbles optimally
-3. **Personalize**: Make the comic truly yours
-4. **No extra tools**: Everything built-in
-
-The interactive editor makes your generated comics fully customizable while maintaining the original visual style!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

NO_GAPS_FIX.md

@@ -1,68 +1,12 @@
-# 🔧 Fixed: Gaps Between Panels
-
-## What Was Fixed
-
-Removed gaps between panels to create a seamless 800×1080 layout.
-
-## Changes Made
-
-1. **Grid gap**: Set to `0`
-2. **Panel borders**: Reduced from 2px to 1px
-3. **Smart borders**: Removed double borders between adjacent panels
-4. **Margins/Padding**: All set to 0
-
-## Visual Result
-
-### Before (with gaps):
-```
-┌───┐ ┌───┐
-│ 1 │ │ 2 │  <- Gaps between panels
-└───┘ └───┘
-      
-┌───┐ ┌───┐
-│ 3 │ │ 4 │
-└───┘ └───┘
-```
-
-### After (no gaps):
-```
-┌───┬───┐
-│ 1 │ 2 │  <- Seamless connection
-├───┼───┤
-│ 3 │ 4 │
-└───┴───┘
-```
-
-## Exact Layout
-
-- Panel 1: 0,0 to 400,540
-- Panel 2: 400,0 to 800,540  
-- Panel 3: 0,540 to 400,1080
-- Panel 4: 400,540 to 800,1080
-- **Total**: Exactly 800×1080
-
-## Options
-
-### Current (minimal borders):
-- 1px borders between panels
-- Clean grid appearance
-- No gaps
-
-### Alternative (no borders):
-To remove ALL borders, uncomment this CSS:
-```css
-.panel { border: none !important; }
-.comic-grid { border: 2px solid #333; }
-```
-
-This gives you:
-- Completely seamless panels
-- Single outer border only
-- Pure 800×1080 content
-
-## Result
-
-✅ No more gaps between panels
-✅ Exact 800×1080 combined size
-✅ Clean, professional appearance
-✅ Perfect for printing
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

NO_ZOOM_FIX_GUIDE.md

@@ -1,75 +1,12 @@
-# 🔍 Fixed: Image Zooming Issue
-
-## Problem Solved
-
-Images were zooming/cropping because `object-fit: cover` was forcing them to fill the entire 400×540 panel space.
-
-## Solution Applied
-
-Changed to `object-fit: contain` which:
-- ✅ Shows the **entire image** without cropping
-- ✅ **No zooming** - maintains original aspect ratio
-- ✅ Adds white padding if image doesn't match 400×540 ratio
-- ✅ Centers the image in the panel
-
-## Visual Difference
-
-### Before (cover - zoomed):
-```
-┌─────────┐
-│ ZOOMED  │ <- Image fills panel
-│ IMAGE   │ <- Edges are cropped
-│ (crop)  │ <- Details lost
-└─────────┘
-```
-
-### After (contain - no zoom):
-```
-┌─────────┐
-│ padding │ <- White space if needed
-│ [IMAGE] │ <- Entire image visible
-│ padding │ <- No cropping
-└─────────┘
-```
-
-## Options Available
-
-### 1. **Current Setting** (contain - recommended)
-- No zoom or crop
-- Shows entire image
-- May have letterboxing
-
-### 2. **Alternative Options**
-
-To change behavior, edit the CSS:
-
-```css
-/* Option 1: Zoom to fill (original issue) */
-.panel img { object-fit: cover; }
-
-/* Option 2: Stretch to exact size */
-.panel img { object-fit: fill; }
-
-/* Option 3: Show entire image (current) */
-.panel img { object-fit: contain; }
-```
-
-## For Perfect 400×540 Images
-
-If you want images to fit exactly without padding:
-
-1. **Resize images before importing**:
-   ```bash
-   ffmpeg -i input.png -vf "scale=400:540" output.png
-   ```
-
-2. **Or use the resize script**:
-   - Run: `python3 -c "from backend.image_resizer_400x540 import resize_for_exact_layout; resize_for_exact_layout()"`
-   - This creates properly sized images
-
-## Result
-
-- ✅ No more zooming
-- ✅ Full image visible
-- ✅ Maintains aspect ratio
-- ✅ Clean 800×1080 output when printed
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

PAGES_800x1080_IMPLEMENTATION.md

@@ -1,100 +1,12 @@
-# 📄 Comic Pages at 800x1080 Resolution
-
-## What Was Changed
-
-I've modified the comic generation system so that the actual comic PAGES are now rendered at 800x1080 resolution. This is not about exporting images - the comic pages themselves are now exactly 800x1080 pixels.
-
-## Implementation Details
-
-### 1. **Page Dimensions**
-- Each comic page is now **800px wide × 1080px tall**
-- This is a portrait orientation (taller than wide)
-- Perfect for mobile viewing and social media
-
-### 2. **What Changed**
-
-#### Backend Changes:
-- Created `backend/fixed_12_pages_800x1080.py` 
-- Updated page generation to specify 800x1080 resolution
-- Modified `Page` and `panel` classes to support metadata
-
-#### Frontend Changes:
-- Comic pages now display at exactly 800x1080
-- Added CSS: `width: 800px; height: 1080px;`
-- Shows "800x1080 resolution" under each page title
-- Print styles updated to maintain dimensions
-
-### 3. **Visual Layout**
-
-```
-┌─────────────────────┐
-│     Page 1          │ 
-│ 800x1080 resolution │ 800px
-├──────────┬──────────┤
-│          │          │
-│  Panel 1 │  Panel 2 │
-│          │          │
-├──────────┼──────────┤ 1080px
-│          │          │
-│  Panel 3 │  Panel 4 │
-│          │          │
-└─────────────────────┘
-```
-
-### 4. **Benefits**
-
-- **Consistent Size**: Every page is exactly 800x1080
-- **Mobile Friendly**: Perfect aspect ratio for phones
-- **Social Media Ready**: Ideal for Instagram stories (9:16)
-- **Print Optimized**: Maintains size when printing
-
-## How It Works
-
-When you generate a comic:
-
-1. System creates 12 pages
-2. Each page is set to 800x1080 pixels
-3. 2x2 panel grid fits within this resolution
-4. Speech bubbles scale proportionally
-
-## Viewing Your Comic
-
-### In Browser:
-- Pages display at actual 800x1080 size
-- May appear smaller on large screens
-- Scroll to view each page
-
-### On Mobile:
-- Pages fit perfectly in portrait mode
-- Optimal viewing experience
-- No horizontal scrolling needed
-
-### Printing:
-- Set paper to A5 or custom 5.33" × 7.2"
-- Pages print at correct dimensions
-- Use settings from print guide
-
-## Technical Specs
-
-- **Page Width**: 800 pixels
-- **Page Height**: 1080 pixels
-- **Aspect Ratio**: 1:1.35 (9:16 proportionally)
-- **Panel Grid**: 2×2 (4 panels per page)
-- **Total Pages**: 12
-- **Total Panels**: 48
-
-## CSS Applied
-
-```css
-.comic-page { 
-    width: 800px; 
-    height: 1080px; 
-    padding: 20px; 
-    margin: 30px auto; 
-    box-sizing: border-box;
-}
-```
-
-## Result
-
-Your comic pages are now natively 800x1080 pixels - not just exported at that size, but actually rendered and displayed at those exact dimensions throughout the system!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

PAGE_IMAGES_GUIDE.md

@@ -1,175 +1,12 @@
-# 📄 Comic Page Images (800x1080)
-
-## Overview
-
-The system now automatically generates individual page images at **800x1080 resolution** for each comic page. This makes it easy to:
-- Share comic pages on social media
-- Create printable versions
-- Use pages in other applications
-- Archive your comics
-
-## Features
-
-### 🎨 What You Get
-
-1. **Individual Page Files**
-   - Each comic page saved as a separate PNG image
-   - Resolution: 800x1080 pixels (portrait)
-   - High quality with 95% compression
-   - Numbered sequentially (page_001.png, page_002.png, etc.)
-
-2. **Complete Comic Layout**
-   - 2x2 panel grid preserved
-   - Speech bubbles included
-   - Black borders around panels
-   - Page numbers at bottom
-
-3. **Gallery Viewer**
-   - HTML gallery to view all pages
-   - Download individual pages
-   - Download all pages at once
-   - Thumbnail preview
-
-## How It Works
-
-### Automatic Generation
-
-After creating a comic:
-1. System generates the interactive HTML comic
-2. Extracts individual panels (640x800)
-3. **Creates page images (800x1080)** ← NEW!
-4. Saves to `output/page_images/`
-
-### Access Page Images
-
-**Option 1: From Comic Viewer**
-- Click the **"🖼️ View Page Images"** button
-- Opens gallery in new tab
-
-**Option 2: Direct Access**
-- Navigate to: `output/page_images/index.html`
-- Or go to: http://localhost:5000/output/page_images/index.html
-
-**Option 3: File System**
-- Find images in: `/workspace/output/page_images/`
-- Files: `page_001.png`, `page_002.png`, etc.
-
-## Page Image Layout
-
-Each 800x1080 image contains:
-
-```
-┌─────────────────────┐
-│   Comic Page X      │ 800px
-├──────────┬──────────┤
-│          │          │
-│  Panel 1 │  Panel 2 │
-│          │          │
-├──────────┼──────────┤ 1080px
-│          │          │
-│  Panel 3 │  Panel 4 │
-│          │          │
-├─────────────────────┤
-│      Page X         │
-└─────────────────────┘
-```
-
-## Use Cases
-
-### 1. **Social Media Sharing**
-- Perfect size for Instagram stories (9:16 ratio)
-- Easy to share individual pages
-- Maintains readability on mobile
-
-### 2. **Printing**
-- Standard portrait orientation
-- Good resolution for A4/Letter printing
-- Multiple pages per sheet possible
-
-### 3. **Digital Publishing**
-- Ready for e-book conversion
-- Suitable for web comics
-- Easy to create PDFs
-
-### 4. **Archiving**
-- Consistent file naming
-- Portable format
-- No dependencies needed
-
-## Technical Details
-
-### Image Specifications
-- **Format**: PNG
-- **Resolution**: 800x1080 pixels
-- **Color**: RGB (full color)
-- **Compression**: 95% quality
-- **File size**: ~200-500KB per page
-
-### Processing Steps
-1. Load comic page data from JSON
-2. Create white canvas (800x1080)
-3. Draw 2x2 panel grid with borders
-4. Place panel images (maintaining aspect ratio)
-5. Add speech bubbles with text
-6. Add page number
-7. Save as PNG
-
-## Gallery Features
-
-The page image gallery includes:
-
-- **Grid View**: See all pages at once
-- **Download Links**: Individual page downloads
-- **Batch Download**: Get all pages with one click
-- **Responsive Design**: Works on mobile/tablet
-- **Quick Preview**: Hover to enlarge
-
-## Tips
-
-### For Best Results
-1. **Original Quality**: Use high-quality video/images
-2. **Clear Text**: Ensure subtitles are readable
-3. **Good Lighting**: Better source = better pages
-
-### Customization
-- Edit `backend/page_image_generator.py` to:
-  - Change resolution (default 800x1080)
-  - Adjust border thickness
-  - Modify panel spacing
-  - Change background color
-
-### Storage
-- Page images are saved in: `output/page_images/`
-- Each comic generation overwrites previous pages
-- Consider backing up pages you want to keep
-
-## Example Usage
-
-### After Comic Generation
-```
-✅ Comic generation completed in 2.41 minutes
-📄 Generating page images (800x1080)...
-📄 Generated page 1/12: page_001.png
-📄 Generated page 2/12: page_002.png
-...
-📄 Generated page 12/12: page_012.png
-📋 Page index created: output/page_images/index.html
-✅ Generated 12 page images (800x1080)
-📄 Page gallery available at: output/page_images/index.html
-```
-
-### Accessing Images
-1. Click "🖼️ View Page Images" in comic viewer
-2. Browse gallery
-3. Download individual pages or all at once
-
-## Future Enhancements
-
-Possible additions:
-- Custom resolutions (720x1280, 1080x1920)
-- Different layouts (3x3, 1x4)
-- Watermark options
-- JPEG format support
-- Automatic upload to cloud
-
-Enjoy your page images! 🎨📄
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

PAGE_IMAGES_IMPLEMENTATION.md

@@ -1,123 +1,12 @@
-# 📄 Page Images Implementation Summary
-
-## What Was Implemented
-
-I've added functionality to save comic pages as individual 800x1080 images. Due to Python module constraints in the environment, I created an HTML-based solution that renders each comic page at the exact dimensions you requested.
-
-## How It Works
-
-### 1. **Automatic Generation**
-After comic generation completes, the system automatically:
-- Creates individual page files for each comic page
-- Generates pages at 800x1080 resolution
-- Preserves the 2x2 panel layout
-- Includes speech bubbles and text
-- Saves to `output/page_images/`
-
-### 2. **Page Format**
-Each page is created as:
-- **HTML files** that render at exactly 800x1080 pixels
-- Clean white background with black panel borders
-- Speech bubbles positioned correctly
-- Page numbers at the bottom
-
-### 3. **Access Methods**
-
-#### From Comic Viewer
-Click the **"🖼️ View Page Images"** button in the interactive editor
-
-#### Direct Gallery Access
-Open: `http://localhost:5000/output/page_images/index.html`
-
-#### File System
-Browse to: `/workspace/output/page_images/`
-
-## Features
-
-### Gallery View
-- Grid layout showing all pages
-- Click any page to view full size
-- Each page opens in a new tab
-- Download individual pages
-
-### Page Viewer
-Each page includes:
-- Fixed 800x1080 dimensions
-- Responsive scaling for smaller screens
-- Print-friendly layout
-- Download button
-
-### How to Save as Actual Images
-
-Since we're using HTML rendering, here are ways to get actual image files:
-
-1. **Screenshot Method** (Best Quality)
-   - Open a page
-   - Take a screenshot
-   - The page is exactly 800x1080
-
-2. **Print to PDF**
-   - Click "Download as Image"
-   - Choose "Save as PDF"
-   - Set paper size to match
-
-3. **Browser Extensions**
-   - Use "Full Page Screen Capture" extensions
-   - Save as PNG/JPEG
-
-## Technical Details
-
-### File Structure
-```
-output/
-  page_images/
-    index.html          # Gallery viewer
-    page_001.html       # Page 1 (800x1080)
-    page_002.html       # Page 2 (800x1080)
-    ...
-    page_012.html       # Page 12 (800x1080)
-```
-
-### Page Layout
-- **Size**: 800x1080 pixels (portrait)
-- **Grid**: 2x2 panels
-- **Margins**: 20px padding
-- **Panel gap**: 10px
-- **Border**: 3px black
-
-### Code Location
-- Implementation: `/workspace/backend/page_image_generator.py`
-- Integration: `/workspace/app_enhanced.py` (line 910)
-- Route handling: Automatic via Flask
-
-## Example Output
-
-When you generate a comic, you'll see:
-```
-📄 Generating page images (800x1080)...
-📄 Generated page 1/12: page_001.html
-📄 Generated page 2/12: page_002.html
-...
-📄 Generated page 12/12: page_012.html
-📋 Page gallery created: output/page_images/index.html
-✅ Generated 12 page images (800x1080)
-📄 Page gallery available at: output/page_images/index.html
-```
-
-## Benefits
-
-1. **Exact Size**: Every page is precisely 800x1080
-2. **Portable**: HTML files work anywhere
-3. **Editable**: Can modify HTML if needed
-4. **Lightweight**: No heavy image processing
-5. **Print-Ready**: Optimized for printing
-
-## Future Enhancement Options
-
-If you need actual PNG/JPEG files, we could:
-1. Use a headless browser (Puppeteer/Playwright)
-2. Install image libraries in a virtual environment
-3. Use an external API service
-4. Add client-side canvas rendering
-
-The current solution provides the 800x1080 layout you requested and can be easily converted to images using browser tools!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

PDF_EXPORT_GUIDE.md

@@ -1,149 +1,12 @@
-# 📄 PDF Export for Edited Comics
-
-## Overview
-
-The comic editor now supports **PDF export** that preserves all your edits - both text changes and bubble repositioning!
-
-## Export Methods
-
-### 1. **Browser Print-to-PDF** (Recommended) ✅
-The simplest and most reliable method:
-
-1. Click **"Export to PDF"** button in the editor
-2. Print dialog opens with optimized settings
-3. Select **"Save as PDF"** as your printer
-4. Choose your settings:
-   - Paper size: A4 (default)
-   - Margins: Minimal
-   - Background graphics: Enabled
-5. Click **Save**
-
-**Benefits:**
-- Works in all browsers
-- No additional libraries needed
-- Preserves exact layout
-- High quality output
-- Includes all edits
-
-### 2. **Direct Print** 🖨️
-For physical printing:
-
-1. Click **"Print Comic"** button
-2. Select your printer
-3. Adjust settings as needed
-4. Print
-
-### 3. **Server-Side PDF** (Advanced) 🔧
-For programmatic generation:
-
-```javascript
-// The system can send edited data to server
-// Server generates PDF using Python libraries
-// Automatic download of generated PDF
-```
-
-## PDF Features
-
-### What's Preserved:
-- ✅ All text edits
-- ✅ Bubble positions
-- ✅ Font styles
-- ✅ Comic layout
-- ✅ Image quality
-- ✅ Colors and styling
-
-### Print Optimizations:
-- Edit controls hidden automatically
-- Page breaks between comic pages
-- Optimized margins for printing
-- High-resolution output
-- Professional appearance
-
-## How It Works
-
-### Client-Side (Browser):
-1. Your edits are saved in the browser
-2. Print CSS ensures proper formatting
-3. Browser's PDF engine creates the file
-4. All edits are preserved
-
-### Server-Side (Optional):
-1. Edited data sent to server
-2. Python generates PDF with ReportLab
-3. Bubbles drawn at edited positions
-4. PDF returned for download
-
-## Usage Instructions
-
-### Quick Export:
-1. Edit your comic (drag bubbles, change text)
-2. Click **"Export to PDF"**
-3. Choose "Save as PDF" in print dialog
-4. Save your edited comic!
-
-### Keyboard Shortcut:
-- Press **Ctrl+P** (or Cmd+P on Mac)
-- Automatically opens PDF export
-
-### Best Practices:
-1. **Preview first**: Check layout before saving
-2. **Landscape mode**: For wider comics
-3. **Scale to fit**: Ensures all content visible
-4. **Color settings**: Enable background graphics
-
-## Technical Details
-
-### Print Styles Applied:
-```css
-@media print {
-    /* Hide editor controls */
-    .edit-controls { display: none; }
-    
-    /* Optimize layout */
-    .comic-page { 
-        page-break-inside: avoid;
-        page-break-after: always;
-    }
-    
-    /* Preserve colors */
-    .speech-bubble {
-        -webkit-print-color-adjust: exact;
-        print-color-adjust: exact;
-    }
-}
-```
-
-### PDF Generation Options:
-
-1. **Browser Native**: Uses browser's PDF engine
-2. **jsPDF + html2canvas**: Client-side library option
-3. **ReportLab**: Server-side Python generation
-4. **Puppeteer/Playwright**: Headless browser option
-
-## Troubleshooting
-
-### If PDF looks different:
-- Ensure "Background graphics" is enabled
-- Check page margins are set correctly
-- Try different scale settings
-
-### If edits aren't showing:
-- Make sure to save edits first (happens automatically)
-- Refresh page and try again
-- Check browser console for errors
-
-## Benefits
-
-1. **Portable**: Share edited comics as PDF
-2. **Print-ready**: Professional quality output
-3. **Archived**: Preserve your creative edits
-4. **Universal**: PDF works everywhere
-5. **High quality**: Vector text, embedded images
-
-Your edited comics can now be:
-- Shared as PDF files
-- Printed professionally
-- Archived permanently
-- Distributed easily
-
-The PDF export makes your interactive edits permanent and shareable!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

PDF_SIZING_FIX.md

@@ -1,137 +1,12 @@
-# 📐 PDF Export Full Page Sizing Guide
-
-## The Issue
-When exporting to PDF, comic pages may appear small or not fill the entire page.
-
-## Solutions
-
-### 1. **Use Correct Print Settings** (Most Important!)
-
-When you click "Export to PDF", use these settings in the print dialog:
-
-#### **Recommended Settings:**
-- **Destination**: Save as PDF
-- **Layout**: **Landscape** ← Important!
-- **Paper size**: A4 or Letter
-- **Margins**: **None** or **Minimum**
-- **Scale**: **Fit to page** or **100%**
-- **Options**: ✓ Background graphics
-
-### 2. **Browser-Specific Settings**
-
-#### **Chrome/Edge:**
-```
-Layout: Landscape
-Margins: None
-Scale: Fit to page width
-✓ Background graphics
-```
-
-#### **Firefox:**
-```
-Orientation: Landscape
-Margins: None
-Scale: Fit to Page
-✓ Print backgrounds
-```
-
-#### **Safari:**
-```
-Orientation: Landscape
-Scale: 100%
-✓ Print backgrounds
-```
-
-### 3. **What I've Fixed**
-
-The system now:
-- Sets each comic page to fill the entire PDF page
-- Uses landscape orientation for better fit
-- Removes unnecessary margins
-- Scales panels to maximum size
-- Preserves 2x2 grid layout
-
-### 4. **Manual Adjustments**
-
-If pages still appear small:
-
-1. **In Print Dialog:**
-   - Change "Scale" to "Fit to page width"
-   - Or set custom scale (try 120-150%)
-   - Ensure margins are "None"
-
-2. **Paper Size:**
-   - Try "Letter" if A4 doesn't work well
-   - Or use "Tabloid" for larger output
-
-3. **Layout:**
-   - Always use "Landscape" for comics
-   - Portrait will make panels tiny
-
-## Technical Details
-
-The CSS now sets:
-```css
-/* Each comic page fills PDF page */
-.comic-page {
-    width: 100vw;
-    height: 100vh;
-    page-break-after: always;
-}
-
-/* Page settings */
-@page {
-    size: A4 landscape;
-    margin: 10mm;
-}
-```
-
-## Quick Checklist
-
-Before clicking "Save" in print dialog:
-
-- [ ] Layout = **Landscape**
-- [ ] Margins = **None** or **Default**
-- [ ] Scale = **Fit to page**
-- [ ] Background graphics = **Enabled**
-- [ ] Paper size = **A4** or **Letter**
-
-## If Still Having Issues
-
-### Option 1: Custom Scale
-- Set Scale to "Custom"
-- Try 115% or 125%
-- This makes everything larger
-
-### Option 2: Different Paper Size
-- Try "Tabloid" (11x17)
-- Gives more space for panels
-
-### Option 3: Margins
-- If "None" cuts off edges
-- Use "Default" or "Narrow"
-
-## Example Settings (Chrome)
-
-1. Destination: **Save as PDF**
-2. Pages: **All**
-3. Layout: **Landscape**
-4. Paper size: **A4**
-5. Pages per sheet: **1**
-6. Margins: **None**
-7. Scale: **Default**
-8. Options:
-   - ✓ Background graphics
-   - ✓ Selection only (unchecked)
-   - ✓ Headers and footers (unchecked)
-
-## Result
-
-Your PDF should now have:
-- Full-page comic panels
-- No wasted white space
-- Proper 2x2 grid layout
-- All text and bubbles visible
-- Professional appearance
-
-Each comic page becomes one PDF page at maximum size!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

PRINT_GUIDE_800x1080.md

@@ -1,140 +1,12 @@
-# 🖨️ Printing Comic Pages at 800x1080 Resolution
-
-## Quick Answer
-
-To print Page 1 (or any page) at exactly 800x1080:
-
-### Recommended Print Settings:
-1. **Paper Size**: **A5** (148 x 210mm) or **Custom 5.33" x 7.2"**
-2. **Orientation**: **Portrait**
-3. **Margins**: **None** (0)
-4. **Scale**: **100%** or **Actual size**
-5. **Background Graphics**: **Enabled**
-
-## Detailed Instructions
-
-### Method 1: Print to Physical Printer
-
-1. Open the page (e.g., `page_001.html`)
-2. Click **"📥 Download as Image"** button
-3. In the print dialog:
-   - **Destination**: Select your printer
-   - **Paper Size**: Choose **A5** (closest standard size)
-   - **Margins**: Set to **None**
-   - **Scale**: Keep at **100%**
-4. Click **Print**
-
-### Method 2: Save as PDF (Digital 800x1080)
-
-1. Open the page
-2. Click **"📥 Download as Image"**
-3. In the print dialog:
-   - **Destination**: **Save as PDF**
-   - **Paper Size**: **A5** or **Custom**
-   - **Margins**: **None**
-   - **Scale**: **100%**
-4. Click **Save**
-
-## Paper Size Options
-
-### Best Matches for 800x1080 pixels:
-
-| Paper Size | Dimensions | Notes |
-|------------|------------|-------|
-| **Custom** | 5.33" × 7.2" | Exact match at 150 DPI |
-| **A5** | 5.83" × 8.27" | Closest standard size |
-| **Half Letter** | 5.5" × 8.5" | US standard, slightly larger |
-
-### At Different DPI Settings:
-
-- **96 DPI**: 8.33" × 11.25" (screen resolution)
-- **150 DPI**: 5.33" × 7.2" (recommended for print)
-- **300 DPI**: 2.67" × 3.6" (high quality, but small)
-
-## Browser-Specific Settings
-
-### Chrome/Edge:
-```
-1. Destination: Your printer or "Save as PDF"
-2. Pages: All
-3. Layout: Portrait
-4. Paper size: A5
-5. Margins: None
-6. Scale: Default (100%)
-7. Options: ✓ Background graphics
-```
-
-### Firefox:
-```
-1. Destination: Your printer or "Save as PDF"
-2. Orientation: Portrait
-3. Paper Size: A5
-4. Margins: None
-5. Scale: 100%
-6. Print backgrounds: ✓ Enabled
-```
-
-### Safari:
-```
-1. Paper Size: A5
-2. Orientation: Portrait
-3. Scale: 100%
-4. Print backgrounds: ✓ Enabled
-```
-
-## Why These Settings?
-
-- **800×1080 pixels** = 8.33:11.25 ratio
-- **A5 paper** (148×210mm) ≈ 5.83×8.27 inches
-- **Aspect ratio** is very close (1:1.35 vs 1:1.42)
-- **No margins** ensures full use of paper
-- **100% scale** maintains pixel accuracy
-
-## Common Issues & Solutions
-
-### Issue: Page appears too small
-**Solution**: 
-- Check Scale is set to 100% (not "Fit to page")
-- Try Custom paper size: 5.33" × 7.2"
-
-### Issue: Page is cut off
-**Solution**:
-- Set Margins to "None"
-- Reduce Scale to 95%
-- Use A5 paper size
-
-### Issue: Multiple pages print
-**Solution**:
-- Ensure "Pages per sheet" = 1
-- Check page range is correct
-
-### Issue: Colors don't print
-**Solution**:
-- Enable "Background graphics"
-- Check printer color settings
-
-## Physical Print Sizes
-
-When printed, your 800×1080 comic page will be approximately:
-
-- **A5 Paper**: 5.8" × 8.3" (148mm × 210mm)
-- **Half Letter**: 5.5" × 8.5" (140mm × 216mm)
-- **Custom Exact**: 5.33" × 7.2" (135mm × 183mm)
-
-## Tips for Best Results
-
-1. **Preview First**: Always use Print Preview
-2. **Test Page**: Print page 1 first to check settings
-3. **Paper Type**: Use matte photo paper for best quality
-4. **Color Mode**: Set printer to "Best" quality
-5. **Save Settings**: Save your print preset for future use
-
-## Example: Printing All 12 Pages
-
-1. Open page gallery (`index.html`)
-2. Click "📂 Open All Pages"
-3. In each tab, press Ctrl+P (Cmd+P on Mac)
-4. Use same settings for each page
-5. Print or save as PDF
-
-Your comic pages will print at the correct 800×1080 resolution!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

README_2K_PANELS.md

@@ -1,142 +1,12 @@
-# 📐 2K Resolution Limit & Panel Export Feature
-
-## 🎯 What's New
-
-### 1. **2K Resolution Limit**
-- All enhanced images are now capped at **2K resolution (2048x1080)**
-- This applies to all AI models:
-  - Real-ESRGAN
-  - SwinIR  
-  - Lightweight enhancers
-  - Traditional upscaling
-- Benefits:
-  - Faster processing
-  - Lower memory usage
-  - More reasonable file sizes
-  - Still high quality for web viewing
-
-### 2. **Individual Panel Export (640x800)**
-- After comic generation, all panels are automatically extracted
-- Each panel is saved as a separate image file
-- Fixed size: **640x800 pixels** (portrait orientation)
-- Perfect for:
-  - Social media posts
-  - Mobile wallpapers
-  - Print postcards
-  - Digital collections
-
-## 📁 Output Structure
-
-After generating a comic, you'll find:
-
-```
-output/
-├── page.html           # Full comic viewer
-├── pages.json          # Comic data
-├── smart_comic_viewer.html  # Smart comic (if enabled)
-└── panels/             # NEW: Individual panels
-    ├── panel_001_p1_1.jpg  # Panel 1 from page 1
-    ├── panel_002_p1_2.jpg  # Panel 2 from page 1
-    ├── panel_003_p2_1.jpg  # Panel 1 from page 2
-    ├── ...
-    └── panel_viewer.html   # Gallery view of all panels
-```
-
-## 🚀 How It Works
-
-1. **During Enhancement**:
-   - Images are enhanced using AI models
-   - Resolution is capped at 2K (2048x1080)
-   - Original aspect ratio is preserved
-
-2. **During Panel Extraction**:
-   - Each panel from the comic is extracted
-   - Speech bubbles are rendered onto the panels
-   - Images are resized to fit 640x800
-   - White padding added if needed to maintain aspect ratio
-   - Saved as high-quality JPEG (95% quality)
-
-## 📸 Panel Features
-
-- **Consistent Size**: All panels are exactly 640x800 pixels
-- **Speech Bubbles Included**: Text is rendered directly on the image
-- **High Quality**: JPEG compression at 95% quality
-- **Numbered Naming**: Easy to identify which page/panel
-- **White Background**: Clean presentation with padding
-
-## 🌐 Viewing Options
-
-### 1. **Panel Gallery**
-Navigate to: `http://localhost:5000/panels`
-- Grid view of all extracted panels
-- Hover to enlarge
-- Shows panel numbers
-
-### 2. **Direct Access**
-Panels are available at: `http://localhost:5000/output/panels/panel_XXX_pY_Z.jpg`
-- XXX = Panel number (001, 002, etc.)
-- Y = Page number
-- Z = Panel position on page
-
-### 3. **File System**
-All panels saved in: `output/panels/`
-- Ready for bulk download
-- Easy to share or print
-
-## 💡 Use Cases
-
-1. **Social Media Content**:
-   - Post individual panels on Instagram
-   - Create story sequences
-   - Share highlights
-
-2. **Print Products**:
-   - Comic postcards
-   - Mini posters
-   - Collectible cards
-
-3. **Digital Assets**:
-   - Mobile wallpapers
-   - Profile pictures
-   - NFT collections
-
-4. **Portfolio**:
-   - Showcase individual scenes
-   - Create galleries
-   - Present work samples
-
-## ⚙️ Technical Details
-
-### Resolution Changes:
-```python
-# Before: 4x upscaling (could reach 8K)
-target_width = width * 4
-target_height = height * 4
-
-# Now: Max 2K with smart scaling
-scale_factor = min(2048 / width, 1080 / height, 2.0)
-target_width = int(width * scale_factor)
-target_height = int(height * scale_factor)
-```
-
-### Panel Export:
-```python
-# Fixed panel dimensions
-panel_size = (640, 800)  # Width x Height
-
-# Maintains aspect ratio
-# Adds white padding if needed
-# Includes rendered speech bubbles
-```
-
-## 🎨 Example Results
-
-**Input**: 1920x1080 video frame
-**Enhanced**: 2048x1080 (2K limit applied)
-**Panel Export**: 640x800 with speech bubbles
-
-The system now provides both:
-- Full comic pages for reading
-- Individual panels for sharing
-
-Perfect balance between quality and practicality!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

README_AI_MODELS.md

@@ -1,226 +1,12 @@
-# 🚀 AI Model Integration for Comic Enhancement
-
-**State-of-the-Art Image Enhancement with Real-ESRGAN, GFPGAN, and More**
-
-This branch now includes cutting-edge AI models for superior image quality, optimized for NVIDIA RTX 3050 GPUs.
-
-## 🎯 Key Features
-
-### **AI Models Integrated:**
-
-1. **Real-ESRGAN** (Real-Enhanced Super-Resolution GAN)
-   - 4x upscaling with exceptional quality
-   - Handles real-world degradation (noise, compression, blur)
-   - Two models included:
-     - `RealESRGAN_x4plus`: General purpose, best for photos
-     - `RealESRGAN_x4plus_anime_6B`: Optimized for anime/comic art
-
-2. **GFPGAN** (Generative Facial Prior GAN)
-   - State-of-the-art face restoration
-   - Enhances facial details and features
-   - Removes artifacts and improves skin texture
-   - Version 1.3 with improved quality
-
-3. **Intelligent Model Selection**
-   - Automatic detection of anime/comic style content
-   - Smart switching between general and anime models
-   - Fallback to traditional methods if AI fails
-
-## 🛠️ Installation
-
-### **Quick Install:**
-```bash
-# Run the installation script
-./install_ai_models.sh
-```
-
-### **Manual Install:**
-```bash
-# Create virtual environment
-python3 -m venv venv_ai
-source venv_ai/bin/activate
-
-# Install PyTorch with CUDA 11.8 (for RTX 3050)
-pip install torch==2.1.0+cu118 torchvision==0.16.0+cu118 --index-url https://download.pytorch.org/whl/cu118
-
-# Install AI model requirements
-pip install -r requirements_ai_models.txt
-```
-
-## 🚀 Usage
-
-### **1. In Your Application:**
-```python
-from backend.advanced_image_enhancer import AdvancedImageEnhancer
-
-# Enable AI models
-os.environ['USE_AI_MODELS'] = '1'
-os.environ['ENHANCE_FACES'] = '1'
-
-# Create enhancer
-enhancer = AdvancedImageEnhancer()
-
-# Enhance image
-result = enhancer.enhance_image('input.jpg', 'output.jpg')
-```
-
-### **2. Direct Model Usage:**
-```python
-from backend.ai_model_manager import get_ai_model_manager
-
-# Get model manager
-manager = get_ai_model_manager()
-
-# Enhance with Real-ESRGAN
-enhanced = manager.enhance_image_realesrgan(image)
-
-# Enhance faces with GFPGAN
-face_enhanced = manager.enhance_face_gfpgan(enhanced)
-
-# Complete pipeline
-result = manager.enhance_image_pipeline(
-    'input.jpg',
-    'output.jpg',
-    enhance_face=True,
-    use_anime_model=False
-)
-```
-
-### **3. Environment Variables:**
-```bash
-# Enable/disable AI models
-export USE_AI_MODELS=1      # Use AI models (default: 1)
-export ENHANCE_FACES=1      # Enhance faces with GFPGAN (default: 1)
-
-# GPU settings
-export CUDA_VISIBLE_DEVICES=0  # Use first GPU
-```
-
-## 🎮 RTX 3050 Optimization
-
-The implementation is specifically optimized for RTX 3050:
-
-### **Memory Management:**
-- **Tile Processing**: Images processed in 256x256 tiles to fit in 4GB/8GB VRAM
-- **FP16 Precision**: Uses half-precision for 2x memory savings
-- **Memory Limit**: Capped at 80% VRAM usage to prevent OOM
-- **Auto Cleanup**: Clears GPU memory after each batch
-
-### **Performance Tips:**
-```python
-# RTX 3050 optimal settings
-torch.backends.cudnn.benchmark = True
-torch.backends.cuda.matmul.allow_tf32 = True
-torch.cuda.set_per_process_memory_fraction(0.8)
-```
-
-## 📊 Performance Benchmarks
-
-### **On RTX 3050 (8GB):**
-| Operation | Input Size | Output Size | Time | VRAM Used |
-|-----------|------------|-------------|------|-----------|
-| Real-ESRGAN 4x | 512x512 | 2048x2048 | ~2s | ~2GB |
-| GFPGAN Face | 512x512 | 1024x1024 | ~1s | ~1.5GB |
-| Full Pipeline | 512x512 | 2048x2048 | ~3s | ~3GB |
-
-### **Quality Improvements:**
-- **Resolution**: 4x increase (e.g., 512x512 → 2048x2048)
-- **Noise Reduction**: 90% improvement
-- **Face Quality**: 95% accuracy in face restoration
-- **Detail Preservation**: 85% better than traditional methods
-
-## 🧪 Testing
-
-### **Run Test Suite:**
-```bash
-# Activate environment
-source venv_ai/bin/activate
-
-# Run tests
-python test_ai_models.py
-```
-
-### **Test Outputs:**
-- System information and GPU details
-- Model loading verification
-- Enhancement pipeline testing
-- Memory usage analysis
-- Performance benchmarks
-
-## 🔧 Troubleshooting
-
-### **Common Issues:**
-
-1. **CUDA Out of Memory:**
-   ```python
-   # Reduce tile size
-   self.realesrgan = RealESRGANer(
-       tile=128,  # Smaller tiles for 4GB cards
-       tile_pad=10
-   )
-   ```
-
-2. **Model Download Fails:**
-   ```bash
-   # Manual download
-   cd models
-   wget https://github.com/xinntao/Real-ESRGAN/releases/download/v0.1.0/RealESRGAN_x4plus.pth
-   ```
-
-3. **Slow Performance:**
-   - Ensure CUDA is properly installed
-   - Check GPU utilization with `nvidia-smi`
-   - Use FP16 mode for faster inference
-
-## 📈 Model Comparison
-
-### **Upscaling Models:**
-| Model | Best For | Quality | Speed | VRAM |
-|-------|----------|---------|-------|------|
-| Real-ESRGAN x4plus | Photos, realistic | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | 2GB |
-| Real-ESRGAN Anime | Anime, comics | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 1.5GB |
-| LANCZOS4 (fallback) | Any | ��⭐ | ⭐⭐⭐⭐⭐ | 0GB |
-
-### **Face Enhancement:**
-| Model | Quality | Speed | Features |
-|-------|---------|-------|----------|
-| GFPGAN v1.3 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | Face restoration, detail enhancement |
-| OpenCV DNN | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | Basic face detection only |
-
-## 🚀 Future Enhancements
-
-### **Planned Models:**
-1. **SwinIR**: Transformer-based super resolution
-2. **CodeFormer**: Latest face restoration
-3. **ControlNet**: Guided image generation
-4. **Stable Diffusion**: AI-powered inpainting
-
-### **Optimizations:**
-- TensorRT acceleration for 2x speedup
-- ONNX model conversion
-- Dynamic batching for multiple images
-- Streaming processing for video
-
-## 📝 API Reference
-
-### **AIModelManager Class:**
-```python
-class AIModelManager:
-    def __init__(self, device=None, model_dir='models')
-    def load_realesrgan(model_name='RealESRGAN_x4plus', scale=4)
-    def load_gfpgan()
-    def enhance_image_realesrgan(image, use_anime_model=False)
-    def enhance_face_gfpgan(image, only_center_face=False, paste_back=True)
-    def enhance_image_pipeline(image_path, output_path, enhance_face=True, use_anime_model=False)
-    def clear_memory()
-```
-
-### **Environment Variables:**
-- `USE_AI_MODELS`: Enable/disable AI models (default: '1')
-- `ENHANCE_FACES`: Enable/disable face enhancement (default: '1')
-- `CUDA_VISIBLE_DEVICES`: GPU device selection
-- `AI_MODEL_DIR`: Model storage directory (default: 'models')
-
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
 ---
 
-**🎨 Transform your images with state-of-the-art AI models!**
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

README_COLOR_PRESERVATION.md

@@ -1,111 +1,12 @@
-# 🎨 Color Preservation & Story-Based Comic Generation
-
-## 🎯 Issues Fixed
-
-### 1. **Color Loss Problem**
-The comic styling was too aggressive, turning images green/monochrome.
-
-**Solution**:
-- Added `preserve_colors` mode to maintain original colors
-- Increased color palette from 8-16 to 32 colors
-- Blend original image with stylized version (40/60 ratio)
-- Option to skip comic styling completely
-
-### 2. **2K Resolution Enforcement**
-All enhancers now properly limit output to 2048x1080 maximum:
-- Ultra Compact Enhancer: Scale reduced from 4x to 2x
-- Lightweight AI Enhancer: Added 2K limit checks
-- Compact AI Models: Updated fallback upscaling
-- CPU fallback: Respects 2K limit
-
-### 3. **Story-Based Panel Selection**
-The system now automatically:
-- Analyzes all subtitles for story importance
-- Selects 10-15 most meaningful moments
-- Creates adaptive layouts based on panel count
-- Generates frames only for selected moments
-
-## 🎨 Color Preservation Settings
-
-In `app_enhanced.py`, the comic generator now has:
-```python
-self.apply_comic_style = True    # Set to False to skip comic styling
-self.preserve_colors = True      # Preserve original colors when styling
-```
-
-### Comic Styling Modes:
-
-1. **Full Comic Style** (apply_comic_style=True, preserve_colors=False):
-   - Traditional comic look
-   - Limited color palette
-   - Strong edges and quantization
-
-2. **Color-Preserved Comic** (apply_comic_style=True, preserve_colors=True):
-   - Maintains original colors
-   - Subtle comic effects
-   - 32-color palette
-   - Blends with original image
-
-3. **No Comic Style** (apply_comic_style=False):
-   - Keeps enhanced images as-is
-   - No color quantization
-   - No edge effects
-   - Pure photorealistic
-
-## 📊 Automatic Story Adjustment
-
-The system now:
-1. **Analyzes Story Structure**:
-   - Introduction (first 10%)
-   - Development (20-50%)
-   - Climax (50-80%)
-   - Resolution (last 20%)
-
-2. **Scores Each Moment**:
-   - Length of dialogue
-   - Emotional keywords
-   - Action words
-   - Story position
-   - Punctuation (!, ?)
-
-3. **Selects Key Frames**:
-   - Guarantees intro and conclusion
-   - Picks high-scoring middle moments
-   - Maintains minimum spacing
-   - Targets 10-15 total panels
-
-4. **Adaptive Layout**:
-   - 1-6 panels: Single page
-   - 7-9 panels: 3x3 grid
-   - 10-12 panels: Two pages
-   - 13+ panels: Multiple pages
-
-## 🚀 Usage
-
-### To Preserve Colors:
-```python
-# In app_enhanced.py __init__:
-self.preserve_colors = True  # Default setting
-```
-
-### To Skip Comic Styling:
-```python
-# In app_enhanced.py __init__:
-self.apply_comic_style = False
-```
-
-### Output Examples:
-- **With Color Preservation**: Natural colors with subtle comic effects
-- **Without Preservation**: Traditional comic book appearance
-- **No Styling**: Clean, enhanced photos
-
-## 📸 Results
-
-Now your comics will:
-- ✅ Maintain vibrant original colors
-- ✅ Show 10-15 key story moments
-- ✅ Have adaptive layouts
-- ✅ Process at 2K resolution max
-- ✅ Export as 640x800 panels
-
-The green color issue is fixed, and the system automatically creates full story comics!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

README_ENHANCED.md

@@ -1,354 +1,12 @@
-# 🎨 Enhanced Comic Generator
-
-**AI-Powered High-Quality Comic Generation from Videos**
-
-A completely rewritten comic generation system that uses advanced AI models and computer vision techniques to create professional-quality comics from video content.
-
-## ✨ Key Features
-
-### 🚀 **AI-Enhanced Processing**
-- **Advanced Face Detection**: MediaPipe + OpenCV DNN for 99%+ accuracy
-- **Smart Bubble Placement**: AI-powered content analysis for optimal positioning
-- **High-Quality Image Enhancement**: Multi-stage processing pipeline
-- **Intelligent Layout Optimization**: Content-aware panel arrangement
-
-### 🎯 **Quality Improvements**
-- **Super Resolution**: AI-powered image upscaling
-- **Advanced Noise Reduction**: Multi-algorithm denoising
-- **Color Enhancement**: AI-optimized color balance and saturation
-- **Edge Preservation**: Smart filtering techniques
-- **Dynamic Range Optimization**: CLAHE for better contrast
-
-### 🎨 **Comic Styling**
-- **Modern Comic Style**: Advanced edge detection + color quantization
-- **Adaptive Color Reduction**: AI-determined optimal color count
-- **Texture Enhancement**: Subtle halftone effects
-- **Multiple Style Options**: Modern, Classic, Manga styles
-
-### 💬 **Smart Speech Bubbles**
-- **Content Analysis**: Salient region detection
-- **Face Avoidance**: Intelligent positioning away from faces
-- **Dialogue Optimization**: Length-aware placement
-- **Collision Prevention**: Advanced overlap detection
-
-## 🏗️ Architecture Overview
-
-```
-Video Input
-    ↓
-┌─────────────────────────────────────┐
-│ 1. Subtitle Extraction (Whisper)    │
-│ 2. Keyframe Generation              │
-│ 3. Black Bar Removal                │
-└─────────────────────────────────────┘
-    ↓
-┌─────────────────────────────────────┐
-│ 4. AI Image Enhancement             │
-│    • Super Resolution               │
-│    • Noise Reduction                │
-│    • Color Enhancement              │
-│    • Sharpness Improvement          │
-└─────────────────────────────────────┘
-    ↓
-┌─────────────────────────────────────┐
-│ 5. Comic Styling                    │
-│    • Edge Detection                 │
-│    • Color Quantization             │
-│    • Texture Addition               │
-└─────────────────────────────────────┘
-    ↓
-┌─────────────────────────────────────┐
-│ 6. AI Layout Optimization           │
-│    • Content Analysis               │
-│    • Panel Arrangement              │
-│    • 2x2 Grid Layout                │
-└─────────────────────────────────────┘
-    ↓
-┌─────────────────────────────────────┐
-│ 7. Smart Bubble Placement           │
-│    • Face Detection                 │
-│    • Content Analysis               │
-│    • Position Scoring               │
-└─────────────────────────────────────┘
-    ↓
-┌─────────────────────────────────────┐
-│ 8. Final Page Generation            │
-│    • JSON Output                    │
-│    • HTML Template                  │
-└─────────────────────────────────────┘
-```
-
-## 🛠️ Installation
-
-### Prerequisites
-- Python 3.8+
-- CUDA-compatible GPU (optional, for acceleration)
-
-### Setup
-```bash
-# Clone the repository
-git clone <repository-url>
-cd comic-generator
-
-# Install enhanced requirements
-pip install -r requirements_enhanced.txt
-
-# For GPU acceleration (optional)
-pip install torch torchvision --index-url https://download.pytorch.org/whl/cu118
-```
-
-## 🚀 Usage
-
-### Basic Usage
-```bash
-# Run the enhanced application
-python app_enhanced.py
-```
-
-### Environment Variables
-```bash
-# Enable AI enhancement (default: 1)
-export AI_ENHANCED=1
-
-# Enable high-quality processing (default: 1)
-export HIGH_QUALITY=1
-
-# Use GPU acceleration (if available)
-export CUDA_VISIBLE_DEVICES=0
-```
-
-### Web Interface
-1. Open `http://localhost:5000`
-2. Upload a video file or provide a YouTube link
-3. Wait for AI processing (typically 2-5 minutes)
-4. View the generated comic in your browser
-
-## 🔧 Technical Details
-
-### AI Models Used
-
-#### **Face Detection**
-- **Primary**: MediaPipe Face Mesh (468 landmarks)
-- **Fallback**: OpenCV DNN (YuNet model)
-- **Accuracy**: 99%+ face detection rate
-- **Features**: Lip position, face orientation, confidence scoring
-
-#### **Image Enhancement**
-- **Super Resolution**: Advanced upscaling with LANCZOS
-- **Noise Reduction**: Bilateral + Non-local means + Wiener filtering
-- **Color Enhancement**: LAB color space optimization
-- **Sharpness**: Unsharp mask + edge enhancement
-
-#### **Content Analysis**
-- **Salient Regions**: Spectral residual saliency detection
-- **Empty Areas**: Variance-based region detection
-- **Edge Analysis**: Multi-scale Canny edge detection
-- **Complexity Assessment**: Entropy-based image analysis
-
-#### **Bubble Placement**
-- **Candidate Generation**: Corner, edge, empty area positions
-- **Scoring System**: Multi-factor evaluation (face avoidance, content, dialogue)
-- **Position Optimization**: Gradient-based adjustment
-- **Collision Prevention**: Rectangle overlap detection
-
-### Quality Improvements
-
-#### **Image Quality**
-- **Resolution**: Up to 4x upscaling for small images
-- **Color Depth**: 24-32 colors (adaptive based on complexity)
-- **Noise Reduction**: 3-stage filtering pipeline
-- **Sharpness**: Advanced edge preservation
-
-#### **Comic Styling**
-- **Edge Detection**: Multi-scale Canny + morphological operations
-- **Color Quantization**: K-means clustering with optimal K selection
-- **Smoothing**: Edge-preserving bilateral filtering
-- **Texture**: Subtle halftone pattern addition
-
-#### **Layout Optimization**
-- **2x2 Grid**: Consistent panel arrangement
-- **Content Analysis**: Face count, complexity, action detection
-- **Panel Prioritization**: High-priority content placement
-- **Responsive Design**: Adaptive to content characteristics
-
-## 📊 Performance Metrics
-
-### **Accuracy Improvements**
-- **Face Detection**: 99% (vs 85% with dlib)
-- **Bubble Placement**: 95% accuracy (vs 70% with old system)
-- **Image Quality**: 4x improvement in resolution and clarity
-- **Processing Speed**: 2-3x faster with GPU acceleration
-
-### **Quality Metrics**
-- **Color Fidelity**: 95% preservation
-- **Edge Preservation**: 90% accuracy
-- **Noise Reduction**: 80% improvement
-- **Overall Quality**: 4.5/5 user rating
-
-## 🔍 How It Works
-
-### **1. Video Processing Pipeline**
-```
-Video → Keyframes → Enhancement → Styling → Layout → Bubbles → Output
-```
-
-### **2. AI Face Detection**
-1. **MediaPipe Processing**: 468-point facial landmarks
-2. **Lip Position**: Precise lip center calculation
-3. **Face Orientation**: Eye angle calculation
-4. **Confidence Scoring**: Quality assessment
-
-### **3. Smart Bubble Placement**
-1. **Content Analysis**: Detect salient regions, empty areas, busy areas
-2. **Candidate Generation**: Generate position candidates
-3. **Scoring**: Multi-factor evaluation
-4. **Optimization**: Select best position with adjustments
-
-### **4. Image Enhancement**
-1. **Super Resolution**: Upscale small images
-2. **Noise Reduction**: Multi-algorithm filtering
-3. **Color Enhancement**: LAB space optimization
-4. **Sharpness**: Edge-preserving enhancement
-
-## 🎯 Use Cases
-
-### **Content Creators**
-- Convert YouTube videos to comics
-- Create educational content
-- Generate social media content
-
-### **Educators**
-- Visual learning materials
-- Story-based teaching
-- Interactive content
-
-### **Entertainment**
-- Movie scene comics
-- TV show highlights
-- Personal video memories
-
-## 🔧 Configuration
-
-### **Quality Settings**
-```python
-# High quality mode
-HIGH_QUALITY=1  # Enable all enhancements
-
-# AI enhancement mode
-AI_ENHANCED=1   # Use AI models
-
-# GPU acceleration
-CUDA_VISIBLE_DEVICES=0  # Use GPU 0
-```
-
-### **Customization**
-```python
-# Adjust bubble placement parameters
-BUBBLE_WIDTH=200
-BUBBLE_HEIGHT=94
-MIN_DISTANCE_FROM_FACE=80
-
-# Modify image enhancement
-SUPER_RESOLUTION_FACTOR=2
-NOISE_REDUCTION_STRENGTH=0.8
-COLOR_ENHANCEMENT_FACTOR=1.2
-```
-
-## 🐛 Troubleshooting
-
-### **Common Issues**
-
-#### **Face Detection Fails**
-```bash
-# Check MediaPipe installation
-pip install mediapipe==0.10.7
-
-# Verify camera permissions
-# Ensure good lighting in video
-```
-
-#### **Low Quality Output**
-```bash
-# Enable high-quality mode
-export HIGH_QUALITY=1
-
-# Check GPU availability
-nvidia-smi
-
-# Increase processing time
-export AI_ENHANCED=1
-```
-
-#### **Slow Processing**
-```bash
-# Use GPU acceleration
-pip install torch torchvision --index-url https://download.pytorch.org/whl/cu118
-
-# Reduce quality for speed
-export HIGH_QUALITY=0
-```
-
-## 📈 Future Enhancements
-
-### **Planned Features**
-- **Style Transfer**: Neural style transfer for custom comic styles
-- **Voice Recognition**: Automatic dialogue extraction
-- **Multi-language Support**: International subtitle processing
-- **Batch Processing**: Multiple video processing
-- **Cloud Integration**: AWS/Google Cloud deployment
-
-### **AI Model Upgrades**
-- **Better Face Detection**: YOLO-based detection
-- **Emotion Recognition**: Facial expression analysis
-- **Scene Understanding**: Deep learning scene classification
-- **Text Recognition**: OCR for existing text
-
-## 🤝 Contributing
-
-### **Development Setup**
-```bash
-# Clone repository
-git clone <repository-url>
-cd comic-generator
-
-# Install development dependencies
-pip install -r requirements_enhanced.txt
-pip install pytest black flake8
-
-# Run tests
-pytest tests/
-
-# Format code
-black backend/
-```
-
-### **Code Structure**
-```
-comic-generator/
-├── app_enhanced.py              # Main application
-├── backend/
-│   ├── ai_enhanced_core.py      # AI core system
-│   ├── ai_bubble_placement.py   # Smart bubble placement
-│   ├── speech_bubble/           # Legacy bubble system
-│   ├── panel_layout/            # Layout generation
-│   └── utils.py                 # Utilities
-├── templates/                   # HTML templates
-├── static/                      # CSS/JS files
-└── output/                      # Generated comics
-```
-
-## 📄 License
-
-This project is licensed under the MIT License - see the LICENSE file for details.
-
-## 🙏 Acknowledgments
-
-- **MediaPipe**: Advanced face detection
-- **OpenCV**: Computer vision algorithms
-- **PyTorch**: Deep learning framework
-- **Transformers**: NLP models
-- **Pillow**: Image processing
-
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
 ---
 
-**🎨 Create amazing comics with AI-powered quality!**
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

README_FULL_STORY.md

@@ -1,150 +1,12 @@
-# 📚 Full Story Comic Generation (10-15 Panels)
-
-## 🎯 What's New
-
-The comic generator now creates **full story comics** with 10-15 meaningful panels instead of just 4 panels. It intelligently analyzes your video's story and selects the most important moments.
-
-## 🧠 How It Works
-
-### 1. **Story Analysis**
-The system analyzes all subtitles/dialogue to identify:
-- **Introduction**: Character introductions, scene setting
-- **Conflict**: Problems, challenges, "but/however" moments  
-- **Action**: Movement, battles, escapes
-- **Emotions**: Joy, sadness, anger, fear
-- **Climax**: Peak moments, critical turning points
-- **Resolution**: Endings, conclusions, peace
-
-### 2. **Smart Panel Selection**
-Instead of taking every frame, it:
-- Scores each subtitle based on story importance
-- Ensures coverage of all story phases
-- Maintains proper spacing between selected moments
-- Targets 10-15 panels for optimal storytelling
-
-### 3. **Adaptive Layout**
-Based on panel count:
-- **≤4 panels**: Single page, 2x2 grid
-- **≤6 panels**: Single page, 2x3 grid  
-- **≤9 panels**: Single page, 3x3 grid
-- **≤12 panels**: Two pages, 2x3 grid each
-- **>12 panels**: Multiple pages with varied layouts
-
-## 📊 Example Story Extraction
-
-**Input Video**: 10-minute dialogue with 200 subtitles
-
-**Smart Extraction Results**:
-1. Opening scene - "Hello, my name is..."
-2. Character meeting - "Nice to meet you"
-3. Problem introduction - "But there's a problem..."
-4. First conflict - "We need to act fast!"
-5. Action sequence - "Run! They're coming!"
-6. Emotional moment - "I'm scared..."
-7. Plan formation - "Here's what we'll do"
-8. Climax buildup - "This is our only chance"
-9. Peak action - "Now! Do it now!"
-10. Resolution - "We did it!"
-11. Emotional resolution - "I'm so happy"
-12. Closing - "Thank you, goodbye"
-
-## 🚀 Usage
-
-The system now automatically:
-
-1. **Analyzes Story Structure**
-   - Reads all subtitles
-   - Scores each moment
-   - Identifies key story beats
-
-2. **Selects Meaningful Frames**
-   - Picks 10-15 most important moments
-   - Ensures story flow
-   - Avoids repetitive content
-
-3. **Generates Adaptive Layout**
-   - Creates appropriate page layout
-   - Distributes panels evenly
-   - Maintains visual balance
-
-## 📈 Benefits
-
-### Before (4 Panel System):
-- ❌ Missed important story moments
-- ❌ Abrupt story jumps
-- ❌ Limited narrative depth
-- ❌ Fixed 2x2 layout only
-
-### Now (10-15 Panel System):
-- ✅ Complete story arc
-- ✅ Smooth narrative flow
-- ✅ All key moments captured
-- ✅ Flexible adaptive layouts
-- ✅ Better character development
-- ✅ Emotional journey preserved
-
-## 🎨 Layout Examples
-
-### 6 Panel Layout (2x3)
-```
-[Panel 1] [Panel 2] [Panel 3]
-[Panel 4] [Panel 5] [Panel 6]
-```
-
-### 9 Panel Layout (3x3)
-```
-[Panel 1] [Panel 2] [Panel 3]
-[Panel 4] [Panel 5] [Panel 6]
-[Panel 7] [Panel 8] [Panel 9]
-```
-
-### 12 Panel Layout (2 pages, 2x3 each)
-```
-Page 1:
-[Panel 1] [Panel 2] [Panel 3]
-[Panel 4] [Panel 5] [Panel 6]
-
-Page 2:
-[Panel 7] [Panel 8] [Panel 9]
-[Panel 10][Panel 11][Panel 12]
-```
-
-## 🔧 Technical Details
-
-### Story Scoring Algorithm:
-- **Length**: Longer dialogues = higher importance
-- **Position**: Intro/ending get bonus points
-- **Keywords**: Action/emotion words boost score
-- **Punctuation**: Questions/exclamations = important
-- **Character Names**: Dialogue with names prioritized
-
-### Frame Selection:
-- Minimum spacing between panels
-- Guaranteed intro and conclusion
-- Even distribution across story
-- Fallback to even sampling if needed
-
-## 💡 Tips for Best Results
-
-1. **Good Audio**: Clear dialogue improves subtitle extraction
-2. **Story Videos**: Works best with narrative content
-3. **Dialogue Heavy**: More dialogue = better story extraction
-4. **Emotional Variety**: Videos with varied emotions work great
-
-## 🎯 Result
-
-You get a complete comic that tells the full story in 10-15 well-chosen panels, maintaining narrative flow while keeping it concise and engaging!
-
-### Output Structure:
-```
-output/
-├── page.html           # Full comic with all panels
-├── pages.json          # Comic data
-├── panels/            # Individual 640x800 panels
-│   ├── panel_001_p1_1.jpg
-│   ├── panel_002_p1_2.jpg
-│   └── ...
-└── smart_comic_viewer.html  # If smart mode enabled
-```
-
-The system now creates comics that truly capture the essence of your video's story!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

README_LIGHTWEIGHT_AI.md

@@ -1,231 +1,12 @@
-# 🚀 Lightweight AI Enhancement for RTX 3050 Laptop GPU
-
-**High-Quality Image Enhancement for GPUs with <4GB VRAM**
-
-This implementation provides state-of-the-art image enhancement optimized for RTX 3050 Laptop GPUs and other cards with limited VRAM.
-
-## 🎯 Key Features
-
-### **Optimized for Limited VRAM:**
-- **Memory Efficient**: Uses only 1-2GB VRAM for 4x upscaling
-- **Tile Processing**: Processes images in 256x256 tiles
-- **FP16 Precision**: Half-precision computations for 2x memory savings
-- **Smart Fallback**: Gracefully handles OOM with CPU fallback
-
-### **Quality Enhancement:**
-- **4x Super Resolution**: AI-enhanced upscaling with excellent quality
-- **Face Enhancement**: Specialized face improvement without heavy models
-- **Color Correction**: Advanced LAB color space processing
-- **Noise Reduction**: Multi-stage denoising pipeline
-
-### **Performance:**
-- **Fast Processing**: ~2-3 seconds for 512x512 → 2048x2048
-- **Batch Support**: Process multiple images efficiently
-- **GPU Acceleration**: Optimized for RTX 3050/3060 laptop GPUs
-- **Low Overhead**: Minimal memory footprint
-
-## 🛠️ Installation
-
-### **Quick Install (Recommended):**
-```bash
-# Run the lightweight installation script
-chmod +x install_lightweight.sh
-./install_lightweight.sh
-```
-
-### **Manual Install:**
-```bash
-# Create virtual environment
-python3 -m venv venv_lightweight
-source venv_lightweight/bin/activate
-
-# Install PyTorch (lightweight)
-pip install torch==2.1.0 torchvision==0.16.0 --index-url https://download.pytorch.org/whl/cu118
-
-# Install minimal requirements
-pip install Flask==2.3.3 Pillow==10.0.1 opencv-python==4.8.1.78
-pip install numpy==1.24.3 tqdm==4.66.1 scipy==1.11.3
-```
-
-## 🚀 Usage
-
-### **1. Basic Usage:**
-```python
-from backend.lightweight_ai_enhancer import get_lightweight_enhancer
-
-# Get enhancer instance
-enhancer = get_lightweight_enhancer()
-
-# Enhance single image
-result = enhancer.enhance_image_pipeline('input.jpg', 'output.jpg')
-```
-
-### **2. With Advanced Image Enhancer:**
-```python
-from backend.advanced_image_enhancer import AdvancedImageEnhancer
-
-# Automatically detects <4GB VRAM and uses lightweight mode
-enhancer = AdvancedImageEnhancer()
-
-# Process image
-result = enhancer.enhance_image('input.jpg', 'output.jpg')
-```
-
-### **3. Batch Processing:**
-```python
-# Process multiple images
-images = ['img1.jpg', 'img2.jpg', 'img3.jpg']
-results = enhancer.enhance_batch(images, output_dir='enhanced/')
-```
-
-## 📊 Performance Comparison
-
-### **RTX 3050 Laptop (4GB VRAM):**
-| Method | Input | Output | Time | VRAM | Quality |
-|--------|-------|--------|------|------|---------|
-| Lightweight AI | 512x512 | 2048x2048 | 2.5s | 1.5GB | ⭐⭐⭐⭐ |
-| Traditional | 512x512 | 2048x2048 | 0.5s | 0.2GB | ⭐⭐ |
-| Full Real-ESRGAN | 512x512 | 2048x2048 | OOM | >4GB | ⭐⭐⭐⭐⭐ |
-
-### **Quality Features:**
-- **Resolution**: True 4x upscaling (not just interpolation)
-- **Detail Enhancement**: Recovers fine details and textures
-- **Face Quality**: Specialized face enhancement
-- **Artifact Reduction**: Removes compression artifacts
-- **Color Fidelity**: Preserves and enhances colors
-
-## 🔧 Architecture
-
-### **Lightweight ESRGAN:**
-```python
-# Reduced architecture for low VRAM
-- Feature channels: 32 (vs 64 in full model)
-- Residual blocks: 16 (vs 23 in full model)
-- Tile size: 256x256 with 16px overlap
-- FP16 inference for GPU
-```
-
-### **Memory Management:**
-```python
-# Automatic VRAM optimization
-- Memory fraction: 70% of available VRAM
-- Tile-based processing
-- Automatic garbage collection
-- GPU cache clearing after each batch
-```
-
-### **Processing Pipeline:**
-1. **Input Analysis**: Detect content type and complexity
-2. **Tile Extraction**: Split into overlapping tiles
-3. **AI Enhancement**: Process each tile with neural network
-4. **Tile Merging**: Seamlessly blend enhanced tiles
-5. **Face Enhancement**: Detect and enhance faces
-6. **Color Correction**: Final color and contrast adjustment
-
-## 🎨 Example Results
-
-### **Comic/Manga Enhancement:**
-- Preserves line art quality
-- Enhances text readability
-- Reduces JPEG artifacts
-- Maintains artistic style
-
-### **Photo Enhancement:**
-- Natural detail enhancement
-- Improved face quality
-- Better color vibrancy
-- Reduced noise
-
-## 🐛 Troubleshooting
-
-### **Out of Memory (OOM):**
-```python
-# Reduce tile size
-enhancer.tile_size = 128  # Smaller tiles
-
-# Use CPU fallback
-enhancer.device = torch.device('cpu')
-```
-
-### **Slow Performance:**
-```bash
-# Check GPU utilization
-nvidia-smi
-
-# Ensure CUDA is working
-python -c "import torch; print(torch.cuda.is_available())"
-```
-
-### **Quality Issues:**
-```python
-# Adjust enhancement parameters
-enhancer.use_fp16 = False  # Full precision
-enhancer.tile_size = 384   # Larger tiles
-```
-
-## 📈 Advanced Configuration
-
-### **Environment Variables:**
-```bash
-# Force lightweight mode
-export USE_LIGHTWEIGHT=1
-
-# Adjust memory usage
-export CUDA_MEMORY_FRACTION=0.7
-
-# Disable face enhancement
-export ENHANCE_FACES=0
-```
-
-### **Custom Settings:**
-```python
-enhancer = LightweightEnhancer()
-
-# Adjust for your GPU
-enhancer.tile_size = 384      # For 6GB VRAM
-enhancer.use_fp16 = True      # Memory saving
-enhancer.vram_fraction = 0.8  # Use 80% VRAM
-```
-
-## 🚀 Tips for Best Results
-
-### **For Comics/Manga:**
-1. Use the anime detection feature
-2. Enable edge preservation
-3. Keep original resolution reasonable
-
-### **For Photos:**
-1. Enable face enhancement
-2. Use color correction
-3. Process in good lighting conditions
-
-### **For Speed:**
-1. Use smaller tile sizes
-2. Enable FP16 mode
-3. Process images in batches
-
-## 📝 Technical Details
-
-### **Neural Network Architecture:**
-- Modified RRDB (Residual in Residual Dense Block)
-- Optimized for memory efficiency
-- Trained on diverse image datasets
-- Supports both natural and artistic images
-
-### **Optimizations:**
-- PyTorch JIT compilation
-- CUDA kernel fusion
-- Efficient memory allocation
-- Automatic mixed precision
-
-## 🔮 Future Improvements
-
-1. **Model Compression**: Further reduce model size
-2. **Dynamic Tiling**: Adaptive tile size based on content
-3. **Multi-GPU Support**: Distribute across multiple GPUs
-4. **ONNX Export**: For faster inference
-5. **WebGL Support**: Browser-based enhancement
-
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
 ---
 
-**💡 Perfect for RTX 3050 Laptop GPU users who want AI-quality enhancement without OOM errors!**
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

README_SMART_COMIC.md

@@ -1,114 +1,12 @@
-# 🎭 Smart Comic Generation with Emotion Matching
-
-The Flask app now includes smart comic generation that matches facial expressions with dialogue and creates 10-15 panel story summaries!
-
-## 🚀 How to Use
-
-### 1. Start the Flask App
-```bash
-python app_enhanced.py
-```
-
-### 2. Open in Browser
-Navigate to `http://localhost:5000`
-
-### 3. Upload Video or Paste Link
-- Click the upload button to select a video file
-- OR click the link button to paste a YouTube URL
-
-### 4. Enable Smart Comic Options
-You'll see two checkboxes:
-- **☑️ Smart Mode**: Creates a 10-15 panel summary instead of full comic
-- **☑️ Match facial expressions**: Matches character emotions with dialogue
-
-### 5. Click Submit
-The app will:
-1. Extract audio and generate real subtitles
-2. Analyze the story structure
-3. Identify key moments (intro, conflict, climax, resolution)
-4. Match facial expressions with dialogue emotions
-5. Create a condensed comic with emotion-styled speech bubbles
-
-## 🎨 Features
-
-### Smart Story Summarization
-- Automatically identifies key story moments
-- Reduces hours of video to 10-15 essential panels
-- Maintains narrative flow and coherence
-- Prioritizes emotional peaks and turning points
-
-### Emotion Matching
-- Analyzes facial expressions in each frame
-- Analyzes emotions in dialogue text
-- Finds frames where face matches dialogue mood
-- Styles speech bubbles based on emotion:
-  - 😊 Happy: Green border, bouncing animation
-  - 😢 Sad: Blue border, drooping effect
-  - 😠 Angry: Red jagged border, larger text
-  - 😲 Surprised: Orange burst shape
-  - 😐 Neutral: Standard black border
-
-### Intelligent Panel Selection
-- Always includes introduction and conclusion
-- Finds story turning points (but, however, suddenly)
-- Identifies emotional peaks
-- Detects action moments
-- Ensures even distribution across story
-
-## 📁 Output Files
-
-After generation, you'll find:
-- `output/page.html` - Regular comic (all panels)
-- `output/smart_comic_viewer.html` - Smart comic summary
-- `output/emotion_comic.json` - Comic data with emotion analysis
-
-## 🎯 Example Results
-
-**Input**: 30-minute video with 500+ subtitles
-**Output**: 12-panel comic showing:
-- Opening scene with character introduction
-- First conflict moment
-- Rising tension scenes
-- Climactic confrontation
-- Resolution and ending
-
-Each panel has:
-- Carefully selected frame matching the dialogue emotion
-- Emotion-styled speech bubble
-- Key dialogue that drives the story forward
-
-## 🛠️ Technical Details
-
-The smart comic generation uses:
-- **Facial Expression Analysis**: OpenCV cascades for face/smile detection
-- **Text Emotion Analysis**: Keyword and punctuation analysis
-- **Story Structure Detection**: Identifies narrative phases
-- **Importance Scoring**: Rates each moment's significance
-- **Emotion Matching**: Calculates match scores between face and text
-
-## 💡 Tips
-
-1. **For Best Results**:
-   - Use videos with clear dialogue
-   - Ensure faces are visible in most scenes
-   - Videos with emotional variety work best
-
-2. **Customization**:
-   - Uncheck "Smart Mode" for full comic
-   - Uncheck "Match expressions" for faster processing
-   - Both options can be used independently
-
-3. **Performance**:
-   - Smart mode is faster (fewer panels to process)
-   - Emotion matching adds ~10-15 seconds
-   - Total time: 2-5 minutes for most videos
-
-## 🎉 Benefits
-
-- **Time Saving**: Get the story essence without reading hundreds of panels
-- **Better Storytelling**: Key moments are preserved and highlighted
-- **Emotional Consistency**: Faces match the dialogue mood
-- **Visual Impact**: Emotion styling makes comics more expressive
-- **Automated**: No manual selection or editing needed
-
-The smart comic feature transforms long videos into concise, emotionally-resonant visual stories!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

README_WEB_INTERFACE.md

@@ -1,232 +1,12 @@
-# 🎬 Enhanced Comic Generator - Web Interface
-
-A modern web interface for generating high-quality comics from videos using AI-enhanced processing.
-
-## 🚀 Quick Start
-
-### Method 1: Simple Web Interface (Recommended)
-```bash
-python3 run_web_interface.py
-```
-
-### Method 2: Direct Flask App
-```bash
-python3 app_enhanced.py
-```
-
-### Method 3: Manual Comic Generation
-```bash
-python3 generate_comic_manual.py
-```
-
-## 🌐 Web Interface Features
-
-### **Upload Methods**
-- **📁 File Upload**: Upload MP4 videos directly from your computer
-- **🔗 YouTube Links**: Paste YouTube URLs to download and process videos
-
-### **AI-Enhanced Processing**
-- **🎯 High-Quality Keyframes**: Intelligent frame extraction using PyTorch
-- **✨ Image Enhancement**: Multi-stage quality improvement
-- **🎨 Comic Styling**: Modern comic art transformation
-- **👤 Face Detection**: Advanced face and lip detection
-- **💬 Smart Bubbles**: AI-powered speech bubble placement
-- **📐 Optimized Layout**: 2x2 grid layout with content analysis
-
-## 📋 How to Use the Web Interface
-
-### **Step 1: Start the Server**
-```bash
-python3 run_web_interface.py
-```
-
-### **Step 2: Access the Interface**
-- Open your browser and go to: `http://localhost:5000`
-- The interface will automatically open in your default browser
-
-### **Step 3: Upload Your Video**
-1. **For Local Files**: Click the "Upload Video" button and select an MP4 file
-2. **For YouTube**: Click "Enter Link" and paste a YouTube URL
-
-### **Step 4: Generate Comic**
-- Click the "Submit" button
-- Watch the progress in the terminal
-- The comic will automatically open in your browser when complete
-
-## 🎯 What You Get
-
-### **Output Files**
-- **📄 Comic HTML**: `/output/page.html` - Viewable comic with speech bubbles
-- **🖼️ Enhanced Frames**: `/frames/final/` - High-quality processed images
-- **📊 JSON Data**: `/output/pages.json` - Comic structure data
-
-### **Features**
-- **2x2 Grid Layout**: 4 panels per page in a clean grid
-- **Speech Bubbles**: AI-placed dialogue bubbles avoiding faces
-- **High Quality**: Enhanced images with comic styling
-- **Responsive Design**: Works on desktop and mobile
-
-## 🔧 Technical Details
-
-### **AI Models Used**
-- **Face Detection**: MediaPipe (with OpenCV fallback)
-- **Image Enhancement**: Multi-stage processing pipeline
-- **Layout Optimization**: Content-aware panel arrangement
-- **Bubble Placement**: Salient region analysis
-
-### **Processing Pipeline**
-1. **Video Processing**: Extract keyframes using PyTorch
-2. **Black Bar Removal**: Automatic detection and cropping
-3. **Image Enhancement**: Quality improvement and noise reduction
-4. **Comic Styling**: Artistic transformation
-5. **Face Detection**: Locate faces and lips
-6. **Bubble Placement**: Smart positioning avoiding faces
-7. **Layout Generation**: 2x2 grid with content analysis
-8. **Output Creation**: HTML comic with embedded images
-
-## 🛠️ Installation & Dependencies
-
-### **Required Packages**
-```bash
-pip install flask yt-dlp opencv-python pillow numpy torch torchvision transformers mediapipe scikit-image scipy matplotlib nltk textblob imageio imageio-ffmpeg tqdm requests urllib3 srt --break-system-packages
-```
-
-### **System Requirements**
-- **Python**: 3.8+
-- **Memory**: 4GB+ RAM recommended
-- **Storage**: 2GB+ free space
-- **GPU**: Optional (CUDA support for faster processing)
-
-## 📁 File Structure
-
-```
-comic-generator/
-├── app_enhanced.py              # Main Flask application
-├── run_web_interface.py         # Web interface runner
-├── generate_comic_manual.py     # Direct comic generation
-├── templates/
-│   └── index.html              # Web interface template
-├── static/
-│   ├── styles.css              # CSS styles
-│   ├── script.js               # JavaScript functionality
-│   └── images/                 # Interface images
-├── backend/
-│   ├── ai_enhanced_core.py     # AI processing core
-│   ├── ai_bubble_placement.py  # Smart bubble placement
-│   ├── subtitles/
-│   ├── keyframes/
-│   └── speech_bubble/
-├── video/                      # Uploaded videos
-├── frames/final/               # Processed frames
-└── output/                     # Generated comics
-```
-
-## 🎨 Customization
-
-### **Environment Variables**
-```bash
-export HIGH_QUALITY=1          # Enable high-quality processing
-export AI_ENHANCED=1           # Enable AI features
-export HIGH_ACCURACY=1         # Enable high-accuracy mode
-export GRID_LAYOUT=1           # Force 2x2 grid layout
-```
-
-### **Quality Settings**
-- **Standard**: Faster processing, good quality
-- **High Quality**: Slower processing, excellent quality
-- **AI Enhanced**: Advanced features, best results
-
-## 🐛 Troubleshooting
-
-### **Common Issues**
-
-#### **"Module not found" errors**
-```bash
-pip install [package-name] --break-system-packages
-```
-
-#### **Flask server won't start**
-```bash
-# Check if port 5000 is in use
-lsof -i :5000
-# Kill existing process if needed
-kill -9 [PID]
-```
-
-#### **Video upload fails**
-- Ensure video is MP4 format
-- Check file size (max 100MB recommended)
-- Verify video file is not corrupted
-
-#### **Comic generation fails**
-- Check terminal for error messages
-- Ensure sufficient disk space
-- Verify all dependencies are installed
-
-### **Performance Tips**
-- **GPU Usage**: Install CUDA for faster processing
-- **Memory**: Close other applications during processing
-- **Storage**: Ensure adequate free space
-- **Network**: Stable connection for YouTube downloads
-
-## 📊 Performance Metrics
-
-### **Processing Times** (approximate)
-- **Short Video (30s)**: 2-3 minutes
-- **Medium Video (2min)**: 5-8 minutes
-- **Long Video (5min)**: 10-15 minutes
-
-### **Quality Levels**
-- **Standard**: 720p output, basic enhancement
-- **High Quality**: 1080p output, advanced enhancement
-- **AI Enhanced**: Best quality, smart features
-
-## 🔄 API Endpoints
-
-### **Web Interface**
-- `GET /` - Main interface
-- `POST /uploader` - File upload
-- `POST /handle_link` - YouTube link processing
-- `GET /status` - System status
-- `GET /output/<file>` - Serve output files
-- `GET /frames/final/<file>` - Serve frame files
-
-## 📝 Examples
-
-### **Upload Local Video**
-1. Start server: `python3 run_web_interface.py`
-2. Open browser: `http://localhost:5000`
-3. Click "Upload Video"
-4. Select MP4 file
-5. Click "Submit"
-6. Wait for processing
-7. Comic opens automatically
-
-### **Process YouTube Video**
-1. Start server: `python3 run_web_interface.py`
-2. Open browser: `http://localhost:5000`
-3. Click "Enter Link"
-4. Paste YouTube URL
-5. Click "Submit"
-6. Wait for download and processing
-7. Comic opens automatically
-
-## 🎉 Success!
-
-Your enhanced comic generator web interface is now ready! 
-
-**Key Features:**
-- ✅ Modern web interface
-- ✅ AI-enhanced processing
-- ✅ Smart bubble placement
-- ✅ High-quality output
-- ✅ YouTube support
-- ✅ Automatic browser opening
-
-**Next Steps:**
-1. Run `python3 run_web_interface.py`
-2. Open `http://localhost:5000`
-3. Upload a video or paste a YouTube link
-4. Generate your comic!
-
-Happy comic creating! 🎬✨
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

SAVE_EDITABLE_COMIC_GUIDE.md

@@ -1,163 +1,12 @@
-# 💾 Save Editable Comic - Complete Guide
-
-## Features Added
-
-Your comic editor now has a **"Save Editable Comic"** button that:
-- Downloads the HTML file with all your current edits
-- Preserves text changes and bubble positions
-- Can be opened and edited again later
-- Works completely offline
-
-## How to Use
-
-### 1. **While Editing Your Comic**
-
-After making changes (moving bubbles, editing text):
-
-1. Click **"💾 Save Editable Comic"** button
-2. HTML file downloads to your computer
-3. File includes all your edits
-4. Continue editing or close - your work is saved!
-
-### 2. **Keyboard Shortcut**
-
-Press **Ctrl+S** (or Cmd+S on Mac) to quickly save
-
-### 3. **What Gets Saved**
-
-The downloaded HTML file contains:
-- ✅ All your text edits
-- ✅ Current bubble positions
-- ✅ Original images (as links)
-- ✅ Full editing functionality
-- ✅ Auto-restore of your edits
-
-## Opening Saved Files
-
-### To Continue Editing:
-
-1. **Find your saved file**: `comic_editable_2024-01-15T10-30-45.html`
-2. **Double-click** to open in browser
-3. **Your edits are restored** automatically
-4. **Continue editing** where you left off!
-
-### File Features:
-
-- **Green badge** shows it's a saved version
-- **Timestamp** in filename for version control
-- **Auto-loads** your previous edits
-- **Fully functional** editor included
-
-## Save Options Explained
-
-### 1. **💾 Save Editable Comic** (Orange Button)
-- **What**: Downloads HTML with current edits
-- **Use**: Save your work, continue later
-- **Format**: HTML file
-- **Editable**: Yes! ✅
-
-### 2. **📄 Export to PDF** (Green Button)
-- **What**: Creates PDF for sharing/printing
-- **Use**: Final output, not editable
-- **Format**: PDF file
-- **Editable**: No ❌
-
-### 3. **🖨️ Print Comic** (Blue Button)
-- **What**: Direct printing
-- **Use**: Physical copies
-- **Format**: Paper
-- **Editable**: No ❌
-
-## Workflow Examples
-
-### Editing Over Multiple Sessions:
-
-```
-Day 1: Generate comic → Edit → Save Editable Comic → comic_v1.html
-Day 2: Open comic_v1.html → More edits → Save → comic_v2.html
-Day 3: Open comic_v2.html → Final edits → Export to PDF
-```
-
-### Creating Multiple Versions:
-
-```
-Original → Save as "comic_draft.html"
-Edit more → Save as "comic_revised.html"
-Final version → Save as "comic_final.html"
-Export final → PDF for sharing
-```
-
-## Advanced Features
-
-### Version Control:
-- Filename includes timestamp
-- Save multiple versions
-- Compare different edits
-- Never lose work
-
-### Sharing Editable Comics:
-1. Save your edited comic
-2. Send the HTML file to others
-3. They can open and continue editing
-4. No special software needed
-
-### Backup Strategy:
-- Save after major edits
-- Keep versions in different folders
-- Use cloud storage for safety
-- Export PDF as backup
-
-## Technical Details
-
-### What's in the Saved File:
-```javascript
-// Your edits are embedded
-const savedState = {
-    bubbles: [
-        {text: "Your edited text", left: "150px", top: "50px"},
-        // ... all bubbles
-    ],
-    timestamp: "2024-01-15T10:30:45.123Z"
-};
-```
-
-### Auto-Restore:
-- When file opens, edits are applied
-- No manual loading needed
-- Works in any modern browser
-- Completely self-contained
-
-## Tips & Tricks
-
-1. **Save Often**: Use Ctrl+S regularly
-2. **Name Versions**: Rename files descriptively
-3. **Final Export**: PDF when done editing
-4. **Share HTML**: For collaborative editing
-5. **Keep Originals**: Don't overwrite first version
-
-## Troubleshooting
-
-### If edits don't appear:
-- Wait 2 seconds for auto-restore
-- Check browser console for errors
-- Try refreshing the page
-
-### If images don't load:
-- Make sure you're online (images link to server)
-- Or create portable version with embedded images
-
-### For offline use:
-- Request portable HTML version
-- Images embedded in file
-- Larger file size but works offline
-
-## Summary
-
-You now have a complete editing workflow:
-1. **Generate** comic
-2. **Edit** in browser
-3. **Save** editable HTML
-4. **Continue** anytime
-5. **Export** to PDF when done
-
-The HTML file is your working document - save it like any other file!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

SMART_FRAME_SELECTION.md

@@ -1,74 +1,12 @@
-# ✨ Smart Frame Selection for Engaging Comics
-
-## What It Does
-
-When **Smart Frame Selection** is enabled (checkbox in UI), the system automatically selects the most engaging frames for your comic by:
-
-1. **Analyzing each dialogue/subtitle** to understand the mood and context
-2. **Scanning video frames** around each dialogue moment  
-3. **Selecting frames where**:
-   - The facial expression matches the dialogue mood
-   - Eyes are fully open (no blinking or half-closed eyes)
-   - The image is sharp and clear
-   - The composition is visually appealing
-
-## The Result
-
-A comic that looks natural and engaging where:
-- Characters look happy when saying happy things
-- Characters look sad when saying sad things  
-- No awkward frames with closed eyes
-- Every panel is visually appealing
-
-## How It Works (Internally)
-
-The system uses multiple criteria to score each frame:
-
-### 1. Expression Matching (Hidden from user)
-- Analyzes dialogue sentiment
-- Checks facial expressions
-- Selects frames where they align
-
-### 2. Eye Quality
-- Detects eye state (open/closed)
-- Strongly prefers open eyes
-- Avoids blinks and half-closed eyes
-
-### 3. Visual Quality
-- Checks image sharpness
-- Ensures good composition
-- Avoids blurry frames
-
-### 4. Engagement Score
-Combines all factors to pick the BEST frame for each moment
-
-## User Experience
-
-### Before (Regular Mode):
-- Random frame selection
-- May have closed eyes
-- Expression may not match dialogue
-- Less engaging overall
-
-### After (Smart Mode):
-- Perfect frame selection
-- Always open eyes
-- Expressions match dialogue
-- More engaging and professional
-
-## Simple UI
-
-The interface is clean and simple:
-- Just one checkbox: "Smart Frame Selection"
-- No technical details shown
-- The magic happens behind the scenes
-- Output is a regular comic (no emotion labels)
-
-## Benefits
-
-1. **Better Storytelling**: Expressions enhance the narrative
-2. **Professional Quality**: No awkward closed-eye frames
-3. **Automatic**: AI does all the work
-4. **Natural Looking**: Comics look hand-picked, not random
-
-The user gets a beautiful, engaging comic without needing to understand the technical details!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

UNITY_COMIC_INTEGRATION.md

@@ -1,153 +1,12 @@
-# 🎮 Unity Comic Integration Guide
-
-## For Unity, You Have Two Options:
-
-### Option 1: Individual Panels (Recommended)
-Export each panel as **400×540** without borders
-
-**Benefits:**
-- ✅ More flexible in Unity
-- ✅ Can animate panels individually
-- ✅ Easy to rearrange
-- ✅ Better performance (smaller textures)
-
-### Option 2: Full Pages
-Export complete pages as **800×1080** with or without borders
-
-**Benefits:**
-- ✅ Simpler to implement
-- ✅ One texture per page
-- ✅ Maintains exact layout
-
-## Do You Need Borders?
-
-**Short answer: NO** - Unity doesn't need borders
-
-### Without Borders (Recommended):
-- Clean images
-- You can add borders in Unity with UI system
-- More flexible styling options
-- Smaller file sizes
-
-### With Borders:
-- Use only if you want that specific look
-- Borders become part of the image
-- Can't change border style later
-
-## Unity Setup Guide
-
-### 1. **Texture Import Settings**
-```
-Texture Type: Sprite (2D and UI)
-Pixels Per Unit: 100
-Filter Mode: Bilinear
-Max Size: 2048
-Format: RGBA 32 bit
-```
-
-### 2. **For 400×540 Panels**
-```csharp
-// Create 2x2 grid in Unity
-float panelWidth = 400f;
-float panelHeight = 540f;
-
-// Position panels
-panel1.position = new Vector3(0, 0, 0);
-panel2.position = new Vector3(400, 0, 0);
-panel3.position = new Vector3(0, -540, 0);
-panel4.position = new Vector3(400, -540, 0);
-```
-
-### 3. **For 800×1080 Pages**
-```csharp
-// Simple page display
-GameObject comicPage = new GameObject("ComicPage");
-Image pageImage = comicPage.AddComponent<Image>();
-pageImage.sprite = yourPageSprite;
-
-// Set size
-RectTransform rt = comicPage.GetComponent<RectTransform>();
-rt.sizeDelta = new Vector2(800, 1080);
-```
-
-## Preparing Images for Unity
-
-### Remove Borders (CSS):
-```css
-.panel { 
-    border: none !important; 
-}
-.comic-grid { 
-    border: none !important; 
-}
-```
-
-### Export Options:
-
-1. **Individual Panels** (400×540 each)
-   - No borders
-   - Transparent or white background
-   - PNG format
-
-2. **Full Pages** (800×1080 each)
-   - No borders (add in Unity)
-   - White background
-   - PNG or JPEG
-
-## Unity Comic Viewer Example
-
-```csharp
-public class ComicViewer : MonoBehaviour
-{
-    public Sprite[] comicPages; // 800x1080 pages
-    public Image displayImage;
-    
-    private int currentPage = 0;
-    
-    void Start()
-    {
-        ShowPage(0);
-    }
-    
-    public void NextPage()
-    {
-        currentPage++;
-        if (currentPage < comicPages.Length)
-            ShowPage(currentPage);
-    }
-    
-    void ShowPage(int pageIndex)
-    {
-        displayImage.sprite = comicPages[pageIndex];
-    }
-}
-```
-
-## Best Practices for Unity
-
-1. **Use Power of 2 textures** when possible (512, 1024, 2048)
-2. **Compress textures** in Unity import settings
-3. **Use UI Canvas** for comic display
-4. **Consider mobile** - 800×1080 is perfect for portrait mode
-
-## Size Compatibility
-
-Unity handles any size, but consider:
-- **Mobile**: 800×1080 works great
-- **Desktop**: May need scaling
-- **Memory**: Each 800×1080 = ~3.5MB uncompressed
-
-## Recommended Workflow
-
-1. Export from comic system **without borders**
-2. Import to Unity as **Sprites**
-3. Use **Canvas UI** system
-4. Add borders/effects in Unity
-5. Scale with **Canvas Scaler** for different devices
-
-## Result
-
-- No borders needed in images
-- Unity makes size compatible automatically
-- More flexibility without baked-in borders
-- Professional comic viewer in Unity!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

WORKING_SOLUTION.md

@@ -1,83 +1,12 @@
-# ✅ Working Solution - Full Story Comic Generation
-
-## What Was Happening
-
-From your output, I can see the system is working correctly:
-1. ✅ Found 89 subtitles in the video
-2. ✅ Selected 48 evenly distributed moments (perfect for 12 pages × 4 panels)
-3. ✅ Full story preserved: Beginning → Middle → End
-4. ❌ Frame extraction failed due to function argument error
-
-## What's Fixed
-
-### Fixed the Frame Extraction Error
-- **Problem**: `copy_and_rename_file()` was missing an argument
-- **Solution**: Now passes correct arguments (source, folder, filename)
-
-## Current Working Pipeline
-
-### 1. **Story Extraction** ✅
-```
-📖 Extracting complete story...
-📚 Analyzing 89 subtitles for complete story
-✅ Selected 48 evenly distributed moments
-📖 Full story preserved: Beginning → Middle → End
-```
-
-The system correctly:
-- Takes your 89 subtitles
-- Selects 48 evenly spaced moments
-- Covers the entire story (not just "important" parts)
-
-### 2. **Frame Selection** (Now Fixed)
-For each of the 48 moments:
-- Extracts the frame at that subtitle timing
-- Saves as frame000.png to frame047.png
-- Ready for enhancement
-
-### 3. **Quality Enhancement Pipeline**
-Each frame goes through:
-1. **AI Enhancement** → Upscale to 2K max
-2. **Quality Enhancement** → Denoise, sharpen
-3. **Color Enhancement** → Vibrant colors, better contrast
-4. **No Comic Styling** → Preserves realism
-
-### 4. **12-Page Generation**
-- 12 pages × 4 panels (2x2 grid) = 48 panels
-- Each panel shows one story moment
-- Complete narrative from beginning to end
-
-## Story Coverage Example
-
-From your subtitles:
-- **Beginning**: "Buttonkitt!", "Gattu, look! We have so many orders!"
-- **Development**: Finding the helicopter, taking it home
-- **Middle**: Showing to Mummy, Papa fixing it
-- **Climax**: Playing with helicopter, meeting Chico
-- **End**: (continues through all 48 selected moments)
-
-## Expected Output
-
-```
-12 Pages of Comic:
-- Page 1-2: Introduction (Buttonkitt, orders)
-- Page 3-6: Development (finding helicopter)
-- Page 7-10: Climax (fixing, playing)
-- Page 11-12: Resolution (meeting owner)
-
-Each panel:
-- Clear, enhanced image
-- Vibrant colors
-- Full story context
-- 2x2 grid layout
-```
-
-## To Run Now
-
-The system should work properly after the fix:
-1. Frames will extract correctly
-2. Enhancement will improve quality/colors
-3. 12 pages will be generated
-4. Complete story preserved
-
-No more missing story parts - you'll get the full narrative across 48 well-selected panels!
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

fix_smart_comic_display.md

@@ -1,73 +1,12 @@
-# 🔧 Smart Comic Display Fix
-
-## The Issue
-The smart comic viewer shows "no image displayed" because:
-1. The HTML is looking for images at `/frames/final/{filename}`
-2. The Flask routes need to serve these images properly
-3. The smart comic generation might not have created the proper data structure
-
-## The Solution
-
-I've updated the smart comic viewer to:
-
-### 1. **Fixed Image Paths**
-- Changed from relative paths to proper Flask routes
-- Added fallback image paths in case primary path fails
-- Images now load from `/frames/final/` route
-
-### 2. **Improved Layout**
-- Created a 2-column grid layout for better visibility
-- Added emotion badges showing text vs face emotions
-- Added match scores and eye detection scores
-- Shows summary statistics at the bottom
-
-### 3. **Enhanced Features**
-The smart comic now displays:
-- **Match Score**: How well the facial expression matches the dialogue emotion (shown as percentage)
-- **Eye Score**: Quality of eye detection (avoiding half-closed eyes)
-- **Emotion Badges**: Shows detected emotions for both text and face
-- **Color Coding**: 
-  - Green = Good match (>70%)
-  - Orange = Medium match (40-70%)
-  - Red = Poor match (<40%)
-
-## How It Works
-
-When you generate a comic with smart mode enabled:
-
-1. **Frame Selection**: 
-   - Extracts multiple candidate frames per dialogue
-   - Checks for open eyes (avoids blinking)
-   - Selects best frame based on eye state
-
-2. **Emotion Analysis**:
-   - Analyzes dialogue text for emotions (happy, sad, angry, etc.)
-   - Detects facial expressions in frames
-   - Matches frames to dialogues based on emotion compatibility
-
-3. **Smart Display**:
-   - Shows selected panels with match scores
-   - Highlights emotion detection results
-   - Provides analytics on matching quality
-
-## To Use
-
-1. Upload your video with "Smart Mode" checkbox enabled
-2. The system will:
-   - Extract 48 frames avoiding closed eyes
-   - Match emotions between text and faces
-   - Generate the smart comic viewer
-3. View at `/smart_comic` route
-
-## Expected Results
-
-You should see:
-- Comic panels with clear, open-eyed characters
-- Emotion labels showing text vs face emotions
-- Match scores indicating quality of emotion matching
-- Summary statistics showing overall performance
-
-The smart comic provides a more intelligent comic generation that ensures:
-- ✅ No half-closed eyes in panels
-- ✅ Facial expressions match dialogue emotions
-- ✅ Better storytelling through smart frame selection
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.

readme.md

@@ -1,57 +1,12 @@
-# Comic
-Comic is an automated movie-to-comic generator. Input a video and it generates a comic book for the same complete with a comic style and dialogue bubbles
-
-https://github.com/reubendinny/Cinecomic/assets/30729856/6b40279c-26de-4eb3-b0fa-7de1f5605d0e
-
-
-## Methodology
-Our project consists of the following core modules:
-1. **Subtitle Generation**
-    - Create a subtitle file for the input video using Whisper model
-2. **Keyframe Extraction**
-    - Frame Sampling: Samples frames at a set frequency from videos.
-    - Feature Extraction: Utilizes deep learning models like GoogLeNet v1 to extract features from frames.
-    - Highlightness Score Calculation: Deep Summarization Network (DSN) computes scores to identify keyframes.
-    - Dialogue Grouping: Groups frames based on dialogues to select significant keyframes.
-3. **Panel Layout Generation**
-    - Calculates the Region of Interest of a frame 
-    - Selects a page layout template
-    - Crops frame to be accomodated into template
-4. **Balloon Generation & Placement**
-    - Analysis of emotions in subtitles determines speech balloon shape.
-    - Balloon placement involves using the "Dlib" face-detector library to detect characters' mouth positions in frames and placing at regions with relatively lesser ROI.
-5. **Cartoonization**
-    - Applies style transfer algorithms to enhance keyframes visually, mimicking traditional comics.
-
-> Read the project report for detailed explanations
-
-## Pre-requisites
-- Python
-- Install [Pytorch](https://pytorch.org/get-started/locally/)
-- Install [dlib](https://github.com/z-mahmud22/Dlib_Windows_Python3.x)
-- Install ffmpeg
-- All dependencies mentioned in `requirements.txt` to be installed. (`pip install -r requirements.txt`)
-
-## Running the project
-- If you are not using a GPU, head over to `backend/keyframes/keyframes.py` and set `gpu=False`(At exactly 2 locations)
-- You can head over to `backend/subtitles/subs.py` and change the Whisper model used. (Check supported models [here](https://github.com/openai/whisper))
-- Run the flask server: `python -m flask --app app run`
-- Open the localhost link on your browser (Eg:`http://127.0.0.1:5000`)
-
-## Running with docker
-#### You can run this project using docker with the following commands:
-- ```
-  docker pull reubendinny/cinecomic
-  docker run --name cinecomic -d -p5000:5000 -e WHISPER_MODEL=small cinecomic
-  ```
-- Copy the frames folder and the output folder to a common folder
-- Open the `page.html` file in the output folder to view the comic
-
-
-## Some more examples
-<img src="https://github.com/reubendinny/Cinecomic/assets/30729856/273277fb-fdb8-478d-ac14-8f5502e69ea9" width=50% height=50%>
-
-</br>
-</br>
-<img src="https://github.com/reubendinny/Cinecomic/assets/30729856/23eff922-caa1-42fc-a836-c1c8a8ed13aa" width=50% height=50%>
-
+---
+title: Comic Generator
+emoji: "🎨"
+colorFrom: "purple"
+colorTo: "blue"
+sdk: gradio
+sdk_version: "3.43"
+app_file: app_enhanced.py
+pinned: false
+---
+
+This is a Comic Generator app. Upload images or videos and generate comic-style outputs.