Laravel Shaka Packager

A Laravel integration for Google's Shaka Packager, enabling you to create adaptive streaming content (HLS, DASH) with a fluent, Laravel-style API.

use Foxws\Shaka\Facades\Shaka;

$result = Shaka::fromDisk('s3')
    ->open('videos/input.mp4')
    ->addVideoStream('videos/input.mp4', 'video_1080p.mp4', ['bandwidth' => '5000000'])
    ->addVideoStream('videos/input.mp4', 'video_720p.mp4', ['bandwidth' => '3000000'])
    ->addAudioStream('videos/input.mp4', 'audio.mp4')
    ->withHlsMasterPlaylist('master.m3u8')
    ->withSegmentDuration(6)
    ->export()
    ->toDisk('export')
    ->save();

• 🎬 Fluent API - Laravel-style chainable methods
• 📁 Multiple Disks - Works with local, S3, and custom filesystems
• 🎯 Adaptive Bitrate - Create multi-quality streams easily
• 🔒 Encryption & DRM - Built-in support for content protection
• 📺 HLS & DASH - Both manifests packaged from the same CMAF segments in one export, no double encoding
• 🧪 Testable - Clean architecture with mockable components
• 📝 Type-Safe - Full PHP 8.1+ type declarations

See the full documentation (or browse docs/ directly): Installation, Usage, Quick Reference, Configuration, Architecture, AES Encryption, URL Resolvers, Queue Integration, Troubleshooting.

• PHP 8.3 or higher
• Laravel 12.x or higher
• Shaka Packager binary installed on your system or Docker container

Install the package via composer:

composer require foxws/laravel-shaka

Publish the config file:

php artisan vendor:publish --tag="shaka-config"

Install Shaka Packager binary on your system. Visit the Shaka Packager releases page for installation instructions.

After installation, verify that Shaka Packager is properly configured:

php artisan shaka:info

This will check:

• Binary exists and is executable
• Can retrieve version information
• Configuration is properly set up
• Temporary directory is accessible

use Foxws\Shaka\Facades\Shaka;

$result = Shaka::open('input.mp4')
    ->addVideoStream('input.mp4', 'video.mp4')
    ->addAudioStream('input.mp4', 'audio.mp4')
    ->withHlsMasterPlaylist('master.m3u8')
    ->export()
    ->save();

$result = Shaka::open('input.mp4')
    ->addVideoStream('input.mp4', 'video_1080p.mp4', ['bandwidth' => '5000000'])
    ->addVideoStream('input.mp4', 'video_720p.mp4', ['bandwidth' => '3000000'])
    ->addVideoStream('input.mp4', 'video_480p.mp4', ['bandwidth' => '1500000'])
    ->addAudioStream('input.mp4', 'audio.mp4')
    ->withHlsMasterPlaylist('master.m3u8')
    ->withSegmentDuration(6)
    ->export()
    ->save();

Video and audio streams are packaged as CMAF (fragmented MP4) by default, so the same set of segments can be described by both a DASH manifest and an HLS master playlist. Chaining withMpdOutput() and withHlsMasterPlaylist() on the same builder packages both from a single export() — one packaging pass, no extra transcoding, just an additional manifest file:

$result = Shaka::open('input.mp4')
    ->addVideoStream('input.mp4', 'video.mp4')
    ->addAudioStream('input.mp4', 'audio.mp4')
    ->withMpdOutput('manifest.mpd')
    ->withHlsMasterPlaylist('master.m3u8')
    ->export()
    ->save();

If you only need one format, only set the corresponding output — Shaka Packager only generates the manifest(s) you ask for.

$result = Shaka::fromDisk('s3')
    ->open('videos/input.mp4')
    ->addVideoStream('videos/input.mp4', 'video.mp4')
    ->addAudioStream('videos/input.mp4', 'audio.mp4')
    ->withHlsMasterPlaylist('master.m3u8')
    ->export()
    ->toDisk('export') // Save output to a different disk (e.g., local, s3, etc.)
    ->toPath('exports/') // (Optional) Save to a subdirectory on the target disk
    ->save();

withAESEncryption() returns an EncryptionKey value object (not $this), so it breaks the fluent chain — call it on its own line:

// Basic encryption with auto-generated AES-128 key
$streamer = Shaka::open('input.mp4')
    ->addVideoStream('input.mp4', 'video.mp4')
    ->addAudioStream('input.mp4', 'audio.mp4')
    ->withHlsMasterPlaylist('master.m3u8');

$encryptionKey = $streamer->withAESEncryption(); // Auto-generates key with 'cbc1' scheme

$streamer->export()->save();

// With key rotation (generates key_0.key, key_1.key, etc.)
$streamer = Shaka::open('input.mp4')
    ->addVideoStream('input.mp4', 'video.mp4')
    ->addAudioStream('input.mp4', 'audio.mp4')
    ->withHlsMasterPlaylist('master.m3u8');

$encryptionKey = $streamer->withAESEncryption();
$streamer->withKeyRotationDuration(60); // Rotate every 60 seconds

$streamer->export()->toDisk('s3')->save();

See AES Encryption Guide for complete documentation.

Serve encrypted streaming content with S3 signed URLs:

HLS Example:

use Foxws\Shaka\Http\DynamicHLSPlaylist;
use Illuminate\Support\Facades\Storage;

public function playlist(Video $video)
{
    return (new DynamicHLSPlaylist('s3'))
        ->open("videos/{$video->id}/master.m3u8")
        ->setKeyUrlResolver(fn ($key) => Storage::disk('s3')->temporaryUrl(
            "videos/{$video->id}/{$key}",
            now()->addHour()
        ))
        ->setMediaUrlResolver(fn ($file) => Storage::disk('s3')->temporaryUrl(
            "videos/{$video->id}/{$file}",
            now()->addHours(2)
        ))
        ->toResponse(request());
}

DASH Example:

use Foxws\Shaka\Http\DynamicDASHManifest;
use Illuminate\Support\Facades\Storage;

public function manifest(Video $video)
{
    return (new DynamicDASHManifest('s3'))
        ->open("videos/{$video->id}/manifest.mpd")
        ->setKeyUrlResolver(fn ($key) => Storage::disk('s3')->temporaryUrl(
            "videos/{$video->id}/{$key}",
            now()->addHour()
        ))
        ->setMediaUrlResolver(fn ($file) => Storage::disk('s3')->temporaryUrl(
            "videos/{$video->id}/{$file}",
            now()->addHours(2)
        ))
        ->setInitUrlResolver(fn ($file) => Storage::disk('s3')->temporaryUrl(
            "videos/{$video->id}/{$file}",
            now()->addHours(2)
        ))
        ->toResponse(request());
}

Use cases for URL resolvers:

• 🔐 Generate signed URLs for secure content delivery
• 🌐 Integrate with CDN services
• 🏢 Support multi-tenant applications
• 🔄 Implement dynamic key rotation
• 📊 Track media access patterns

See URL Resolver Examples and Documentation for more details.

• fromDisk(string $disk) - Set the disk to use
• openFromDisk(string $disk, $paths) - Set disk and open files in one call
• getDisk() - Get the current disk instance

• open($paths) - Open one or more media files
• get() - Get the MediaCollection
• streams() - Get auto-generated Stream objects

• addVideoStream(string $input, string $output, array $options = []) - Add video stream
• addAudioStream(string $input, string $output, array $options = []) - Add audio stream
• addTextStream(string $input, string $output, array $options = []) - Add text/caption/subtitle stream
• addStream(Stream|array $stream) - Add custom stream, from a Stream value object or a raw ['in' => ..., 'stream' => ..., 'output' => ...] array

• withHlsMasterPlaylist(string $path) - Set HLS master playlist output
• withMpdOutput(string $path) - Set DASH manifest output
• withBaseUrls(string|array $urls) - Set DASH <BaseURL> element(s) under <MPD>
• withSegmentDuration(int $seconds) - Set segment duration
• withAESEncryption(string $keyFilename = 'key', ProtectionScheme|string|null $protectionScheme = 'cbc1', ?string $label = null): EncryptionKey - Enable AES-128 encryption (does not return $this — breaks the fluent chain)
• withKeyRotationDuration(int $seconds) - Enable key rotation for encryption
• toDisk(string $disk) - Set the target disk for output
• toPath(string $path) - Set the target output path (subdirectory)
• withVisibility(string $visibility) - Set file visibility (e.g., 'public', 'private')

• export() - Execute the packaging operation (returns result object)
• save(?string $path = null) - Save outputs to disk (optionally to a specific path)
• getCommand() - Get the final command string (for debugging)
• dd() - Dump the final command and end the script
• afterSaving(callable $callback) - Register a callback to run after saving

DynamicHLSPlaylist:

• new DynamicHLSPlaylist(?string $disk) - Create HLS playlist processor
• open(string $path) - Open a playlist file
• setKeyUrlResolver(callable $resolver) - Set resolver for encryption key URLs
• setMediaUrlResolver(callable $resolver) - Set resolver for media segment URLs
• setPlaylistUrlResolver(callable $resolver) - Set resolver for sub-playlist URLs
• get() - Get processed playlist content
• all() - Get all processed playlists (master + segments)
• toResponse($request) - Return as HTTP response

DynamicDASHManifest:

• new DynamicDASHManifest(?string $disk) - Create DASH manifest processor
• open(string $path) - Open a manifest file
• setMediaUrlResolver(callable $resolver) - Set resolver for media segment URLs
• setInitUrlResolver(callable $resolver) - Set resolver for initialization segment URLs
• get() - Get processed manifest content
• toResponse($request) - Return as HTTP response

See the Quick Reference for complete API documentation.

composer test

Please see CHANGELOG for more information on what has changed recently.

Please see CONTRIBUTING for details.

If you discover a security vulnerability, please report it via a private channel (e.g., email or GitHub issues) rather than publicly disclosing it.

This package was inspired by and learned from:

• Laravel FFmpeg - Architecture patterns and Laravel integration approach.
• quasarstream/shaka-php - Shaka Packager wrapper implementation and command building logic.

Much of the existing logic and design patterns from these excellent packages helped shape this implementation. Many thanks to their authors and contributors!

• Stry - A modern streaming platform built on top of Laravel Shaka Packager.

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