In rare situations, Isadora may crash on startup. Here are the three most common situations that cause this issue and what to do to fix it.

macOS: Check for Corrupted Fonts

If you have one or more corrupted fonts on your computer, they may cause Isadora to crash on startup.

To help you with this problem, we've created an small command line application called TestAllFonts that will list any corrupted fonts found on your system. Here's how to use it:

  1. Download the attached file unzip it. (The download link is at the bottom of this page.)
  2. Double-click the TestAllFonts script.
  3. Grant permission to run the script if macOS asks you to do this.

The typical output might looks something like this.

Found 797 Fonts to Examine
ERROR at Index 670:
  path:         /Users/UserName/Library/Fonts/BadFont.otf
  ps name:      Earth_REV2
  display name: NULL
  family name:  Earth 2
  style name:   Medium
  weight:       0.200000
  width:        0.000000
  sym traits:   NULL

When a bad font is found, the script will print "ERROR at Index XXX" and list information about the font below.

To remove the font:

  1. Follow these instructions from Apple to remove the font using Apple's Font Book application.
  2. Alternatively, you can open the path listed next to the word "path:" and delete the font manually.
  3. Once you've removed all the bad fonts, reboot your computer and try to open isadora again.

If no bad fonts were found, or if Isadora still crashes after following the procedure above, please try manually deleting the Isadora preferences as described below.

Windows: Disable Nahimic Audio Drivers if They Are Installed

On some computers the Nahimic Audio drivers are automatically installed; often using older, out of date versions. These drivers have caused problems for a wide range of applications, even non-audio applications like Microsoft Office.

Often, disabling the Nahimic Audio Service will solve the problem.

To disable the service, please do the following:

  1. Press Windows + R to open the Run dialog, type services.msc in the dialog and press the OK button to open the Windows Services manager.
  2. Look for anything in this list that has the word "Nahimic" in it. (Press "n" after the window opens to quickly jump to the the first item in the list that starts with 'n'.)
  3. For each item you find with Nahimic in it, right-click the item and choose Properties from the menu.
  4. Fnd the word Startup Type in the General tab of the Properties window that opens.
  5. In the drop-down menu next to Startup Type, choose Disabled.
  6. After doing this with all the Nahimic items, reboot your computer and try to open Isadora again.

If you don't find anything related to Nahimic in the Windows Servers manager, or if the procedure above doesn't solve your problem, please try manually deleting the Isadora preferences as described below.

macOS or PC: Manually Delete the Isadora Preferences

If the suggestions above don't help, it could be that your Isadora Preferences have become corrupt. Please follow these instructions to manually delete the Isadora Preferences.

What to Do if Isadora Still Crashes

If the suggestions above don't solve your crash, please open a ticket with our support team for help with your crash.