loreal-video-optimizer/QUICKSTART.md

Quick Start Guide

🚀 Get Started in 3 Steps

1. Start the Application

./start.sh

This will start both the backend (port 5000) and frontend (port 8000).

2. Open Your Browser

Navigate to: http://localhost:8000

3. Upload and Convert

1. Drag & drop a video file onto the upload area
2. Select platform (e.g., TikTok, Meta, YouTube)
3. Select aspect ratio (e.g., 1:1, 16:9, 9:16)
4. Click "Convert Video"
5. Compare side-by-side and download optimized file

---

📝 Filename Auto-Detection

Name your files with these patterns for automatic detection:

Examples:

• summer_campaign_tiktok_9x16.mp4 → Auto-detects TikTok + 9:16
• product_ad_meta_1x1_v2.mov → Auto-detects Meta + 1:1
• youtube_16x9_final.mp4 → Auto-detects YouTube + 16:9

Platform Keywords:

• TikTok: _tiktok_, _tt_
• Meta: _meta_, _fb_, _ig_
• YouTube: _youtube_, _yt_
• Pinterest: _pinterest_, _pin_
• Snapchat: _snapchat_, _snap_

Aspect Ratio Keywords:

• 1:1 → _1x1_, _square_
• 16:9 → _16x9_, _landscape_
• 9:16 → _9x16_, _vertical_, _portrait_
• 4:5 → _4x5_
• 2:3 → _2x3_

---

🎯 Platform Specifications

Platform	Best For	Codec	Popular Sizes
TikTok	Vertical mobile	H265	540×960, 640×640
Meta	All devices	H264	720×720, 1280×720
YouTube	Quality focus	VP9	1280×720, 1920×1080
Pinterest	Inspiration	H264	1000×1500 (2:3)
Snapchat	Stories	H264	720×1280

---

🛠 Troubleshooting

Backend won't start?

source venv/bin/activate
pip install -r backend/requirements.txt

FFmpeg not found?

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt-get install ffmpeg

Port already in use?

# Kill processes on port 5000 or 8000
lsof -ti:5000 | xargs kill
lsof -ti:8000 | xargs kill

---

📊 File Size Expectations

Typical reduction rates based on L'Oréal documentation:

• TikTok 9:16: 30-40% reduction (using H265)
• Meta 1:1: 25-35% reduction
• YouTube 16:9: 20-30% reduction (VP9 is efficient)

Actual results vary based on source quality and content complexity

---

🎨 Color Scheme

• Primary: Black (#000000)
• Accent: Yellow (#FFC407)
• Font: Montserrat

---

Need help? Check the full README.md for detailed documentation.