# protonemedia/laravel-ffmpeg

This package provides an integration with FFmpeg for Laravel. Laravel's Filesystem handles the storage of the files.

Repository: https://github.com/protonemedia/laravel-ffmpeg
Canonical: https://ross.abutalabs.com/products/laravel-ffmpeg
Homepage: https://protone.media/en/blog/how-to-use-ffmpeg-in-your-laravel-projects
Language: PHP
License: MIT
License Family: permissive
Topics: ffmpeg, laravel-ffmpeg, php-ffmpeg, laravel, php, video, hls, hls-live-streaming, hls-stream
Last push: 2026-02-28T09:35:15+00:00

## Health v2 (maintenance only)
Score: 72/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 69, release rhythm 60, longevity 100
- inputs: {"age_days": 3687, "days_push": 186, "days_rel": 190, "gap_med": 69.5, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1814, forks 200 (observed 2026-08-28T04:05:39.850292+00:00)

## What it is
A Laravel package that wraps PHP-FFMpeg to provide an elegant, testable API for video and audio processing, with deep integration into Laravel's Filesystem, configuration, and logging. It includes built-in support for HLS streaming (including encrypted HLS with rotating AES-128 keys), watermarks, frame exports, concatenation, and VTT preview thumbnails.

## Use cases
- transcode uploaded videos to multiple bitrates in Laravel
- generate HLS streams for HTTP video playback
- extract thumbnails and preview sprites from videos
- add watermarks to videos programmatically
- create encrypted HLS streams with rotating keys
- process videos stored on S3 or other Laravel filesystem disks
- build a video platform with Laravel

## When to choose
- you're building a Laravel app that needs video/audio transcoding
- you want HLS or encrypted-HLS streaming with minimal setup
- you want FFmpeg processing integrated with Laravel's filesystem (local, S3, etc.)
- you need frame exports, watermarks, or VTT preview thumbnails

## When to avoid
- your project doesn't use Laravel or PHP
- you need direct, low-level control over FFmpeg command-line arguments
- you need live transcoding of real-time input rather than file-based processing
- you're not comfortable managing the FFmpeg binary on your server

## Facets
- artifact type: library
- maturity: active
- function: video-processing, image-processing, streaming, file-upload
- domain: media, web-development, backend
- platform: php, self-hosted
- tags: ffmpeg, hls, laravel-package, video-transcoding, php-ffmpeg, thumbnail-generation, watermarking, video, laravel, web-server

## Member repositories
- protonemedia/laravel-ffmpeg (main) score 72

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:39.850292+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:21:06.316482+00:00, confidence not recorded.
  - readme: https://github.com/protonemedia/laravel-ffmpeg (fetched 2026-08-28T04:05:39.850292+00:00, sha 04c574aae0b9)
  - homepage: https://protone.media/en/blog/how-to-use-ffmpeg-in-your-laravel-projects (fetched 2026-08-29T10:59:44.272637+00:00, sha 32b92b030a22)
  - site_page: https://pascalbaljet.dev/were-releasing-the-next-major-version-of-laravel-ffmpeg-a-full-rewrite-with-new-features-and-many-improvements (fetched 2026-08-29T10:59:44.282083+00:00, sha 6fd9ae5b5845)
- Data as of 2026-08-30T08:39:29.467469+00:00.