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 (ie Lumenzia 10+,). 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.

Alternatively, I've heard reports of success using Anastasiy’s Extension Manager instead of the Adobe installer (I have not personally tested it myself and cannot support it, this is just for your information - I have heard that dragging and dropping the CCX file onto it may be easier than trying to open it from the menus).

Troubleshooting

Most common issues can be resolved by the following:

  • Do not try to open the CCX file with Photoshop (that will always fail). The CCX file can only be opened by UPIA (Unified Plugin Installer Agent), which will then hand the file off to CCD (Creative Cloud Desktop). If you don't see the Adobe installer when double-clicking the CCX, you should use Adobe's repair utility.
  • Make sure Adobe software has full disk permissions (MacOS).
  • Put the CCX file on the desktop and double click there (this can help with permission issues).
  • Make sure the regular version of Photoshop is installed (if you have only the PS beta, the Adobe installer will warn "no compatible app", even though the PS betas can run my software just fine).
  • Note that Adobe software often fails if you install Photoshop on a non-boot drive or have an unusual character (such as an umlaut) in your user name.
  • Avoid using Rosetta (MacOS). My software runs natively and Rosetta will cause Photoshop to run at half speed (and for Web Sharp Pro will prevent the panel from loading).

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 plugin shows as installed and enabled in the Adobe installer (CCD), but is not shown in the Photoshop "Plugins" dropdown menu:

  • 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.
  • Make sure you are installing the latest version of my plugin.
  • Adobe does not support installations where Photoshop or the user account is not on the boot drive. If you do this, your plugins will not work.
  • If Windows Defender or other anti-virus false positive blocks/quarantines files, this may result in the panel not showing in PS.
  • If you have Apple Silicon and launch PS under Rosetta, this may break some panels due to an Adobe bug where Intel binaries are not installed and the native binaries are not used (Web Sharp Pro is affected by this). Just launch PS natively without Rosetta. The latest versions of my software do not need Rosetta, and using it slows down PS by 50% so it is ideal to avoid it.
  • UXP Plugins are not currently supported under the ARM version of Windows.
  • You may need to repair CCD.
  • See the list of known PS issues. The installed panel may not show in PS if you install PS on a non-boot drive, if there are permissions issues, if multiple versions of the UXP plugin are simultaneous installed, if you have unusual characters like an umlaut in your user name on the computer, or if you launch PS under Rosetta.
  • The UXP logs might yield clues to other scenarios where PS refuses to launch an installed plugin.

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 repair CCD (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

The plugin shows as installed and enabled in the Adobe installer (CCD), but is not shown in the Photoshop "Plugins" dropdown menu:

  • 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.
  • Make sure you are installing the latest version of my plugin.
  • 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 above to repair CCD.
  • See the list of known issues. The installed panel may not show in PS if you install PS on a non-boot drive, if there are permissions issues, if multiple versions of the UXP plugin are simultaneous installed, if you have unusual characters like an umlaut in your user name on the computer, or if you launch PS under Rosetta.
  • The UXP logs might yield clues to other scenarios where PS refuses to launch an installed plugin.

Adobe Creative Cloud: Error -2 (this generally stems from permissions errors):

  • 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 CCD (the Adobe installer) should help resolve the issue.
  • 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.
  • On MacOS, make sure you enable permissions (System Settings / Privacy & Security - make sure Photoshop is enabled for Full disk and Accessibility permissions), then try installing again.
  • 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.
  • Try the Adobe tip here.
  • If all else fails, use Adobe's CC Cleaner tool to fully remove all traces of Adobe software and then reinstall.

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:

Repairing or r-installing Adobe software

If the troubleshooting steps above calls for it or you've tried everything else, you may repair or reinstall Adobe software. This can address many stubborn problems installing UXP plugins.

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.

To Re-install Photoshop:

  • First, just uninstall and reinstall Photoshop. Choose the option to keep your preferences. This is fast and avoids resettings your prefs.
  • But if that simple reinstall fails, you may need to do a clean installation. Use Adobe's CC Cleaner tool to fully remove all traces of Adobe software and then reinstall.