README

A fluent, chainable API for working with FFmpeg in Laravel applications. Process videos and audio with an elegant, expressive syntax.

Installation

composer require ritechoice23/laravel-fluent-ffmpeg

Publish the configuration:

php artisan vendor:publish --tag=fluent-ffmpeg-config

Quick Start

use Ritechoice23\FluentFFmpeg\Facades\FFmpeg; // Basic video conversion FFmpeg::fromPath('video.mp4') ->videoCodec('libx264') ->audioCodec('aac') ->resolution(1920, 1080) ->save('output.mp4'); // Or using the global helper ffmpeg()->fromPath('video.mp4') ->videoCodec('libx264') ->save('output.mp4'); // Extract audio FFmpeg::fromPath('video.mp4') ->extractAudio() ->save('audio.mp3'); // Create GIF FFmpeg::fromPath('video.mp4') ->clip('00:00:05', '00:00:10') ->toGif(['fps' => 15, 'width' => 480]) ->save('animation.gif'); // Advanced HLS Streaming (Multi-bitrate) FFmpeg::fromPath('video.mp4') ->exportForHLS() ->addFormat('1080p') ->addFormat('720p') ->addFormat('480p') ->save('stream.m3u8'); // Extract multiple clips FFmpeg::fromPath('video.mp4') ->clips([ ['start' => '00:00:10', 'end' => '00:00:20'], ['start' => '00:01:30', 'end' => '00:02:00'], ['start' => '00:03:45', 'end' => '00:04:15'], ]) ->save('highlight.mp4'); // Outputs: highlight_1.mp4, highlight_2.mp4, highlight_3.mp4 // Video composition with intro, outro, and watermark FFmpeg::fromPath('video.mp4') ->withIntro('intro.mp4') ->withOutro('outro.mp4') ->withWatermark('logo.png', 'bottom-right') ->save('branded.mp4'); // Process all videos in a directory FFmpeg::fromDirectory('/path/to/videos') ->resize(1920, 1080) ->withWatermark('logo.png', 'top-right') ->save('/path/to/output/'); // Add text overlay (supports multiple overlays!) FFmpeg::fromPath('video.mp4') ->withText('Title', ['position' => 'top-center', 'font_size' => 36]) ->withText('Subtitle', ['position' => 'center', 'font_size' => 24]) ->withText('© 2024', ['position' => 'bottom-right', 'font_size' => 14]) ->save('output.mp4'); // Generate audio waveforms for visualization FFmpeg::fromPath('audio.mp3') ->audioCodec('aac') ->withPeaks(samplesPerPixel: 512, normalizeRange: [0, 1]) ->save('output.m4a'); // Outputs: output.m4a + output-peaks.json

Features

• Fluent API - Chainable, expressive syntax
• Audio Waveforms - Generate waveform data for visualization
• Multi-Clip Extraction - Extract multiple clips with auto-numbering
• Directory Processing - Process multiple files from a directory
• Multiple Text Overlays - Add multiple styled text overlays with positioning and timing
• Video Composition - Add intro, outro, and watermarks to clips
• 20+ Filters - Effects, transformations, overlays
• Multiple Formats - MP4, HLS, DASH, GIF, and more
• Media Probing - Get detailed video/audio information
• Laravel Disks - Save to S3, local, or any disk
• Progress Tracking - Real-time progress with broadcasting
• Queue Support - Process videos in background
• Smart Defaults - Sensible defaults from config
• Events - Track processing lifecycle
• Fully Tested - 228+ passing tests

Documentation

• Installation & Configuration
• Basic Usage
• Audio Waveforms - Generate waveform data for visualization
• Directory Processing - Process multiple files from a directory
• Text Overlay - Add styled text to videos
• Clipping - Extract single or multiple video clips
• Video Composition - Add intro/outro/watermark
• Media Probing - Get video/audio information
• Video Options
• Audio Options
• Subtitle Options
• Filters & Effects
• Format Conversion - Convert to MP3, MP4, WebM, and more
• Formats & Streaming
• Advanced HLS
• Cross-Platform Compatibility
• Laravel Integration
• Queue Processing
• Events & Broadcasting
• Helper Methods
• Package Lifecycle
• API Reference

Requirements

• PHP 8.2+
• Laravel 10.0+
• FFmpeg 4.0+

Testing

composer test

Credits

• Daramola Babatunde Ebenezer

License

The MIT License (MIT). Please see License File for more information.