AutoShorts Generator 🚀🎥

AutoShorts is an AI-powered automation tool that transforms long YouTube videos (or local files) into short, engaging clips ("Shorts") perfect for TikTok, YouTube Shorts, and Instagram Reels.

AutoShorts é uma ferramenta de automação com IA que transforma vídeos longos do YouTube (ou arquivos locais) em clipes curtos e engajadores ("Shorts"), ideais para TikTok, YouTube Shorts e Instagram Reels.

---

🔥 Features / Funcionalidades

Feature	Description (EN)	Descrição (PT)
🤖 AI Curation	Uses Llama 3 (via Groq) to find the most viral moments.	Usa Llama 3 (via Groq) para encontrar os momentos mais virais.
🎯 Smart Crop	Automatically detects faces to crop horizontal video to 9:16 Vertical.	Detecta rostos automaticamente para cortar vídeos horizontais para 9:16 Vertical.
🗣️ Dynamic Subs	"Karaoke-style" subtitles that sync perfectly with audio.	Legendas "estilo Karaoke" que sincronizam perfeitamente com o áudio.
🌍 Auto-Translate	Translates subtitles on-the-fly to English, Portuguese, or Spanish.	Traduz legendas instantaneamente para Inglês, Português ou Espanhol.
🛡️ Auto-Expand	Intelligent logic ensures clips never fall below minimum duration.	Lógica inteligente garante que os clipes nunca fiquem abaixo da duração mínima.
💻 Web UI	Modern Control Panel to manage API keys and generation.	Painel de Controle moderno para gerenciar chaves de API e geração.

---

🇺🇸 English Guide

System Requirements

To enable subtitles and smart cropping, you must install ImageMagick:

• MacOS: brew install imagemagick
• Linux: sudo apt install imagemagick
• Windows: Download official installer and check "Install Legacy Utilities (e.g. convert)".

Installation

1. Clone the repo and install dependencies:

   pip install -r requirements.txt

2. Configure .env file:

   cp .env.example .env
   # Edit .env with your API Keys (Groq, OpenAI)

Usage

Start the Web Server:

python app.py

Access http://localhost:5001 in your browser.

---

🇧🇷 Guia em Português

Pré-requisitos do Sistema

Para que as legendas e o corte inteligente funcionem, você deve instalar o ImageMagick:

• MacOS: brew install imagemagick
• Linux: sudo apt install imagemagick
• Windows: Baixe o instalador oficial e marque a opção "Install Legacy Utilities (e.g. convert)".

Instalação

1. Clone o repositório e instale as dependências:

   pip install -r requirements.txt

2. Configure o arquivo .env:

   cp .env.example .env
   # Edite o arquivo .env com suas chaves de API (Groq, OpenAI)

Como Usar

Inicie o servidor Web:

python app.py

Acesse http://localhost:5001 no seu navegador.

---

🛠️ Tech Stack

• Backend: Flask, MoviePy, OpenAI Whisper, Groq API (Llama 3).
• Frontend: HTML5, JavaScript, TailwindCSS.
• Processing: OpenCV (Face Detection), FFmpeg, ImageMagick.

⚠️ Troubleshooting / Solução de Problemas

• Error 429 (Rate Limit): You hit the free tier limit on Groq. Switch to a smaller model (e.g., llama-3.1-8b-instant) in settings.
• Subtitles not showing?: Verify ImageMagick installation. Run convert -version in your terminal.
• Port 5000 busy?: The app runs on port 5001 by default to avoid macOS AirPlay conflicts.