gauravgpil/php-video-automator

A standalone PHP library to automatically generate videos from text scripts using FFMPEG, AI images, and stock footage.

v1.3.51 2026-06-30 12:11 UTC

Requires

• php: ^8.1
• guzzlehttp/guzzle: ^7.8
• php-ffmpeg/php-ffmpeg: ^1.2

Requires (Dev)

• phpstan/phpstan: ^2.2
• phpunit/phpunit: ^10.5

MIT

• Gaurav Ghoghari

• generator
• video
• ffmpeg
• automation
• archive
• ai
• Pixabay
• Wikimedia
• pexels

Published on Packagist.org on 2026-06-30 12:11 UTC

README

A standalone PHP library to automatically generate videos from text scripts using FFMPEG, AI images, and stock footage. Built exactly to avoid per-generation costs of 3rd party AI video services.

Features

1. AI Image-Based Videos (Idea 1): Splits a script into chunks, generates AI images for each chunk, adds Ken-Burns/zoompan animations, overlays captions, and stitches them into a full MP4.
2. Stock Footage Videos (Idea 2): Parses a script to fetch relevant stock videos from Pixabay, randomly selects varied clips to avoid repetition, standardizes formats, and stitches them together seamlessly.

Installation

composer require gauravgpil/php-video-automator

Note: You must have ffmpeg installed on your server system.

Usage

Setup

Note: wikimedia and archive providers are 100% free and do not require API keys!

use PhpVideoAutomator\VideoAutomator;

$config = [
    'ffmpeg_path' => '/usr/bin/ffmpeg', // Optional, defaults to 'ffmpeg'
    'ai_image_api_key' => 'sk-your-openai-key',
    'pixabay_api_key' => 'your-pixabay-key',
    'pexels_api_key' => 'your-pexels-key',
    'coverr_api_key' => 'your-coverr-key',
];

$automator = new VideoAutomator($config);

Idea 1: Text to AI Images to Video

$automator->fromImages()
    ->setScript("Welcome to our AI channel. Today we learn about the future.")
    ->generateImages() // Uses OpenAI by default
    ->addAnimation('ken-burns')
    ->withCaptions(true)
    ->export('/var/www/output_ai_video.mp4');

Idea 2: Script to Stock Video (Pixabay, Pexels, Coverr, Wikimedia, Archive)

$automator->fromStockVideos()
    ->setScript("Beautiful waterfalls and lush green nature forests.")
    ->fetchStockVideos('wikimedia', '', ['randomize' => true, 'count' => 3])
    ->addTransitions('fade')
    ->export('/var/www/output_stock_video.mp4');

Testing

Run tests via PHPUnit:

vendor/bin/phpunit