pyshiftae

Automate Adobe After Effects projects, layers, and effects using Python via the PyShiftAE bridge.

4|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/ki2pixel/After-Effects-Scripts-Plugins-Bundle --skill pyshiftae-ki2pixel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pyshiftae
Source: https://github.com/ki2pixel/After-Effects-Scripts-Plugins-Bundle/tree/main/.windsurf/skills/pyshiftae
Command: npx skills add https://github.com/ki2pixel/After-Effects-Scripts-Plugins-Bundle --skill pyshiftae-ki2pixel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing and debugging Python automation for Adobe After Effects is difficult because PyShiftAE differs from ExtendScript in indexing, threading, and object lifetimes, and installation failures (wheel mismatches, missing runtime files) are hard to diagnose. This Skill provides expert guidance on the PyShiftAE API, production-safe patterns, and troubleshooting so scripts work reliably against the native PyShiftAE.aex / PyFx bridge. ## Core Features & Use Cases - AE Object Automation: Manipulate projects, comps, layers, properties, effects, and masks through high-level classes like Project, CompItem, Layer, Effect, and Mask. - Production-Safe Patterns: Apply undo groups, quiet error handling, main-thread scheduling rules, and pointer-lifetime practices to avoid crashes and invalid references. - Hybrid 2.0 CEP Bridge: Design single-daemon, multi-panel architectures using named pipes with mailbox JSON fallback for CEP-to-Python communication. - Use Case: A motion designer needs to batch-set opacity on selected layers and apply Gaussian Blur by matchName; the Skill provides the exact PyShiftAE calls wrapped in an UndoGroup so the operation is atomic and undoable. ## Quick Start Ask the assistant to write a PyShiftAE script that gets the active layer, applies an effect by matchName, and sets its opacity inside an undo group.

Frequently Asked Questions about pyshiftae

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate After Effects with Python using PyShiftAE?

Import pyshiftae and use entry points like Layer.active_layer(), Item.active_item(), or Project() to access AE objects. Then call methods such as comp.layers.add_solid() or Effect.apply(layer, matchName) and write values with property.set_value().

How to apply an effect to a layer in PyShiftAE?

Use Effect.apply(layer, "ADBE Gaussian Blur 2") with either the matchName or the display name. MatchName is more reliable for identifying effects and properties across AE versions.

Why does import pyshiftae fail in After Effects?

Import failures usually mean a wheel/runtime version mismatch or missing portable Python files next to AfterFX.exe. Verify the wheel tag matches your Python version (3.11-3.13), run psc-install, and restart AE holding Shift to rescan plugins.

Does PyShiftAE support macOS or Linux?

No. PyShiftAE in this repository targets Windows 10/11 x64 with After Effects 2023+ and CPython 3.11-3.13 only. macOS and Linux builds are not shipped.

How is PyShiftAE different from ExtendScript?

PyShiftAE is a Python API built on the native PyShiftAE.aex plugin exposing SDK suites through PyFx, not ExtendScript. Its collections are 0-based from the Python side, unlike ExtendScript's 1-based indexing.

Can I call PyShiftAE from a worker thread?

All AE SDK calls must run on the AE main thread via the TaskScheduler. Pass pure data through queues from worker threads and reacquire AE handles on the main thread before mutating objects.