Introduction
MacOS Troubleshooting
Troubleshooting common issues with Upscayl on MacOS
If you have MacOS Monterey, you may face issues with the app (empty black screen). This is because Monterey had issues with electron apps, this isn’t something we can fix as this is an OS level bug. We recommend upgrading to the latest version of MacOS that your device supports.
-
Make sure you’re using the latest MacOS update.
-
If the app doesn’t work, try deleting all its files and folders:
- Open Finder → Click Go in the menu bar → Select Go to Folder from the drop-down menu → In the window that appears, type ~/Library/ and press Enter.
- Here, in the
Library
folder, find and remove all files which containupscayl
. - Here’s a list of files and folders you can safely delete:
Please do not delete the folders that do not have
upscayl
in their name~/Library/Application Support/Upscayl
~/Library/Saved Application State/org.upscayl.Upscayl.savedState/
~/Library/Group Containers/W2T4W74X87.org.upscayl.Upscayl
~/Library/Containers/Upscayl
and other folders there that haveupscayl
in their name.~/Library/Preferences/org.upscayl.Upscayl.plist/
~/Library/Preferences/org.upscayl.Upscayl.helper.plist/