README

Runs ab-av1 from Laravel to encode video to AV1. You set the quality you want as a VMAF score, and ab-av1 finds the smallest encode that reaches it. It's an add-on for 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 or higher (installed with the package)
ab-av1, with FFmpeg built with svt-av1 and libvmaf

Installation

composer require foxws/laravel-ab-av1

php artisan vendor:publish --tag="ab-av1-config"

Install the ab-av1 binary, then check the setup:

php artisan media:info

See Installation for details.

Quick start

use Foxws\Media\Facades\Media;

$result = Media::fromDisk('media')
    ->open('videos/clip.mp4')
    ->abAv1()
    ->withPreset(6)
    ->withMinVMAF(95)
    ->toDisk('s3')
    ->save('encoded/clip.mp4');

$result->crf;  // e.g. 30.25
$result->vmaf; // e.g. 95.1

This finds the CRF that reaches a VMAF score of 95, encodes the video with it, and uploads the result to encoded/clip.mp4 on the s3 disk. laravel-media cleans up the temporary files after the queue job or request.

See Usage for the other ab-av1 commands, hardware encoders, filters and checking the result.

Testing

composer test

Credits

francoism90
All Contributors
ab-av1 by Alex Butler, which does the actual work

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-ab-av1

Package info

Security

Fund package maintenance!

Statistics