If you run into problems with Upscayl, here are a few ways to fix it.
Table of Contents:
- General Fixes (for all platforms)
- Linux
- MacOS
- Windows
Important
You'll need a Vulkan compatible GPU to upscale images. Many CPU and iGPUs do not work but no harm in trying. A GPU is usually either from Nvidia, named an "Arc", or named with the letter R followed by a number or X; anything else is probably an incompatible CPU, which may work but only slowly with a workaround.
Make sure to read the FAQ first to avoid getting rickrolled.
General Fixes
- Update the app.
- Uninstall and Reinstall the app.
- Restart your computer.
- Try setting your GPU ID to your discrete GPU.
🐧 Linux Users
- Make sure graphics drivers are installed, including Vulkan drivers. See https://linuxconfig.org/install-and-test-vulkan-on-linux for details.
- The article doesn't include instructions for Intel on Arch Linux for some reason. Install
vulkan-intel
in this situation.
- The article doesn't include instructions for Intel on Arch Linux for some reason. Install
- Reinstall graphics drivers BUT Before doing that, run VulkanCapsViewer. If it reports Vulkan support, you might not need to do this.
🍎 Mac Users
- Make sure you're using the latest MacOS update.
- If Upscayl refuses to launch, follow these steps:
Click here to view the steps
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 contain 'Upscayl'. 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 named Upscayl)
- ~/Library/Preferences/org.upscayl.Upscayl.plist/
- ~/Library/Preferences/org.upscayl.Upscayl.helper.plist/
🪟 Windows Users
- Set the app to performance mode and make sure you have the right redistributables.
- Try DirectX repair.
- For notebooks with AMD iGPUs: Disable switchable graphics if you can. (thanks @JZeravik!)
- Enable hardware-accelerated GPU scheduling if you can.
- Reinstall graphics drivers BUT Before doing that, run VulkanCapsViewer. If it reports Vulkan support, you might not need to do this.