Aperture 2: Troubleshooting Basics
If Aperture isn't starting up properly or performing normally, try these basic steps to troubleshoot the situation. Please note that these steps aren't exhaustive and are not intended to cover any specific issue. These are fundamental, basic steps for getting Aperture into good working order, and are the steps most often suggested by AppleCare Technical Support.
Aperture 1.0, Aperture 1.1, Aperture 1.5, Aperture 2.x
Confirm requirements and versions
- Check system requirements
Make sure that you haven't overlooked any hardware aspect that's required to use Aperture. You can view the system requirements on the Aperture Technical Specifications page.
- Check for camera compatibility
Make sure that your camera's digital RAW format is compatible. You can find a list of compatible cameras on the Aperture RAW Cameras page.
- Update to the latest software versions
Choose Software Update from the Apple () menu to make sure that you have the most recent updates for your versions of Aperture, Mac OS X, and other important system files. Installing updates ensures that your software has the latest improvements and enhancements.
- Check for Pro Application Support updates
Make sure you are using the latest version of Pro Application Support. For more information click here.
Perform a Consistency Check on the library
Press and hold the Command and Option keys while you open Aperture. The following dialog should appear:
Click Consistency Check. This will optimize the library database and repair permissions.
Restore the library
Restore your library from a recently backed up vault.
Delete the user preferences
You can resolve many issues by restoring Aperture back to its original settings. This will not impact your image files or your library. To reset your Aperture user preference settings to their original state, do the following:
- In the Finder, go to ~/Library/Preferences. Note: The tilde (~) represents your Home folder.
- Remove the "com.apple.Aperture.plist" file from the Preferences folder.
Defer preview generation
If Aperture does not open, it may help to defer creation of previews. In Aperture 1.5.2 or later, press the Shift key immediately after you start Aperture to prevent preview generation for that session. If a damaged image in your library is preventing normal opening, this may allow you to start Aperture.
Move the user created presets, keyword lists, etc.
- In the Finder, go to ~/Library/Application Support/Aperture.
- Move the contents of this folder to your Desktop
- Open Aperture and see if the issue is resolved. Note: Permanently removing these files will delete presets, metadata sets, keyword sets, and so on. If moving these files to the Desktop does not resolve the issue, move them back to their original location to restore the presets and data sets. In no case will removing these files affect metadata, keywords, or adjustments already applied to images.
Remove receipts and reinstall Aperture
Another approach you might consider is reinstalling Aperture. To do this effectively, you need to remove the application and its receipts, then install Aperture and use Software Update to install additional updates. You don't have to remove everything that was installed with Aperture. Follow the steps below to completely reinstall a fresh copy of Aperture.
Note: Make sure that you have your installation discs nearby before starting this.
- Open the Applications folder.
- Drag the Aperture application to the Trash.
- Go to /Library/Receipts.
- In the Receipts folder, select the "Aperture.pkg" and "ApertureSampleProjects.pkg" files. Note: If you have Aperture 1.5 also select the "PluginManager.pkg" file.
- Drag the those .pkg files to the Trash.
- Insert your Aperture installation disc and install Aperture.
- When finished, choose Software Update from the Apple () menu to update your software to the latest version.
For further information on settings or installation, please refer to the Aperture documentation available on your installation discs.