iScreensaver : Creating a Debug Log



If you are experiencing a bug during screensaver installation or operation, it may be helpful to create a Debug Log and send it to us. Please email us and check with us first before you do this!
To do so, please follow these steps


If the problem is occuring during Editing or Building within iScreensaver Designer on Macintosh or Windows

  1. Reboot your system.
  2. Holding down the SHIFT key, launch "iScreensaver Designer" (On Windows, simply hit the Return or Enter key, on Macintosh type Apple-O). Remember to keep the shift key held down while you do this until the application has started fully.
  3. Keep holding the SHIFT key down until the installer opens.
  4. Version 3.5: You should now see a file called iScreensaverDebugLog_HHMMSS.txt on your Desktop (HHMMSS is the current time)
  5. Version 3.4 or earlier: You should now see a file called DebugLog.txt in the same folder as the "iScreensaver Designer" program (on Mac, in /Applications, on Windows, in C:\Program Files\iScreensaver Designer)
  6. Do whatever steps you take to cause the crash.
  7. Once you have encountered the bug or crash, please email us a copy of the debug file(s) and error message(s), along with a detailed description of what the improper behavior is.
  8. Mac OS X Only: You should look in two places for error messages:
    1. You may see a bunch of error messages / text in the Console window. Open /Applications/Utilities/Console.app to view them.
    2. You may have a crash log. In the Console window, click the "Logs" button and navigate to "~/Library/Logs/CrashReporter". Look for a crash log named "iScreensaver Designer 3.5"
  9. Copy and paste the log information into an email and send it to us, along with a detailed description of what the improper behavior is


If the problem is occuring during Screensaver Installation on Windows
  1. If you haven't already done so, build your installer, and locate the file on your hard disk.
  2. Reboot your system.
  3. Find the installer, and click it once with the mouse.
  4. Version 3.5 or later:
    • Add the following lines
      [GlobalDebugFlags]
      debugLog=true

      to the file C:\WINDOWS\ISCREENSAVER.INI
    • Activate your screensaver, or do whatever it was that causes the bug.
    • You should now see a file called iScreensaverDebugLog_HHMMSS.txt on your Desktop (HHMMSS is the current time)
  5. Version 3.4 or earlier:
    • Holding down the SHIFT key, open the Display Properties control panel
    • Keep holding down the SHIFT key until the Screensaver Preview shows up in the control panel
    • Activate your screensaver, or do whatever it was that causes the bug.
    • In C:\WINDOWS (or C:\WINNT) you should now see a file called DebugLog.txt
  6. Continue with installation as normal.
  7. Once the install is complete (or you have encountered the bug), please email us a copy of the debug file, along with a detailed description of what the improper behavior is


If the problem is occuring during Screensaver Operation on Windows
  1. If you haven't already done so, build your installer, and install the screensaver.
  2. IMPORTANT: Reboot your system.
  3. Version 3.5 or later:
    • Add the following lines
      [GlobalDebugFlags]
      debugLog=true

      to the file C:\WINDOWS\ISCREENSAVER.INI
    • Activate your screensaver, or do whatever it was that causes the bug.
    • You should now see a file called iScreensaverDebugLog_HHMMSS.txt on your Desktop (HHMMSS is the current time)
  4. Version 3.4 or earlier:
    • Holding down the SHIFT key, open the Display Properties control panel
    • Keep holding down the SHIFT key until the Screensaver Preview shows up in the control panel
    • Activate your screensaver, or do whatever it was that causes the bug.
    • In C:\WINDOWS (or C:\WINNT) you should now see a file called DebugLog.txt
  5. Email us a copy of the debug file along with a detailed description of what the improper behavior is


If the problem is occuring during Screensaver Operation on Mac OS 8.6 or Mac OS 9
  1. If you haven't already done so, build your installer, and install the screensaver.
  2. IMPORTANT: Reboot your system.
  3. IMPORTANT: Wait 10 minutes.
  4. IMPORTANT: Select the Screensaver from the Applications menu, and QUIT it.
  5. Holding down the SHIFT key, select the screensaver from the Apple menu to launch it.
  6. Keep holding down the SHIFT key until the Screensaver control panel is open.
  7. Activate your screensaver (or do whatever was necessary to cause the problem.)
  8. In "System Folder:Control Panels" you should now see a file called DebugLog.txt
  9. Email us a copy of the file DebugLog.txt, along with a detailed description of what the improper behavior is


If the problem is occuring during Screensaver Operation on Mac OS X
  1. If you haven't already done so, build your installer.
  2. Make sure the CAPS-LOCK key is pressed.
  3. Open the Console Application (Applications/Utilities/Console)
  4. Install the screensaver
  5. Under the Screen Saver (Screen Effects) control panel, activate your screensaver (or do whatever it takes to cause the bug)
  6. You should look in two places for error messages:
    1. You may see a bunch of error messages / text in the Console window.
    2. You may have a crash log. In the Console window, click the "Logs" button and navigate to "~/Library/Logs/CrashReporter". Look for a crash log named "SystemPreferences" or "ScreenSaver"
  7. Copy and paste the log information into an email and send it to us, along with a detailed description of what the improper behavior is