How do I enable enhanced logging in Silhouette for troubleshooting?

Silhouette supports enhanced logging to help diagnose issues. Enabling enhanced logging increases the level of detail written to Silhouette log files, which can be shared with support for troubleshooting.

Enable enhanced logging in Silhouette on Windows

To enable Silhouette enhanced logging on Windows:

1. Close Silhouette

2. Press Windows + R

3. Type: sysdm.cpl and click OK

4. Go to Advanced > Environment Variables

5. Under User Variables, click New

6. Set the following:

   • Variable name: SFX_DEBUG

   • Variable value: 1

7. Click OK and close all dialogs

8. Launch Silhouette

Silhouette will now run with enhanced logging enabled.

Enable enhanced logging in Silhouette on macOS and Linux

To enable Silhouette enhanced logging on macOS or Linux:

1. Close Silhouette

2. Open a Terminal

3. Set the environment variable:

   export SFX_DEBUG=1

4. Launch Silhouette from the terminal

Example launch paths

macOS:

/Applications/BorisFX/Silhouette <version>/Silhouette.app/Contents/MacOS/Silhouette

Linux:

<install location>/silhouette<version>/Silhouette-<version>

Silhouette will start with enhanced logging enabled for that session.

How to collect Silhouette log files after enabling logging

After reproducing the issue in Silhouette, retrieve the log files from the system.

Log file locations:

• Windows:
  C:\Users\<user>\AppData\Local\BorisFX\Silhouette <version>\

• macOS:
  ~/Library/Logs/BorisFX/Silhouette <version>/

• Linux:
  ~/.cache/BorisFX/Silhouette <version>/

Which Silhouette log file to provide

Silhouette troubleshooting typically requires the main log file:

• silhouette.log

Provide this file to Boris FX support after reproducing the issue with enhanced logging enabled.