Installing from a CCX file (requires modern Photoshop):

Unzip the Lumenzia ZIP file, locate the CCX file and double-click it to start installing. This should open the Adobe Creative Cloud Desktop (CCD) installer and ask you to confirm you wish to install.
Note that if you previously installed Lumenzia v9 or older (which is a "CEP" panel rather than "UXP"), you may uninstall it (or just close it in PS) so that you have free maximum resources for Photoshop.
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).
If you run into problems, please see the troubleshooting sections below. DO NOT use "open with" or try to open the CCX file with either Photoshop or the Adobe installer. This will fail. Use the repair tool to ensure "UPIA" is used to open CCX files.

If you use Photoshop CS6 or other old versions of PS (see v11+ requirements in the Lumenzia release notes), you will need to install the older Lumenzia v9 (which is a CEP panel and therefore has a different installation process: see here to install v9).

Most common issues can be resolved by the following:

Avoid permissions issues: put the CCX file on the desktop and double click there and make sure Adobe software has full disk permissions on MacOS.
Make sure the regular version of Photoshop is installed and you have launched it at least once before trying to install a CCX file (while the PS beta supports plugins, the Adobe installer will still warn "no compatible app" if you have not also installed the regular version of PS).
If you don't see the Adobe installer open when you double-click the CCX, use Adobe's repair utility (see below). Do not try to open the CCX file with Photoshop or Creative Cloud Desktop (either will fail). The CCX file can only be directly opened by a hidden utility called UPIA (Unified Plugin Installer Agent), which will then hand the file off to CCD (Creative Cloud Desktop).
Avoid setups Adobe does not support for UXP panels, including: installing Photoshop on a non-boot drive, having an unusual character in your user name (such as an umlaut), using Windows on an ARM processor, or using Rosetta with MacOS (my software runs natively on Apple Silicon and Photoshop is 2x faster without Rosetta).
Watch out for anti-virus software which may produce false positives which blocks/quarantines files.
The most common error is -2, see details below if you see that error code.
See the detailed troubleshooting below for less common issues, or contact Adobe if the above does not work (it may help to use the Adobe log collector tool if you contact them).
Alternatively, use Anastasiy’s Extension Manager instead of the Adobe installer. I have not personally tested it myself and cannot support it, but have heard good feedback. You may dragging and dropping the CCX file onto the app (or open it from the menus).
Or you could use the ZXP / UXP Installer. I have not used this either, but it was recommended by another developer.

To Repair CCD (Creative Cloud Desktop) and ensure the correct app opens CCX files:

There is a repair option within the uninstall tool (using it does not remove the installer or your Adobe apps.)
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.

Note that the default app used to open CCX files is UPIA. The repair tool will fix this, but here are the paths in case you wish to manually fix the file association:

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
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 going forward. Note: this path includes a hidden folder (use cmd-shift-period to see hidden files in MacOS Finder).

To Re-install Photoshop:

First, just uninstall and reinstall Photoshop (choose the option to keep your preferences).
If a simple re-install 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 re-install.

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 and have installed the latest version of my plugin (see release notes for Lumenzia and Web Sharp Pro).
If Windows Defender or other anti-virus false positive blocks/quarantines files, this may result in the panel not showing in PS.
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 (Web Sharp Pro is affected by this).
The UXP logs might yield clues to other scenarios where PS refuses to launch an installed plugin.

CCD warns "compatible app required" or "no compatible app":

This most often indicates that you either have not installed the regular version of PS (they seem to not count the beta even though it works) or are affected by a bug where the Adobe installer no longer realizes PS is installed. Simply install or reinstall PS to fix the issue (you may keep your preferences).
Be sure to launch Photoshop at least once before trying to install the CCX.
See Lumenzia release notes for the minimum version of Photoshop CC supports. If you use Photoshop CS6 or other very old versions, 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]
See Web Sharp Pro release notes for the minimum version of Photoshop supported.
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":

This indicates that the wrong app is being used to open the CCX 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).
Make sure you have the regular version of PS installed (the beta is fine, but you must also have the regular version installed).
Make sure you have launched PS at least once before you try to double-click a CCX file.
Follow the guidance above to repair or reinstall Photoshop so that CCX files are properly opened with UPIA.
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.
If you're still having trouble, please contact Adobe via their official Adobe support form 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 typically means there was an error with UPIA (Unified Plugin Installer Agent), but you'll need to run it in the command line to see the error.
Try running UPIA from the command line (to get error info): 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"
Please see Adobe's list of error numbers (far down the page) to interpret any cryptic errors. Here is the most complete list of UPIA error codes: https://community.adobe.com/t5/exchange-discussions/exmancmd-amp-upia-error-codes-as-of-oct-31-2022/m-p/13338362#M4548
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).

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

The most common cause of this error is a problem with permissions. Repairing CCD (the Adobe installer) should help resolve the issue.
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. Note that having a user folder on a drive other than your main (boot) drive is not supported by Adobe.
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. The downloads folder is often restricted (as the operating system will consider anything downloaded from the internet as higher risk).
MacOS users should ensure that System Settings / Privacy & Security / shows all permissions allowed under "Full disk Access" and "Files & Folders" for Adobe listings (especially Creative Cloud and probably Adobe Desktop Service).
Windows users should make sure to use "extract all" to properly unzip the original ZIP download. If you click into the ZIP on Windows, you are viewing a preview of the CCX rather than using a standalone file on your system.
Never try to unzip the CCX file, this will make it unusable.
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 re-installation. 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.

Meet Lynn.

The founder of Modern PT, Lynn is dedicated to the wellness of each and every person who walks through the door. Lynn opened this center 10 years ago to be a caring, communicative haven for people of all ages to address their pain. When Lynn isn't using her magic touch to ease pain and increase range of motion, she's attending classes and conferences to implement the most innovative practices and technologies to address her patients' needs.

Schedule a tour to see Lynn's novel approach to physical therapy.