🎬 AutoShorts Studio

An automated YouTube Shorts generation and upload desktop application built with PyQt6. Supports multiple content features, each self-contained in its own folder but orchestrated by a unified GUI.

---

📁 Project Structure

YTSFlow/
│
├── main.py                        # App entry point — launches the PyQt6 GUI
├── settings.json                  # Shared config (API keys, Chrome profile path)
├── requirements.txt               # Python dependencies
├── README.md                      # This file
│
├── ui/                            # Shared GUI layer (all features use this)
│   ├── styles.py                  # Global QSS dark-theme stylesheet
│   ├── main_window.py             # Main window, routing, signal handling
│   ├── settings_dialog.py         # Settings popup (API keys, chrome path)
│   └── components/
│       ├── sidebar.py             # Left panel: feature cards + settings + generate button
│       └── preview.py             # Right panel: video preview + activity log
│
├── core/                          # Shared utilities (used by all features)
│   └── config.py                  # Loads/saves settings.json; exposes config_manager
│
├── ai_video_code/                 # 🤖 AI Video Generator feature
├── ball battle code/              # 🎮 Ball Battle feature
├── AI Quiz code/                  # ❓ AI Quiz Generator feature
├── AI Text Video generator/       # 📝 AI Text Video Generator feature
├── Custom Html code/              # 🌐 Custom HTML Video Maker feature
│
├── outputs/                       # Generated AI Videos saved here (.mp4)
├── assets/                        # Static app assets (icons, etc.)
└── shared_chrome_profile/         # 🔑 Shared Chrome profile (login once, all features reuse)

---

⚙️ Setup

1. Install Dependencies

pip install -r requirements.txt

Requires FFmpeg installed and added to the system PATH. Additionally, some features use Playwright which requires installing browser binaries (playwright install chromium).

2. Configure Settings

Edit settings.json or use the in-app Settings dialog:

Key	Description
groq_api_key	Groq API key for AI script / question generation
pexels_api_key	Pexels API key for stock footage
chrome_profile_path	Absolute path to shared Chrome profile folder
voice_engine	TTS engine — EdgeTTS (default)
background_music	true / false

3. First-Time Chrome Login

All features share one Chrome profile at shared_chrome_profile/. On first run for uploading, Chrome will open and ask you to log into your YouTube/Google account. After that, login is remembered permanently — no re-login needed across features.

---

🚀 Running the App

python main.py

---

🎬 Features

🤖 AI Video Generator (ai_video_code/)

What it does: Fully automated end-to-end pipeline: topic → AI script → voiceover → stock footage → compiled MP4 → uploaded to YouTube.

🎮 Ball Battle (ball battle code/)

What it does: Generates physics-based ball vs ball battle videos using a browser-based HTML5 canvas game engine, records them, and uploads automatically to YouTube.

❓ AI Quiz (AI Quiz code/)

What it does: Generates educational & trivia shorts. Uses Groq to formulate questions, EdgeTTS to read them out with a countdown, and MoviePy to render the quiz visually with background music and effects.

📝 AI Text Video (AI Text Video generator/)

What it does: Generates highly dynamic, code-syntax highlighted, and glassmorphism-styled educational slides. It orchestrates precise audio timings per slide, generates an interactive HTML sequence, records it headless via Playwright, and encodes to MP4 with FFmpeg.

🌐 Custom HTML Video Maker (Custom Html code/)

What it does: Allows users to upload their own standalone HTML animation files. The app headless-records the HTML into smooth 1080x1920 60fps video files via Playwright.

📤 Custom File Upload (ui/components/sidebar.py)

What it does: Allows users to select any .mp4, optionally utilize Groq AI to enhance its title and description metadata, and automatically push it to their YouTube channel using the persistent automation session.

---

🔧 How the UI Routes Features

ui/main_window.py listens for the generate_requested signal from the sidebar. Work is pushed to background QThread workers so the GUI remains flawlessly smooth:

Feature Key	Handler	Method
ai_video	start_ai_video()	Spawns AIVideoPipeline QThread
ball_battle	start_ball_battle()	Spawns ball battle code/main.py via QProcess
ai_quiz	start_ai_quiz()	Spawns AIQuizPipeline QThread
ai_text_video	start_ai_text_video()	Spawns AITextVideoPipeline QThread
custom_html	start_custom_html()	Spawns CustomHtmlPipeline QThread

---

🛠️ Tech Stack

Layer	Technology
GUI	PyQt6
AI Prompting	Groq API (LLaMA 3)
Text-to-Speech	Edge TTS (Microsoft Neural)
Stock Footage	Pexels API
Video Editing	FFmpeg & MoviePy
Headless Recording	Playwright API
Browser Automation	Selenium WebDriver + ChromeDriver
Web Engine	HTML5 Canvas + CSS3 Glassmorphism + Vanilla JS