Skip to main content
Version: 5.x

Troubleshooting Lens Studio Crashes

If you're experiencing consistent crashes while using Lens Studio, The Troubleshooting Lens Studio Crashes guide will help you address the issue and provide recommendations for stable usage.

Troubleshooting Steps​

If you're facing crashes in Lens Studio, here are some steps to follow in order to minimize the occurrence of crashes:

  1. Update Lens Studio to the Latest Version

    • Ensure you are using the most recent version of Lens Studio, as newer versions often include bug fixes and performance improvements that can help prevent crashes.
    • Visit our official download page here to check and install the latest version if you haven't already.

  2. Update Your GPU Drivers

    • Ensure that your GPU (Graphics Processing Unit) drivers are up to date. Outdated drivers can lead to instability in Lens Studio.
    • Visit your GPU manufacturer's website and download the latest drivers for your specific graphics card model.

  3. Clear Lens Studio Cache

    • Clearing the Lens Studio cache can help resolve issues related to corrupted or outdated data.
    • Here are detailed instructions on how to clear Lens Studio cache on PC here, and macOS here.

  4. Reinstall Lens Studio

    • If the problem persists, it's possible that your current installation of Lens Studio is corrupted.
    • To resolve this, uninstall Lens Studio, delete all Lens Studio folders, and then reinstall it from the official website link.

Recommendations for Stable Usage​

To prevent crashes and maintain a stable working environment in Lens Studio, consider the following recommendations:

  1. Close Lens Studio When Not in Use

    • Avoid leaving Lens Studio open for extended periods without any active actions. If you're done working on your project or plan to leave your device idle for a while, save your project and close the Lens Studio application.

  2. Minimize Concurrent Heavy Software Usage

    • Lens Studio is a resource-intensive application, and running multiple heavy software applications simultaneously can strain your system's resources.
    • To ensure smooth operation, avoid running resource-heavy applications alongside Lens Studio.

  3. Regularly Save Your Work

    • Frequently save your Lens Studio projects to prevent data loss in case of unexpected crashes.
    • Consider using version control systems or backup solutions, such as Git, to safeguard your work.
    • Recover Project Files: If Lens Studio crashes before saving your work or if you accidentally delete your project files, we have a guide available on how to recover your project files. You can find the guide here.

  4. Monitor System Resource Usage

    • Keep an eye on your system's resource usage (CPU, RAM, and GPU) while using Lens Studio. If you notice excessive resource consumption, close unnecessary applications to free up resources for Lens Studio.

  5. Report Issues

    • If you still encounter crashes even after following these steps, we encourage you to report the issue to our Lens Studio support team using the "Report Crash" prompt that appears after the crash occurs.
    • Please note that we do not provide support for Lens Studio running on virtual machines.

How to report an issue​

When reporting issues, provide clear and detailed information to help us understand and address the problem efficiently.

  1. Include step-by-step reproduction steps, starting from the initial state of Lens Studio.
  2. Whenever possible, share a simplified Lens Studio project that demonstrates the problem.
  3. Ensure the example project contains the minimal components and assets necessary to replicate the issue.
  4. Include instructions on how to reproduce the problem within the provided project.
  5. Additionally, specify your system's hardware and software configurations, including your operating system, GPU model, CPU, RAM, and information about antivirus, firewall, or similar services that may affect Lens Studio's performance.
  6. Specify whether your project is stored locally or via cloud services, as this information can help us better understand and address the problem
  7. Mention the version of Lens Studio you're using.
  8. Include screenshots or screen recordings that visually illustrate the issue.
  9. Provide any error messages, warnings, or logs related to the issue, along with error codes or messages displayed within Lens Studio.
  10. Indicate how frequently the issue occurs (e.g., always, occasionally, after specific actions).
  11. Mention any contextual information that might be relevant (e.g., network conditions, third-party plugins).

By following these troubleshooting steps and adopting these recommendations, you can work more effectively with Lens Studio while minimizing the risk of crashes. If you encounter any further issues or have additional questions, don't hesitate to reach out to our Lens Studio support team for assistance at lensstudio-support@snapchat.com

Was this page helpful?
Yes
No