README

Encode video into several qualities and package it into HLS and DASH with Shaka Streamer, on top of foxws/laravel-media. Read the source from any Laravel disk, and write the result to any disk.

See the full documentation: Installation, Usage, Testing, Configuration, Upgrading from 2.x.

Requirements

PHP 8.4 or higher
Laravel 13
foxws/laravel-media 0.3.4 or higher
Shaka Streamer, with FFmpeg and Shaka Packager

Installation

composer require foxws/laravel-streamer

Install Shaka Streamer with its bundled FFmpeg and Shaka Packager, then check the setup:

pip install shaka-streamer shaka-streamer-binaries
php artisan media:info

See Installation to use your own FFmpeg and Shaka Packager instead.

Tip

Let your AI agent do the hard parts. This package ships a Laravel Boost skill, laravel-streamer-development, that teaches your agent how to install, configure and use Laravel Streamer. Install Boost and select the skill when prompted:

composer require laravel/boost --dev
php artisan boost:install

Already using Boost? Run php artisan boost:update --discover to pick up the skill. Then just ask, for example: "Turn uploaded videos into 1080p, 720p and 480p HLS and DASH streams."

Quick start

use Foxws\Media\Facades\Media;

$result = Media::fromDisk('media')
    ->open('videos/clip.mp4')
    ->streamer()
    ->addStreamsFrom()
    ->withResolutions('1080p', '720p', '480p')
    ->withHlsPlaylist()
    ->withDashManifest()
    ->toDisk('s3')
    ->save('streams/clip');

This encodes three qualities, writes one set of segments with both an HLS playlist and a DASH manifest, and uploads them to streams/clip on the s3 disk. Run it in a queued job: encoding takes a while.

Serve private streams with laravel-media's signed playlists:

return Media::fromDisk('s3')->open('streams/clip/master.m3u8')
    ->hlsPlaylist()
    ->resolveMediaUrlsUsing(fn (string $path) => Storage::disk('s3')->temporaryUrl($path, now()->addHour()))
    ->toResponse($request);

Testing

composer test

Credits

Used by Stry, a self-hosted video streaming app.

AI, specifically Claude, was used to help build this package. All AI-assisted output is reviewed by me, and I retain final say over everything that is implemented and released.

License

MIT. See License File.

foxws / laravel-streamer

Package info

Security

Fund package maintenance!

Statistics