v1.2.1

Mac & Linux: re-download every update

Skip to content

Plugins

Native C++ plugins, modelled on After Effects' plugin APIs, run inside the engine: effects, and since 1.0 commands, panels, importers and export formats, installed from a store.

Download PremationFree, AGPL-3.0-only, for Windows, macOS and Linux

What you can do

16 capabilities. 2 are marked limited or missing, and say why.

A native SDK
SDK 1.2: a versioned C interface with headers you build against, and 1.0 and 1.1 plugins still load. Each effect has one entry point that receives the same kinds of selector calls as After Effects' effect API: about, global and parameter setup, sequence data, frame and smart render, parameter changes, interface updates, and GPU setup and render.
Parameters
Sliders, angles, 2D and 3D points, colours, popups, checkboxes, layer references, mask paths, groups, buttons and arbitrary data. The engine keyframes and evaluates them, so a plugin's parameters undo, animate, take expressions and save like a built-in effect's.
Pixels and time
8-bit, 16-bit and 32-bit float pixel worlds, converted the way After Effects converts for effects that are not depth-aware. An effect can check out another layer, its own layer at another time, and parameter values at other times, and it gets the comp's shutter to render its own motion blur.
The scene
An effect can read the comp camera, the lights and layer transforms, at the frame or at other times, and the depth of the comp's own 3D layers, so it can draw through the comp camera and be hidden behind the scene. Its output can reach past the layer, in layer or composition space.
Beyond effects
New in 1.0, the plugin kinds After Effects splits across AEGP and AEIO: menu commands that edit the project through the engine API (one undo entry each, all rolled back if anything fails), importers for formats the engine cannot read, export formats in the Export dialog and Render Queue, and panels — an HTML page in a sandbox with no network — that dock or pop out into their own window.
Presets and handles
A bundle can ship presets, listed under its effect in the Effects browser, and draw handles in the viewport that drag its parameters.
Per-instance state
Sequence data is stored in the project. A button press changes the data and the parameters as one undo entry.
GPU path
A GPU effect records WebGPU commands into the engine's own command encoder, on its Dawn device, with nothing copied back. A GPU error drops the commands and that frame uses the effect's CPU path.
Crash guards
Every call runs inside a guard. A fault in a render call disables that instance and the frame still renders. A fault in setup fails the plugin's load with the reason listed. A hang past the watchdog quarantines the plugin and restarts the engine. An abort or heap corruption ends the engine, and the next start quarantines the plugin.
Missing never means broken
A plugin that is not installed, disabled or locked passes the layer through. The project keeps every value, the effect card says why, and the effect comes back when the plugin does.
Store
In the installers, Dashboard ▸ Plugins has Store, Installed and Publish. A store install checks the package's hash and its publisher's signature and loads it without a restart; a .pplugin file installs with Install from file or a double-click. Each listing shows an icon, screenshots, an About and notes per version. Third-party plugins are free.
Premation's own plugins
Included with Premation Pro, starting with a 3D model renderer in the Element 3D class. The engine checks a signed entitlement before loading one; without the plan it is locked and passes through with "requires Premation Pro", and renewing brings it back.
Bundles
A folder holding premation-plugin.json and one binary per platform. The manifest and SDK version are checked before the binary is loaded, so a bad plugin is listed as failed with a reason and none of its code has run. A bundle copied into the plugins folder by hand loads on Rescan.
Samples and a test tool
Twelve samples in the repository, among them Ripple (CPU), Grade (GPU), Particles, Model 3D (an Element 3D class sample), Silk Waves, a command (Distribute Layers), an importer (PPM / PFM footage), an export format (PPM sequence) and a panel (Layer Stats). A premation-plugins tool lists, renders and crash-tests a plugin folder without the editor.
ReachNot in it
No custom layer types and no scripting language like ExtendScript. After Effects, OpenFX and FxPlug plugins do not load, and the store is new. Crash guards are not a security sandbox — a native plugin runs with your privileges, so install ones you trust.
JavaScript and WGSL pluginsNot in it
Removed in 0.9.0. Projects that used them still open; their effects and layers are kept in the project (an effect passes the picture through), and one notice names the missing plugins.

Read further

The documentation for this area, in the order it is worth reading.