README

Render still SVG frames from Lottie animations on the server — useful for previews, thumbnails, and CMS integrations without a browser runtime.

Supports Lottie JSON (.json) and dotLottie (.lottie) files.

Requirements

• PHP 8.1+
• ext-zip (for .lottie archives)

Installation

composer require aarsteinmedia/lottie-php

Usage

Render a single frame to an SVG string:

use LottiePHP\LottieToSVG;

$svg = LottieToSVG::renderFrame('/path/to/animation.json');

By default, the middle frame is rendered. Pass a frame index to pick another:

$svg = LottieToSVG::renderFrame('/path/to/animation.json', frame: 0);

Optional renderer settings (size, aspect ratio, CSS class, etc.):

$svg = LottieToSVG::renderFrame('/path/to/animation.lottie', [
    'width' => 512,
    'height' => 512,
    'preserveAspectRatio' => 'xMidYMid meet',
], frame: 0);

Batch rendering

When rendering many frames from the same file, load once and reuse the animation instance:

$anim = LottieToSVG::loadCached('/path/to/animation.json');

foreach ([0, 15, 30] as $frame) {
    $svg = LottieToSVG::renderFrameFromAnimation($anim, $frame);
}

loadCached() skips re-parsing when the file path and modification time are unchanged. renderFrame() uses this automatically when no custom renderer settings are passed.

Development

Clone the repo, run composer install, then start the visual smoke-test UI:

composer visual:up

Open http://localhost:8000 to browse sample animations and inspect rendered SVG output.

Other scripts: composer lint, composer visual:down, composer visual:logs.