README

Package video and audio into HLS and DASH with Shaka Packager, on top of foxws/laravel-media. Read the source from any Laravel disk, and write the result to any disk.

Shaka Packager packages already-encoded video; it doesn't re-encode. That makes it fast. Encode several qualities first with laravel-media's rendition ladder, then package them together.

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
The Shaka Packager binary

Installation

composer require foxws/laravel-shaka

Install the packager binary, then check the setup:

php artisan media:info

Quick start

use Foxws\Media\Encryption\ProtectionScheme;
use Foxws\Media\Facades\Media;

$result = Media::fromDisk('media')
    ->open('videos/clip.mp4')
    ->shaka()
    ->addStreamsFrom()
    ->withHlsPlaylist()
    ->withDashManifest()
    ->withEncryption(scheme: ProtectionScheme::Cbcs)
    ->toDisk('s3')
    ->save('streams/clip');

This writes one set of encrypted segments with both an HLS playlist and a DASH manifest, and uploads them to streams/clip on the s3 disk. shaka() is laravel-media's packaging builder with the Shaka Packager driver; set MEDIA_PACKAGER=shaka to use it for every package() call.

Shaka Packager's other options, such as DRM systems, key servers and live DASH, are typed methods on ShakaOptions:

use Foxws\Shaka\ProtectionSystem;
use Foxws\Shaka\ShakaOptions;

->withOptions(ShakaOptions::make()->protectionSystems(ProtectionSystem::Widevine)->lowLatencyDashMode())

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-shaka

Package info

Security

Fund package maintenance!

Statistics