README

PAM Native Media Editor

Non-destructive editing with native export pipelines.

Describe crops, trims, transforms, filters, and export jobs in PHP while decoding and rendering stay native.

Documentation · Quick start · What you can build · PAM ecosystem · Issues

Why PAM Native Media Editor

Describe crops, trims, transforms, filters, and export jobs in PHP while decoding and rendering stay native. The public API is strictly typed for PHP 8.5; expensive or frame-sensitive work stays in Rust or the platform SDK instead of crossing the application boundary every frame.


Best for	A focused capability you can add to any PAM Native application
Native path	Media3/MediaCodec · AVFoundation/Core Image
Application model	Composer package + generated native integration
Design rule	Independent module; no feed, vertical, or application template bundled

What you can build

Creator and social editing flows
Commerce image preparation
Trim, crop, rotate, and export workflows

Quick start

Already have a PAM Native project? Add only this capability:

pam composer require pushinbr/pam-native-media-editor
pam doctor --fix

New to PAM? Follow the five-minute PAM Native setup once, then return here. Your application stays a normal Composer project with a committed lockfile.

See it in action

This package is a non-destructive native editing primitive. It does not install a feed, social, commerce, or streaming application template. Android uses Media3 Transformer; iOS uses AVFoundation and Core Image. Encoded media does not cross the PHP boundary frame by frame.

use Pam\Native\MediaEditor\MediaClip;
use Pam\Native\MediaEditor\MediaCrop;
use Pam\Native\MediaEditor\MediaEditor;
use Pam\Native\MediaEditor\MediaExportOptions;
use Pam\Native\MediaEditor\MediaFilter;
use Pam\Native\MediaEditor\MediaTimeline;

$timeline = new MediaTimeline([
    new MediaClip(
        source: 'imports/clip.mp4',
        startMillis: 1_000,
        endMillis: 8_000,
        crop: new MediaCrop(0.1, 0.1, 0.8, 0.8),
        filter: MediaFilter::Vivid,
    ),
], soundtrack: 'imports/music.m4a', soundtrackVolume: 0.35);

(new MediaEditor())->export(
    $timeline,
    new MediaExportOptions('exports/final.mp4'),
    function ($result): void {
        // Persist or share $result->path after ExportState::Completed.
    },
);

All sources and destinations are relative to the application sandbox. States, filters and codecs are sequential integer-backed enums. Poll status() for progress and use cancel() with the same job identifier for lifecycle-safe cancellation.

Platform support: Android API 26+, iOS 15+, PHP 8.5+, and PAM Native 0.8.x.

pushinbr / pam-native-media-editor

Maintainers

Package info

Statistics

Security