====================== Troubleshooting & FAQ ====================== Helping us solve problems -------------------------- Please open a support ticket on `aescripts.com `_. In this ticket, describe the error (sreenshots or recordings help alot!). You can also upload a project file, which produces the error and attach the logfiles created by the plugin, as explained here: :ref:`Log sending` Crash in GPU version --------------------- In case you experience random crashes, it may be due to the GPU driver being shutdown by the OS if a computation takes too long. Please follow the instructions here to make your GPU support longer computations: https://substance3d.adobe.com/documentation/spdoc/gpu-drivers-crash-with-long-computations-tdr-crash-128745489.html Legal notice: Please note that editing the registry can have serious, unexpected consequences to the system. However, it is not expected that the linked instructions cause such issues. Blace Plugins takes no responsibility for any damage caused to your system by modifying the system registry. .. _Log Sending: Send us a log ---------------- Under ``C:\Users\\AppData\Local\blace-plugins\`` (Windows) and ``~/Library/Logs/blace-plugins/`` or ``~/Library/Application Support/blace-plugins/`` (MacOS, ~ is the user folder) you'll find log files. Please send them to us via the aescripts support ticket. Manual log ---------------- Open a console / terminal and run ``/Applications/Adobe\ After\ Effects\ 2023/Adobe\ After\ Effects\ 2023.app/Contents/MacOS/After\ Effects`` (MacOS). After you applied the effect / ran into a bug copy the consoles content and send it via the bug ticket. Premiere Pro ----------------------- If the plugin does not show in the effects panel, please start Premiere with the Shift key pressed (will reset plugin cache). Additionally send us the plugin loading log under ``\AppData\Roaming\Adobe\Premiere Pro\\Plugin Loading.log``. Parallel usage on Windows -------------------------- We are investigating a bug at the moment which leads to a crash on Windows if you use several of our plugins in the same project. The current workaround is to only have only one of our plugins applied at the same time. If you want to use another plugin, unfortunately you have to restart After Effects. In the worst case you have to render out the intermediate results of the one plugin and load them in a project using another plugin. This is very unfortunate and we are working very hard to provide a fix. The reason for this behaviour is not easy to fix and requires some deep restructuring. Compatibility with BSKL products --------------------------------- Sometimes our plugins may fail to load if a plugin by BSKL is installed on your system. This is due to the fact that we are using the same ai library. If you encounter this issue, you have to move the BSKL folder out of ``C:\\Program Files\\Adobe\\Common\\Plug-ins\\7.0\\MediaCore`` on Windows and ``/Library/Application Support/Adobe/Common/Plug-ins/7.0/MediaCore`` on MacOS. Installation problems ----------------------- You find the installation log under ``%TEMP%\blace-plugins\installerlog.txt`` (Windows) and ``~/Library/blacetemp`` (MacOS). Please send this file over. If you encounter an error during installation, please check the following points: * Deactivate your VPN if active. * Check your OS and your router for firewall setting which might block a connection to blaceplugins.com. If the error persists, please open a terminal / console and run: * ``pathping blaceplugins.com`` on Windows * ``traceroute blaceplugins.com`` on Mac Additionally check if you can access the domain from a different device in the same network, or from the same device but in a different network (setting your smartphone as hotspot e.g. and connecting to it). This will help trace down the problem. After completion of the command, send us the result via support ticket. Effect cannot be initialized ------------------------------ Please send over the file **Plugin Loading.log** found under ``C:\Users\\AppData\Roaming\Adobe\After Effects\`` . Prerendering ----------------------- Enabled pre-rendering can cause AE to become unresponsive because the plugins computations are often heavy and run for many frames in advance. Please disable it under Composition -> Preview -> Cache Frames When Idle. Problems with aescripts manager app ------------------------------------ Should you ever encounter issues with starting our installers from the aescripts manager app, please download the installer directly from the respective product page on aescripts.com. Check dependencies ----------------------- 1. Download our dependency checker tool: https://www.blaceplugins.com/download/tools/dependency-checker_v102.zip 2. Unzip and open folder. 3. Open "plugin-name.txt" and set name of plugin you want to check (e.g. Mask Prompter). 4. Double-click "check.bat", this will open a console. Agree to license, and wait for tool to finish. 5. Send us result.txt file. MacOS Loading Check ----------------------- 1. Start After Effects and open a new (empty) project. Create a comp with a single layer. 2. Open MacOS app "Console" and click "Start". This will start to log messages from After Effects. 3. In AE, add the plugin. (You possibly get an error message now). 4. Go back to the console and click "Pause". 5. In the Console search field, enter the plugin name without spaces (like MaskPrompter or IAteMushrooms). 6. You should see an error message now in the log window. Click it and send us the output from the black box on the Console Windows bottom. Debugging with Process Monitor ------------------------------- 1. Download Process Monitor from `https://learn.microsoft.com/en-us/sysinternals/downloads/procmon `_ 2. Download filter from `https://www.blaceplugins.com/download/tools/After%20Effects%20Filter.PMF `_ 3. Unzip and run Procmon64.exe 4. In Process Monitor, go to Filter -> Organize Filters -> Import... and select and open the After Effects Filter.PMF. .. image:: img/procmon_load_filter.png 5. Click ok to close the Organize Filters window. 6. Click Filter -> Load Filter -> After Effects Filter. 7. Start After Effects, create a new composition. 8. In Process Monitor click the Rectangle symbol in top left corner (or press Ctrl+E) to start capturing if it is not pressed already. .. image:: img/procmon_rectangle.PNG 9. In After Effects apply the plugin and wait for error message. 10. In Process Monitor press the rectangle symbol again to stop the capturing process. .. image:: img/procmon_capturing.png 11. Click File -> Save and save the logs on disk. 12. Send over the saved file via the support ticket.