Summary

This project automates the creation of YouTube Shorts content locally, targeting content creators and social media managers. It streamlines the entire video production pipeline, from AI-generated scripts to social media scheduling, offering significant time savings.

How It Works

The system orchestrates a multi-stage video generation process. It begins with AI script generation using g4f or Gemini, followed by automated searching and downloading of stock video clips from Pexels. Text-to-Speech (TTS) is applied using local or fallback engines, overlaid with customizable subtitle templates. The pipeline integrates background music and allows for initial image stitching before final video assembly and optional social media scheduling via MagicSync.

Quick Start & Requirements

Setup is achievable via Docker or manual installation.

• Docker: Clone the repository, copy .env.example to .env, set PEXELS_API_KEY and IMAGEMAGICK_BINARY in .env, then run docker compose up -d. Access the frontend at http://localhost:5000 or http://localhost:3000.
• Manual: Install backend dependencies (pip install -r requirements.txt), configure .env, and run python main.py (Flask on :8080). Install frontend dependencies (npm install) and run npm run dev (Nuxt 3 on :3000).
• Prerequisites: A Pexels API key and the path to the ImageMagick convert binary are mandatory. Optional keys include Google (Gemini), OpenAI, AssemblyAI, and MagicSync credentials.

Highlighted Details

• AI Scripting: Leverages g4f (free) or Gemini for script generation.
• Stock Footage: Automatically downloads relevant clips from Pexels.
• Multi-Voice TTS: Supports local Supertonic (10 voices, 33 languages), TikTok TTS, and KittenTTS.
• Subtitles: Offers 10 distinct subtitle templates (e.g., classic, neon, karaoke).
• Image Stitching: Allows uploading multiple images for video intros with configurable durations.
• Scheduling: Integrates with MagicSync for multi-platform social media posting.
• Hardware Acceleration: Auto-detects GPUs for faster FFmpeg encoding.
• Thumbnail Generation: Includes an API endpoint (/api/extract-frame) for creating custom thumbnails.

Maintenance & Community

The project welcomes pull requests, with a recommendation to open an issue for major changes. No specific community channels (like Discord/Slack) or roadmap links are provided in the README.

Licensing & Compatibility

The project's license details are available in a separate LICENSE file. No specific restrictions or compatibility notes for commercial use or linking with closed-source projects are mentioned in the README.

Limitations & Caveats

Core functionality necessitates obtaining API keys for Pexels and potentially other services like Gemini or OpenAI. The README does not specify the exact license type, only referencing the LICENSE file. Setup requires ensuring ImageMagick is installed and its binary path is correctly configured.