Troubleshooting

Frame By Plane troubleshooting

The image plane is pink

Pink usually means Blender cannot find the source image. Confirm that the file still exists, use Blender's missing-file tools to relink it, or reimport the sequence if its folder structure changed.

Animation timing is incorrect

Check Start Frame, FPS, Offset and Loop Mode; confirm that filenames form a numbered sequence and that the timeline includes the expected range. Test the same source in a new Blender file to separate media issues from project state.

Transparency is missing

Confirm that the source contains alpha, use an alpha-capable format such as PNG, check blend and material settings, and temporarily disable effects or masks to locate the stage changing transparency.

Blender becomes slow

Use lower-resolution working media, disable expensive effects during layout, reduce alpha-cutout or generated-geometry quality, and hide unused layers. Platform-specific packages are smaller than an all-platform bundle.

The Blender add-on does not install

Confirm that Blender reports version 5.2.x and that the package matches the computer architecture. Install the platform ZIP directly through Edit > Preferences > Get Extensions > Install from Disk; do not extract it.

The valid release package contains blender_manifest.toml at its root and ends with a platform name such as windows_x64.

PSD or Procreate import is unavailable

Install a platform-specific release package. It includes compatible Pillow and psd-tools wheels; the source archive does not add the native dependencies automatically.

A Grease Pencil effect appears more than once

Update to 7.1.18. For a project previously edited with 7.1.17, use Repair Duplicates when the Grease Pencil Effect Stack reports the issue. Frame By Plane preserves untagged artist-authored effects.

Effect controls do not stay open or closed

Update to 7.1.18 or later. The state now persists on the owning Grease Pencil object when Blender rejects metadata on the native effect item. The stack-header arrows expand or collapse every active effect.

Compositor Safe Repair cancels

Safe Repair stops when it cannot capture a complete graph snapshot. Save a copy, run Project Health, and include the diagnostic report in a GitHub issue.

Report a reproducible bug

Include the Frame By Plane version, Blender version, operating system and CPU architecture, exact reproduction steps, the diagnostic report, and a minimal .blend or media sample when it can be shared safely.

Open the Frame By Plane issue tracker