
Troubleshooting
On a Mac, use ⌘ in place of Ctrl, and Option in place of Alt. Where this page says Edit › Preferences, choose EffectCraft › Settings… on a Mac.
EffectCraft doesn’t use my graphics card
Section titled “EffectCraft doesn’t use my graphics card”Choose Help › System Compatibility Report… and look at the GPU and Window graphics lines. If it says “GPU: none (CPU compositing)”, the graphics card compositor didn’t start, and the reason is shown next to it. EffectCraft still works, but previews are slower.
The Previews page of Edit › Preferences has a GPU Information… button with more detail.
Try the compatibility graphics mode
Section titled “Try the compatibility graphics mode”- Choose Edit › Preferences, then the Startup & Repair page.
- Set Window Graphics to OpenGL (compatibility). The default is Automatic.
- Restart EffectCraft.
OpenGL always composites on the CPU, so this helps the window open reliably but won’t make previews faster.
NVIDIA graphics on Windows 11
Section titled “NVIDIA graphics on Windows 11”On some Windows 11 PCs with NVIDIA graphics, the compositor fails to start on DirectX 12 but works on Vulkan. This is a known issue.
Footage is missing or offline
Section titled “Footage is missing or offline”Footage goes missing when its file is moved, renamed or deleted, or when you open a project from another computer.
- File › Dependencies › Find Missing Footage selects every missing item in the Project panel.
- File › Dependencies › Relink Missing Footage… points missing items at their new folder. It isn’t in the browser version.
- File › Replace Footage › File… (Ctrl+H) points one item at another file.
- File › Reload Footage (Ctrl+Alt+L) reads the file again after you change it.
I can’t drag files onto the window on Linux
Section titled “I can’t drag files onto the window on Linux”Dropping files doesn’t work when EffectCraft runs natively on Wayland. Use File › Import › File… instead, or start EffectCraft through XWayland:
env -u WAYLAND_DISPLAY effectcraftEffectCraft crashed and I lost work
Section titled “EffectCraft crashed and I lost work”EffectCraft auto-saves your projects. Set it up on the Project page of Edit › Preferences, under Auto-Save:
- Automatically Save Projects turns it on or off.
- Save Every sets how often, in minutes.
- Maximum Project Versions sets how many auto-saves to keep.
- Auto-Save Location keeps them Next to Project or in a Custom Location.
- Save When Starting Render Queue saves before each render.
After a crash, EffectCraft offers to open the latest auto-save. Turn this on or off with Offer to Open the Latest Auto-Save After a Crash on the Startup & Repair page.
No sound, or sound plays late
Section titled “No sound, or sound plays late”Check these first:
- Composition › Preview › Audio is on.
- The Audio page of Edit › Preferences is set to the output you expect.
If it still stays silent, add a note to #3095 with your system and file type.
The browser version takes a long time to open
Section titled “The browser version takes a long time to open”The first time you open the web version, it can take a couple of minutes before the window appears, and the page may look frozen while it loads. EffectCraft is a large app, and the browser has to download and prepare it first.
- Wait, and keep the tab in front. Don’t reload the page while it loads.
- Use a recent Chrome or Edge, which have WebGPU.
- Your projects and settings are kept in that browser, for that web address. They aren’t there if you open EffectCraft from a different address or another browser.
Known problems, not fixed yet
Section titled “Known problems, not fixed yet”- No sound from any file on some Windows PCs: #3095, #3033.
- Save As fails with “File not found” on Windows, seen with a OneDrive folder: #3016.
- On Linux, Tab doesn’t switch between composition tabs: #3013.
- On Linux, Alt-click on a stopwatch doesn’t add an expression: #3192.
- On a Mac, the file dialog of File › Import › After Effects Project… can crash EffectCraft: #3084.
Get a log for a bug report
Section titled “Get a log for a bug report”Choose Help › Enable Logging, then do what caused the problem again. Help › Reveal Logging File shows where the log is.
Still stuck?
Section titled “Still stuck?”Ask on Discord, or open an issue on GitHub. Include the text from Help › System Compatibility Report… and, if you have one, the log.