TikTokMaker - AI Video Automation Platform

TikTokMaker is an advanced, AI-powered video generation engine designed to automate the creation of high-quality, short-form content (TikToks, Reels, Shorts).

It goes beyond simple concatenation by using computer vision, audio analysis, and iterative AI improvement to create videos that are beat-synced, visually engaging, and optimized for retention.

🚀 Key Features

• AI-Driven Content Assembly: detailed strategies like "Face Focus", "Hook First", and "High Energy Burst".
• Smart Beat Sync: Analyzes audio beats to cut clips exactly on rhythm.
• Iterative Improvement Engine: Generates videos, scores them using AI, and automatically re-edits to improve quality.
• Content Intelligence:
  • Face detection & quality scoring.
  • Automatic clip segmentation and classification.
  • Energy level detection for both audio and video.
• Mass Production: Tools for scraping, processing, and generating content at scale.
• Web Interface: A modern Next.js dashboard ("Infinite Generator") for controlling the generation process.

🛠️ Tech Stack

• Core: TypeScript, Node.js
• Frontend: Next.js 14, React, Tailwind CSS
• Video Processing: FFmpeg, Fluent-FFmpeg
• Data: Supabase (PostgreSQL)
• AI/ML: Custom scoring algorithms, integration with external AI APIs (OpenAI/Google Gemini) for content analysis.

🏁 Quick Start

1. Install Dependencies:

   npm install
   

2. Setup Environment: Ensure you have FFmpeg installed and in your system PATH.

3. Run the Web Interface:

   npm run dev
   

   Open http://localhost:3000 to start generating.

📚 Documentation

Detailed documentation is available in the docs/ directory:

• Getting Started Guide: Detailed installation and setup instructions.
• CLI Command Reference: List of all available command-line tools and scripts.
• Architecture Overview: How the system works under the hood.
• Quality Playbook: Tuning encoding, gating, and beat-sync for best output.

📁 Project Structure

tiktokmaker/
├── app/                  # Next.js App Router (Frontend UI)
├── src/                  # Core Application Logic
│   ├── classifier/       # ML/Classification scripts
│   ├── database/         # SQLite schema and migration tools
│   ├── videoEditor.ts    # Main video assembly logic
│   ├── beatDetector.ts   # Audio analysis
│   └── ...
├── input/                # Source files (Raw video/audio)
├── output/               # Generated videos
└── tools/                # Helper utilities (Scrapers, etc.)

⚠️ Requirements

• Node.js (v18+ recommended)
• Python (v3.8+): Required for the content scraper.
• FFmpeg: Must be installed and added to your system PATH.
• Storage: Sufficient disk space for processing video files.

⚙️ Configuration

Create a .env.local file to configure API keys for AI features. See Getting Started for details.

📄 License

ISC