ritechoice23/laravel-fluent-ffmpeg

A fluent, chainable API for working with FFmpeg in Laravel applications

1.0.0 2025-11-26 16:24 UTC

Requires

• php: ^8.2
• illuminate/contracts: ^11.0||^12.0
• spatie/laravel-package-tools: ^1.16
• symfony/process: ^6.0|^7.0

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.14
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^10.0.0||^9.0.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0

MIT

• Daramola Babatunde Ebenezer

• media
• fluent
• audio
• conversion
• video
• ffmpeg
• streaming
• laravel
• processing
• hls
• ritechoice23

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');

Features

• Fluent API - Chainable, expressive syntax
• 20+ Filters - Watermarks, effects, transformations
• Multiple Formats - MP4, HLS, DASH, GIF, and more
• 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 - 65+ passing tests

Documentation

• Installation & Configuration
• Basic Usage
• Video Options
• Audio Options
• Subtitle Options
• Filters & Effects
• 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.