Resolve an issue in Compressor

Find out how to isolate, troubleshoot and fix issues in Compressor.

Follow the recommendations below in the order they’re listed until you've isolated or fixed your issue. Before proceeding, make sure to back up any custom Compressor settings and the version of Compressor that you’re updating.

1. Restart your Mac

Restarting your Mac resets Compressor-related system resources. To restart your Mac, choose Apple menu () > Restart, then reopen Compressor and try to reproduce your issue.

2. Disconnect external devices

An incompatible or malfunctioning external device can sometimes cause issues with Compressor. To test external devices:

1. Shut down your Mac.

2. Disconnect all external devices other than the keyboard and mouse.

3. Reset NVRAM. You only need to do this the first time you disconnect external devices.

4. Open Compressor and attempt to reproduce your issue. If your issue no longer occurs, reconnect devices one at a time until you can reproduce your issue. Make sure you restart your Mac after reconnecting a device, if required by the device.

If the issue only occurs with a certain device connected, you may need to update or service the device. Contact the manufacturer for support.

3. Check documentation

Check Compressor Help You can search Compressor Help for key terms shown in alerts or error messages.

4. Check system requirements

Make sure your computer meets Compressor system requirements.

5. Make sure Compressor is up to date

Before updating Compressor, complete any active transcoding projects. Then, back up any custom Compressor settings and the version of Compressor that you’re updating.

To make sure you’re using the latest version of Compressor, choose Apple menu () > App Store, then click Updates in the toolbar. If an update is available, you can click the Update button to download and install it.

6. Verify installation of Pro Video Formats

Make sure you've installed Pro Video Formats.

7. Check media and device compatibility

Make sure you’re using a compatible media format, device and external storage device format. Contact the manufacturer of the device(s) for support. If a software update for the device is available, follow the manufacturer's instructions to update firmware for devices such as cameras and external storage devices, or to update drivers for devices such as interfaces.

8. Check software compatibility

If you’re using third-party plug-ins or other software with Compressor, make sure they are compatible with your version of Compressor. Contact the developer for support. If an update is available, follow the developer's instructions to update the software. If updates aren’t available, remove the plug-in using the method recommended by the developer until a compatible version is available.

9. Test in another user account

Open Compressor in another user account on your Mac. Logging in as another user can help you figure out if unexpected behaviour is related to a specific user's settings or files.

10. Test in a new batch

Start a new batch using known-good media, which is media you've used successfully in other projects. If you can't reproduce the issue using known-good media, the issue might be related to the media in the affected batch. Obtain new copies of the media from the original source.

If you don’t have known-good media available, you can create some using Final Cut Pro and Motion.

• In Final Cut Pro, use a placeholder and a sound effect from Final Cut Pro Additional Content, which you can then share to an Apple ProRes 422 Master File.

• In Motion, use Motion Supplemental Content and export it as a QuickTime movie.

11. Remove the Compressor folder

Try removing the Compressor folder to resolve the issue. Before removing Compressor, back up your custom Compressor settings as follows:

1. Go to Library/Application Support/Compressor/Settings/ in your home folder.

2. Control-click the Settings folder, then choose Compress Settings.

3. Move the resulting .zip file to another location, such as the Desktop.

To remove the Compressor folder:

1. In Compressor, choose Compressor > Preferences, then click My Computer.

2. Make sure 'Allow other computers to process batches on my computer' is turned off.

3. Quit Compressor.

4. In the Finder, hold down the Option key and choose Go > Library.

5. From the Application Support folder, drag the Compressor folder to the Bin.

6. Restart your Mac.

7. Open Compressor.

8. Return to Compressor preferences, turn 'Allow other computers to process batches on my computer' on, then close the preferences window.

12. Remove the Apple Qmaster folder

If you previously installed Compressor versions 3.5 or 4.0-4.0.7 on your Mac, you might have an Apple Qmaster folder, which you should remove.

For Compressor 4.0-4.0.7, do the following:

1. Quit Compressor.

2. In the Finder, hold down the Option key and choose Go > Library.

3. From the Application Support folder, drag the Apple Qmaster folder to the Bin.

4. Restart your Mac.

For Compressor 3.5, do the following:

1. Quit Compressor.

2. From the top level of your hard disk, open the Library folder, then open the Application Support Folder. Drag the Apple Qmaster folder to the Bin.

3. Restart your Mac.

13. Reset Compressor preferences

Resetting preferences doesn't affect your projects or any media in your projects. However, any custom preference settings will be reset to their default settings.

Before resetting preferences, choose Compressor > Preferences and note any specific settings you’ve made. Then back up your custom settings as follows:

1. Go to Library/Application Support/Compressor/Settings/ in your home folder.

2. Control-click the Settings folder, then choose Compress Settings.

3. Move the resulting .zip file to another location, such as the Desktop.

To reset preferences in Compressor 4.3 or later:

1. Restart your Mac.

2. In Finder, hold down the Option key and choose Go > Library.

3. From the Application Support folder, drag the Compressor folder to the Bin.

4. Return to the Library folder and open the Preferences folder. Locate these two files:

   • com.apple.Compressor.plist

   • com.apple.Compressor.LSSharedFileList.plist

5. Drag these files to the Bin.

6. Restart your Mac.

7. Try to reproduce the issue you were experiencing. If the issue no longer occurs, open Compressor preferences and reapply your custom settings. If necessary, restore your backed-up Settings folder.

14. Remove and reinstall Compressor

If your issue persists, remove and reinstall Compressor.

1. In Finder, choose Applications from the Go menu.

2. Locate Compressor and drag it to the Bin.

3. Reinstall Compressor from the Mac App Store or restore it from a backup. When you restore Compressor from a backup, you can either drag it from its storage location to your Applications folder or restore Compressor from a Time Machine backup.

Learn more

• Troubleshooting Distributed Processing

• Create additional instances of Compressor