Installing a UXP panel (from a CCX file)

This page offers instructions on how to install a UXP panel locally from a downloaded CCX file (this apples to the new UXP version of Lumenzia, ie Lumenzia v10 or later). If you do not have at least the minimum required version of Photoshop (see the release notes), you will need to run the CEP version, Lumenzia v9 (see here to install v9, which supports Photoshop CS6 and older versions of CC).

If you are trying to install Web Sharp Pro - that is also a UXP panel, but is distributed through the Adobe marketplace rather than as a standalone CCX file (see here to install through the Adobe Marketplace).

Installing from a CCX file:

  • The Lumenzia ZIP file contains both the older CEP/Flash versions of Lumenzia and the newer UXP version. Just locate the file with the CCX file and double-click it.
  • DO NOT use "open with" or try to open the CCX file with either Photoshop or the Adobe installer. This will fail. The correct app is a hidden Adobe helper app (UPIA) that you wouldn't know about (it then loads the CCX in the Adobe installer, but that installer will not accept the file directly). If you have changed the default app, please see the steps below to change it back to the correct app.
  • This should open the Adobe Creative Cloud Desktop (CCD) installer and ask you to confirm you wish to install.
  • Go to the Plugins menu in PS if you do not automatically see the panel open in Photoshop (it won't show if Photoshop was closed during installation).

That's one of the main benefits of UXP, these panels are quite easy to install generally.

Note that if you have the CEP version of Lumenzia installed, it may be ideal (but is certainly not required) that you uninstall it or close it so that you free maximum resources for Photoshop. Simply closing it and restarting Photoshop gives you all the benefit, uninstalling it will save a tiny bit of extra space on your drive.

If you run into problems, please see the troubleshooting section below.

Troubleshooting

CCD warns "compatible app required":

  • Lumenzia v11 requires Photoshop v23.3 or later. Web Sharp Pro v5 requires Photoshop v24.0 or later. If you have an older version of Photoshop, you may install Lumenzia v9 (which comes in the same ZIP download as the latest version, but has a different install method using a JSXBIN file). [version requirements updated April, 2023]
  • Please check that CCD actually shows Photoshop as installed. There is a bug where PS may be installed, but the Adobe installer does not recognize it. If that is the case, just click to install PS. This should show it again in the installer, and then you'll be able to install PS plugins.
  • Please see Adobe's support site for more info: https://helpx.adobe.com/creative-cloud/kb/troubleshoot-common-addon-installation-issues.html

The CCX file won't open or you get a warning "Creative Cloud cannot open files of this type." or "Could not complete your request because Photoshop does not recognize this type of file":

  • DO NOT try to open the CCX file via "open with" or by otherwise directing which app to open the CCX file. If the Adobe installer is properly installed, the correct helper app (UPIA) should automatically be used when you open the CCX via double-click (ie, don't try to outsmart the system).
  • This may indicate that you do not have the Creative Cloud Desktop app installed. If you have Photoshop CC, then you should have this.
  • This more likely may indicate that the CCX file extension is not pointing to the correct Adobe app. While the app you see is Creative Cloud Desktop, installing a local CCX file actually occurs through a helper app (UPIA: Unified Plugin Installer Agent). Make sure that your operating system is pointing to the correct app (UPIA):

    Windows:
    C:\Program Files\Common Files\Adobe\Adobe Desktop Common\RemoteComponents\UPI\UnifiedPluginInstallerAgent\UnifiedPluginInstallerAgent

    MacOs:
    /Library/Application Support/Adobe/Adobe Desktop Common/RemoteComponents/UPI/UnifiedPluginInstallerAgent/UnifiedPluginInstallerAgent
    (it is likely a hidden folder, you can use cmd-shift-period to see hidden files if needed)
  • You should likely be able to drag a CCX file and drop it onto UnifiedPluginInstallerAgent to install it, but updating the file association to run by default should fix things long term.
  • To change file association in MacOS, right click the CCX file, change the "open with" to UPIA (via the path above), and then click "change all" so that all CCX files will use it (otherwise just that single CCX file will use it and future updates or other panels will not).
  • If you're still having trouble, please contact Adobe ([email protected]) to help understand why your system will not install a valid CCX.

When I double-click, CCD never opens to finish installing (though a black screen may briefly open and close):

  • This likely is the UPIA (Unified Plugin Installer Agent) helper app opening and then failing to launch CCD. I've only had a few reports of this, but in one case the resolution was to move the CCX file to the desktop and then install from there. You may also try using the CCD repair feature (see the steps under guidance for error -2).
  • If you migrated your computer after installing CCD, the file association to open CCX files with UPIA may not have been set (ie your operating system isn't set up to open the CCX file with the correct installer). See details to repair CCD below (this will re-establish UPIA as the correct program to open CCX files for installation). ***
  • Make sure defensive or anti-virus software like Avast or Ashampoo are not blocking access to the folder where you've put the CCX file (the desktop tends to be a good place to put CCX files before you double-click them). Permissions errors tend not to result in clear error messages from UPIA.
  • If on Windows, make sure you have not set your TEMP path to use something other than the C: drive. You would do this via Advanced system settings / Environmental Variables / setting the "value" for "TEMP" to something other than "C:\temp". This is an unusual situation and would only happen if someone had made the change on your system (such as to reduce wear or use of your boot drive).
  • Try running UPIA from the command line. This should help at least show errors to understand the issue. Please see Adobe's list of error numbers (far down the page) to interpret any cryptic errors. To run UPIA from the command line, copy and paste the appropriate command below into the Windows Command Prompt or MacOS Terminal (be sure to copy the entire red text as a single line, update the CCX file path based on where you've actually unzipped that file, and leave quotes around the file paths). Note that you can easily generate the correct file path by dragging the file into the command line (delete back to the first quote, drag and drop, then add the closing quote to replace the italic text below and preserve the quotes).

    Windows Command Prompt:
    "C:\Program Files\Common Files\Adobe\Adobe Desktop Common\RemoteComponents\UPI\UnifiedPluginInstallerAgent\UnifiedPluginInstallerAgent.exe" /install "C:\Users\myUserName\Desktop\Lumenzia ##-##-##.ccx"

    MacOS Terminal:
    "/Library/Application Support/Adobe/Adobe Desktop Common/RemoteComponents/UPI/UnifiedPluginInstallerAgent/UnifiedPluginInstallerAgent.app/Contents/MacOS/UnifiedPluginInstallerAgent" --install "/Users/myUserName/Desktop/Lumenzia ##-##-##.ccx"
  • If installing via UPIA from the command line fails or does not produce an error code which may help resolve the issue, it may help to use the Adobe log collector tool to gather information on UPIA to send to Adobe ([email protected]).
  • The UPIA error codes can be a little tricky to find, here's a more complete list: https://community.adobe.com/t5/exchange-discussions/exmancmd-amp-upia-error-codes-as-of-oct-31-2022/m-p/13338362#M4548

I installed the panel, but cannot see it in Photoshop:

  • Go to the "Plugins" menu in Photoshop to launch any installed UXP panels (older CEP panels are under a different menu area: Window / Extensions)
  • Make sure you are running the latest version of Photoshop (my panels require PS v23 or later as of April 2022).
  • If it is installed in CCD (Creative Cloud Desktop) but does not show under the Plugins menu in Photoshop, you may need to repair CCD. See details to repair CCD below. ***

Adobe Creative Cloud : Error -2:

  • Make sure you have the CCX file on the same drive where Photoshop is installed (typically the boot drive) and then double-click it there.
  • Check that you have reasonable free space on the drive.
  • Try moving the CCX to the desktop to ensure you aren't working from a preview or using a location with restricted permissions.
  • Make sure you have used "extract all" to unzip the original ZIP download. If you click into the ZIP on Windows, you can view the CCX file without ever having actually created it as a standalone file on your system. Note: never unzip the CCX file, it needs to remain a single CCX file (even though it is internally a special ZIP format and can be unzipped).
  • The most common cause of this error is a problem with permissions. Repairing the Adobe installer should help resolve the issue, see details below. ***
  • Reported to help by 1 person: On MacOS, try repairing disk permissions via Disk Utility / First Aid.
  • Reported to help by 1 person: Restart the computer. Permissions for downloads and the desktop had not been granted, but the prompt from CCD/MacOS didn't show until after restarting the computer and trying again.
  • If the previous steps do not work, you may need to do a full reinstallation. Use the "uninstall" option and then reinstall Adobe Creative Cloud.
  • If still stuck, please see the "Still facing issues?" section at https://helpx.adobe.com/in/creative-cloud/kb/troubleshoot-common-addon-installation-issues.html#still-facing-issues to submit detail directly to Adobe for further help.
  • Another Adobe tip here.

Adobe Creative Cloud : Error -10:

  • Make sure you have the CCX file on the same drive where Photoshop is installed (typically the boot drive) and then double-click it there.
  • Reported by to help by 1 person: move the CCX into the main Adobe folder in program files (where photoshop is located).

Adobe Creative Cloud : Error -410:

  • This error is rare, but misleading. The official code says EXMAN_FAILED_INVALID_PLUGIN_FILE, but the resolution in every case has been a deep reinstallation of the Adobe software (the CCX file was never the issue).
  • The solution which has worked: fully uninstall all the Adobe software (including the installer and preferences) and then reinstall. You might use the Adobe CC Cleaner tool.

For more detail on error messages from Adobe Creative Cloud installer:

*** To Repair CCD (Creative Cloud Desktop):

  • There is a repair option within the uninstall tool. Run "Uninstall Adobe Creative Cloud" located next to "Adobe Creative Cloud" app (on a Mac, these are both in Applications / Adobe Creative Cloud). Start the uninstaller, enter your password, and then click "REPAIR" instead of uninstall. This does not remove the installer or your Adobe apps.