@fredlackey/devutils 0.0.1 → 0.0.3

package/src/installs/adobe-creative-cloud.md

@@ -0,0 +1,605 @@
+# Installing Adobe Creative Cloud
+
+## Overview
+
+Adobe Creative Cloud is a subscription-based service that provides access to Adobe's suite of creative applications including Photoshop, Illustrator, Premiere Pro, After Effects, Lightroom, InDesign, and many others. The Creative Cloud Desktop App serves as the central hub for downloading, installing, updating, and managing these applications.
+
+**Important Platform Limitation:** Adobe Creative Cloud is officially supported only on **macOS** and **Windows**. There is no native Linux support from Adobe, which affects Ubuntu, Raspberry Pi OS, Amazon Linux, and other Linux distributions.
+
+## Prerequisites
+
+Before installing Adobe Creative Cloud, ensure you have:
+
+1. **Adobe Account**: A free Adobe ID is required to sign in. Create one at [account.adobe.com](https://account.adobe.com) if you do not have one.
+2. **Subscription**: While the Creative Cloud Desktop App is free, most individual applications require a paid subscription.
+3. **System Requirements**:
+   - macOS 10.15 (Catalina) or later
+   - Windows 10 version 1903 or later (64-bit)
+   - Minimum 4 GB RAM (8 GB recommended)
+   - Minimum 4 GB available hard disk space for installation
+4. **Internet Connection**: Required for initial installation, sign-in, and downloading applications.
+
+---
+
+## Dependencies
+
+### macOS (Homebrew)
+- **Required:**
+  - `homebrew` - Install via `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` or run `dev install homebrew`
+- **Optional:** None
+- **Auto-installed:** None (Homebrew automatically handles all Adobe Creative Cloud system dependencies)
+
+### Ubuntu (APT/Snap)
+Installation not yet supported on this platform. Adobe Creative Cloud is not officially available for Linux distributions.
+
+### Raspberry Pi OS (APT/Snap)
+Installation not yet supported on this platform. Adobe Creative Cloud is not available for ARM-based Linux systems.
+
+### Amazon Linux (DNF/YUM)
+Installation not yet supported on this platform. Adobe Creative Cloud is not officially available for Linux distributions.
+
+### Windows (Chocolatey/winget)
+- **Required:**
+  - `winget` (Windows Package Manager) - Install from Microsoft Store (search for "App Installer") or run `dev install winget`
+- **Optional:** None
+- **Auto-installed:** None (winget automatically handles all Adobe Creative Cloud system dependencies)
+
+### Git Bash (Manual/Portable)
+- **Required:**
+  - `powershell.exe` - Pre-installed on all supported Windows versions (Windows 10 1903+)
+  - `winget` (Windows Package Manager) - Install from Microsoft Store (search for "App Installer") or run `dev install winget`
+- **Optional:** None
+- **Auto-installed:** None
+
+---
+
+## Platform-Specific Installation
+
+### macOS (Homebrew)
+
+Adobe Creative Cloud is available as a Homebrew cask and can be installed non-interactively.
+
+#### Prerequisites
+
+- macOS 10.15 (Catalina) or later
+- Homebrew package manager installed
+- Administrator privileges
+
+Verify Homebrew is installed:
+
+```bash
+brew --version
+```
+
+If Homebrew is not installed, install it first using `dev install homebrew`.
+
+#### Installation Steps
+
+Run the following command to install Adobe Creative Cloud:
+
+```bash
+brew install --cask --quiet adobe-creative-cloud
+```
+
+**Note:** This command may prompt for your administrator password because Adobe Creative Cloud requires elevated privileges to install system components. In fully automated scenarios (such as CI/CD pipelines), ensure the running user has passwordless sudo configured or pre-authorize the installer.
+
+The installation downloads the Creative Cloud Desktop App and installs it to `/Applications/Adobe Creative Cloud/`.
+
+#### Verification
+
+Confirm the installation succeeded:
+
+```bash
+ls -la "/Applications/Adobe Creative Cloud/Adobe Creative Cloud.app" && echo "Adobe Creative Cloud is installed"
+```
+
+You can also launch the application to verify:
+
+```bash
+open "/Applications/Adobe Creative Cloud/Adobe Creative Cloud.app"
+```
+
+#### Troubleshooting
+
+**Installation fails with permission errors:**
+
+```bash
+# Reset Homebrew cask cache and retry
+brew cleanup
+sudo rm -rf /Library/Application\ Support/Adobe/AAMUpdater
+brew install --cask --quiet adobe-creative-cloud
+```
+
+**Installation hangs on Apple Silicon (M1/M2/M3):**
+
+Some users have reported installation issues on Apple Silicon. If this occurs:
+
+```bash
+# Force reinstall with verbose output to identify the issue
+brew reinstall --cask adobe-creative-cloud
+```
+
+**Creative Cloud app crashes on launch:**
+
+Remove preferences and retry:
+
+```bash
+rm -rf ~/Library/Preferences/com.adobe.AdobeCreativeCloud.plist
+rm -rf ~/Library/Application\ Support/Adobe/Creative\ Cloud\ Libraries
+```
+
+---
+
+### Ubuntu/Debian (APT)
+
+**Adobe Creative Cloud is NOT officially supported on Ubuntu or Debian.** Adobe does not provide native Linux packages, and there is no APT or Snap package available.
+
+#### Workaround Options
+
+If you require Adobe Creative Cloud functionality on Ubuntu/Debian, consider these alternatives in order of reliability:
+
+**Option 1: Virtual Machine (Recommended for Production Use)**
+
+Run Windows in a virtual machine to access Adobe Creative Cloud with full compatibility:
+
+```bash
+# Install VirtualBox
+sudo DEBIAN_FRONTEND=noninteractive apt-get update
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y virtualbox
+```
+
+Then install Windows in the VM and follow the Windows installation instructions.
+
+**Option 2: Wine with PlayOnLinux (Experimental)**
+
+Wine can run some older Adobe applications with varying degrees of success. Modern Creative Cloud subscription apps have limited compatibility.
+
+```bash
+# Install PlayOnLinux
+sudo DEBIAN_FRONTEND=noninteractive apt-get update
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y playonlinux
+```
+
+**Important limitations:**
+- Only Photoshop CC (older versions), Bridge CC, and Lightroom 5 have been tested to work
+- The Creative Cloud Desktop App itself has compatibility issues
+- This approach is NOT recommended for professional or production use
+- Adobe does not provide support for Wine-based installations
+
+**Option 3: Adobe Express (Web-Based Alternative)**
+
+Adobe Express (formerly Adobe Spark) provides basic design capabilities through a web browser and works on any platform:
+
+- URL: [https://www.adobe.com/express/](https://www.adobe.com/express/)
+
+#### Verification
+
+Since Adobe Creative Cloud cannot be natively installed on Ubuntu/Debian, there is no verification step. If using a VM or Wine, verify within that environment.
+
+#### Troubleshooting
+
+For Wine/PlayOnLinux issues, consult:
+- [PlayOnLinux Adobe Creative Cloud page](https://www.playonlinux.com/en/app-3251-Adobe_Creative_Cloud.html)
+- [Creative Cloud Linux GitHub project](https://github.com/corbindavenport/creative-cloud-linux)
+
+---
+
+### Raspberry Pi OS (APT)
+
+**Adobe Creative Cloud is NOT supported on Raspberry Pi OS.** This is due to two fundamental incompatibilities:
+
+1. **Architecture**: Adobe applications are compiled for x86/x86_64 processors. Raspberry Pi uses ARM processors, and Adobe does not release ARM-compiled versions for Linux.
+2. **Operating System**: Adobe only supports macOS and Windows. There is no Linux support.
+
+#### Why It Cannot Work
+
+- Adobe's software is closed-source and cannot be recompiled for ARM
+- x86 emulation on ARM is too slow for practical use of graphics-intensive applications
+- Even Wine cannot bridge this gap because it requires x86 binaries
+
+#### Alternatives for Raspberry Pi
+
+For image editing and design work on Raspberry Pi, consider these open-source alternatives:
+
+```bash
+# GIMP - Professional image editor (Photoshop alternative)
+sudo DEBIAN_FRONTEND=noninteractive apt-get update
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y gimp
+
+# Inkscape - Vector graphics editor (Illustrator alternative)
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y inkscape
+
+# Krita - Digital painting application
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y krita
+
+# Kdenlive - Video editor (Premiere alternative)
+sudo DEBIAN_FRONTEND=noninteractive apt-get install -y kdenlive
+```
+
+#### Verification
+
+Verify the alternatives are installed:
+
+```bash
+gimp --version
+inkscape --version
+```
+
+---
+
+### Amazon Linux/RHEL (YUM/DNF)
+
+**Adobe Creative Cloud is NOT officially supported on Amazon Linux or RHEL.** Adobe does not provide packages for any Linux distribution.
+
+#### Workaround Options
+
+**Option 1: Virtual Machine (Recommended)**
+
+For Amazon Linux servers, run Windows in a VM using libvirt/KVM:
+
+```bash
+# Install virtualization packages on Amazon Linux 2023
+sudo dnf install -y libvirt qemu-kvm virt-install virt-manager
+
+# Enable and start libvirtd
+sudo systemctl enable --now libvirtd
+```
+
+Then create a Windows VM and install Creative Cloud there.
+
+**Option 2: Wine (Experimental, Not Recommended)**
+
+Wine is available on RHEL-based systems but has the same limitations as on Ubuntu:
+
+```bash
+# Enable EPEL repository (Amazon Linux 2)
+sudo amazon-linux-extras install -y epel
+
+# Install Wine
+sudo yum install -y wine
+```
+
+Or for Amazon Linux 2023 / RHEL 9:
+
+```bash
+# Enable EPEL
+sudo dnf install -y epel-release
+
+# Install Wine
+sudo dnf install -y wine
+```
+
+**Important:** The same limitations apply as with Ubuntu. Adobe does not support or test Wine-based installations, and modern Creative Cloud apps have poor compatibility.
+
+#### Alternatives
+
+Install open-source alternatives:
+
+```bash
+# Amazon Linux 2023 / RHEL 9
+sudo dnf install -y gimp inkscape
+
+# Amazon Linux 2 / RHEL 7/8
+sudo yum install -y gimp inkscape
+```
+
+#### Verification
+
+Not applicable for Adobe Creative Cloud. Verify alternatives:
+
+```bash
+gimp --version
+inkscape --version
+```
+
+---
+
+### Windows (winget)
+
+Adobe Creative Cloud is fully supported on Windows and can be installed using winget with silent installation flags.
+
+#### Prerequisites
+
+- Windows 10 version 1903 or later (64-bit recommended)
+- winget (Windows Package Manager) installed
+- Administrator privileges
+
+Verify winget is available:
+
+```powershell
+winget --version
+```
+
+If winget is not available, it can be installed from the Microsoft Store (App Installer) or by installing `dev install winget`.
+
+#### Installation Steps
+
+Open PowerShell or Command Prompt as Administrator and run:
+
+```powershell
+winget install --id Adobe.CreativeCloud --silent --accept-package-agreements --accept-source-agreements
+```
+
+**Explanation of flags:**
+- `--id Adobe.CreativeCloud`: Specifies the exact package identifier
+- `--silent`: Suppresses the installer UI
+- `--accept-package-agreements`: Automatically accepts the package license
+- `--accept-source-agreements`: Automatically accepts the source terms
+
+**Important Note:** After installation, the Creative Cloud Desktop App will prompt you to sign in with your Adobe ID when first launched. This sign-in step cannot be automated without enterprise deployment tools.
+
+#### Alternative: Direct Download Installation
+
+If winget is unavailable, download and install directly using PowerShell:
+
+```powershell
+# Create temporary directory
+$tempDir = "$env:TEMP\AdobeCC"
+New-Item -ItemType Directory -Force -Path $tempDir | Out-Null
+
+# Download the installer
+$url = "https://ccmdls.adobe.com/AdobeProducts/StandaloneBuilds/ACCC/ESD/6.8.1/856/win64/ACCCx6_8_1_856.zip"
+$zipPath = "$tempDir\CreativeCloud.zip"
+Invoke-WebRequest -Uri $url -OutFile $zipPath
+
+# Extract the archive
+Expand-Archive -Path $zipPath -DestinationPath $tempDir -Force
+
+# Run the installer silently
+$setupPath = Get-ChildItem -Path $tempDir -Recurse -Filter "Set-up.exe" | Select-Object -First 1 -ExpandProperty FullName
+Start-Process -FilePath $setupPath -ArgumentList "--silent" -Wait
+
+# Cleanup
+Remove-Item -Recurse -Force $tempDir
+```
+
+#### Verification
+
+Verify Adobe Creative Cloud is installed:
+
+```powershell
+# Check if the application exists
+if (Test-Path "$env:ProgramFiles\Adobe\Adobe Creative Cloud\ACC\Creative Cloud.exe") {
+    Write-Host "Adobe Creative Cloud is installed"
+} elseif (Test-Path "${env:ProgramFiles(x86)}\Adobe\Adobe Creative Cloud\ACC\Creative Cloud.exe") {
+    Write-Host "Adobe Creative Cloud is installed (x86)"
+} else {
+    Write-Host "Adobe Creative Cloud is NOT installed"
+}
+```
+
+Or check via winget:
+
+```powershell
+winget list --id Adobe.CreativeCloud
+```
+
+#### Troubleshooting
+
+**winget installation fails with error:**
+
+Try clearing the winget cache:
+
+```powershell
+winget source reset --force
+winget install --id Adobe.CreativeCloud --silent --accept-package-agreements --accept-source-agreements
+```
+
+**Installer hangs or times out:**
+
+Increase the timeout and run with verbose output:
+
+```powershell
+winget install --id Adobe.CreativeCloud --silent --accept-package-agreements --accept-source-agreements --verbose
+```
+
+**Application fails to start after installation:**
+
+Reinstall the application:
+
+```powershell
+winget uninstall --id Adobe.CreativeCloud --silent
+winget install --id Adobe.CreativeCloud --silent --accept-package-agreements --accept-source-agreements
+```
+
+**Creative Cloud conflicts with previous installation:**
+
+Use Adobe's official cleanup tool:
+
+1. Download the Adobe Creative Cloud Cleaner Tool from Adobe's website
+2. Run with administrator privileges
+3. Retry installation
+
+---
+
+### WSL (Ubuntu)
+
+**Adobe Creative Cloud cannot run inside WSL (Windows Subsystem for Linux).** WSL runs a Linux environment, and Adobe does not support Linux.
+
+#### Recommended Approach
+
+Install Adobe Creative Cloud on the Windows host instead. WSL applications can still interact with files that Creative Cloud applications modify.
+
+From within WSL, you can access Windows-installed Creative Cloud files at:
+
+```bash
+# Access Windows files from WSL
+ls /mnt/c/Users/<your-username>/Creative\ Cloud\ Files/
+```
+
+#### Alternative: Launch Windows Installer from WSL
+
+You can trigger the Windows installation from within WSL using PowerShell interoperability:
+
+```bash
+# Install Adobe Creative Cloud on Windows host from WSL
+powershell.exe -Command "winget install --id Adobe.CreativeCloud --silent --accept-package-agreements --accept-source-agreements"
+```
+
+#### Verification
+
+Check if Creative Cloud is installed on the Windows host:
+
+```bash
+powershell.exe -Command "Test-Path 'C:\Program Files\Adobe\Adobe Creative Cloud\ACC\Creative Cloud.exe'"
+```
+
+---
+
+### Git Bash (Manual/Portable)
+
+Git Bash runs within Windows, so Adobe Creative Cloud should be installed on the Windows host using winget or the direct download method.
+
+#### Prerequisites
+
+- Windows 10 version 1903 or later
+- Git Bash installed
+- Administrator privileges in the Windows environment
+
+#### Installation Steps
+
+From Git Bash, invoke PowerShell to run the winget installation:
+
+```bash
+# Install using winget via PowerShell
+powershell.exe -Command "winget install --id Adobe.CreativeCloud --silent --accept-package-agreements --accept-source-agreements"
+```
+
+Or use curl to download and install directly:
+
+```bash
+# Create temp directory
+TEMP_DIR=$(mktemp -d)
+
+# Download the installer
+curl -L -o "$TEMP_DIR/CreativeCloud.zip" \
+  "https://ccmdls.adobe.com/AdobeProducts/StandaloneBuilds/ACCC/ESD/6.8.1/856/win64/ACCCx6_8_1_856.zip"
+
+# Extract and install using PowerShell
+powershell.exe -Command "
+  Expand-Archive -Path '$TEMP_DIR/CreativeCloud.zip' -DestinationPath '$TEMP_DIR/CreativeCloud' -Force
+  \$setup = Get-ChildItem -Path '$TEMP_DIR/CreativeCloud' -Recurse -Filter 'Set-up.exe' | Select-Object -First 1
+  Start-Process -FilePath \$setup.FullName -ArgumentList '--silent' -Wait
+"
+
+# Cleanup
+rm -rf "$TEMP_DIR"
+```
+
+#### Verification
+
+Verify the installation from Git Bash:
+
+```bash
+# Check if Creative Cloud is installed
+if [[ -f "/c/Program Files/Adobe/Adobe Creative Cloud/ACC/Creative Cloud.exe" ]]; then
+  echo "Adobe Creative Cloud is installed"
+else
+  echo "Adobe Creative Cloud is NOT installed"
+fi
+```
+
+#### Troubleshooting
+
+**PowerShell execution fails from Git Bash:**
+
+Ensure PowerShell is in your PATH and try using the full path:
+
+```bash
+/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe -Command "winget install --id Adobe.CreativeCloud --silent --accept-package-agreements --accept-source-agreements"
+```
+
+**Permission denied errors:**
+
+Run Git Bash as Administrator (right-click Git Bash and select "Run as administrator").
+
+---
+
+## Post-Installation Configuration
+
+After installing Adobe Creative Cloud on supported platforms (macOS and Windows), complete these steps:
+
+### 1. Sign In to Adobe Account
+
+Launch the Creative Cloud Desktop App and sign in with your Adobe ID. This step requires user interaction and cannot be automated.
+
+### 2. Install Individual Applications
+
+From the Creative Cloud Desktop App, install the applications included in your subscription:
+
+- Photoshop
+- Illustrator
+- Premiere Pro
+- After Effects
+- Lightroom
+- InDesign
+- And others
+
+### 3. Configure Storage Settings
+
+Creative Cloud provides cloud storage for files and fonts. Configure your sync folder location:
+
+1. Open Creative Cloud Desktop App
+2. Click the account icon > Preferences > Creative Cloud
+3. Set the sync folder location
+
+### 4. Install Fonts
+
+Adobe Fonts are included with most Creative Cloud subscriptions:
+
+1. Open Creative Cloud Desktop App
+2. Click "Fonts" in the left sidebar
+3. Browse and activate fonts as needed
+
+---
+
+## Common Issues
+
+### Cross-Platform Issues
+
+| Issue | Cause | Solution |
+|-------|-------|----------|
+| Installation requires user interaction | Adobe sign-in is mandatory | Cannot be fully automated; enterprise deployments should use Adobe Admin Console |
+| Slow download speeds | Adobe CDN congestion | Retry during off-peak hours or use a wired connection |
+| "Another installation in progress" | Existing Adobe process running | End all Adobe processes in Task Manager/Activity Monitor and retry |
+| License activation fails | Network or firewall blocking | Ensure access to `*.adobe.com` and `*.adobelogin.com` |
+
+### macOS-Specific Issues
+
+| Issue | Solution |
+|-------|----------|
+| Cask installation fails | Run `brew update && brew cleanup` then retry |
+| App damaged or cannot be opened | Run `xattr -cr /Applications/Adobe\ Creative\ Cloud/Adobe\ Creative\ Cloud.app` |
+
+### Windows-Specific Issues
+
+| Issue | Solution |
+|-------|----------|
+| winget not found | Install from Microsoft Store (App Installer) or upgrade Windows |
+| Silent install still shows UI | Use `--silent` flag; some UI may appear for initial sign-in |
+| Installation corrupted | Run Adobe Creative Cloud Cleaner Tool and reinstall |
+
+---
+
+## Enterprise Deployment
+
+For enterprise environments requiring fully automated, silent deployments without user interaction:
+
+1. **Adobe Admin Console**: Use [https://adminconsole.adobe.com](https://adminconsole.adobe.com) to create custom packages
+2. **Creative Cloud Packager**: Build deployment packages with pre-configured settings
+3. **Named User Licensing or Device Licensing**: Required for truly silent deployment
+
+Refer to Adobe's enterprise documentation: [Deploy packages for Adobe Creative Cloud](https://helpx.adobe.com/enterprise/using/deploy-packages.html)
+
+---
+
+## References
+
+- [Adobe Creative Cloud Official Download](https://www.adobe.com/apps/download/creative-cloud)
+- [Download Creative Cloud Desktop App - Direct Links](https://helpx.adobe.com/download-install/apps/download-install-apps/creative-cloud-apps/download-creative-cloud-desktop-app-using-direct-links.html)
+- [Adobe Creative Cloud Homebrew Cask](https://formulae.brew.sh/cask/adobe-creative-cloud)
+- [Adobe Creative Cloud on winget (winstall)](https://winstall.app/apps/Adobe.CreativeCloud)
+- [Adobe Creative Cloud Silent Install Guide](https://silentinstallhq.com/adobe-creative-cloud-desktop-app-silent-install-how-to-guide/)
+- [Troubleshoot Silent Creative Cloud Installation](https://helpx.adobe.com/creative-cloud/kb/troubleshoot-silent-creative-cloud-installation-issues.html)
+- [Deploy Packages for Adobe Creative Cloud (Enterprise)](https://helpx.adobe.com/enterprise/using/deploy-packages.html)
+- [Creative Cloud Linux Project (Unofficial)](https://github.com/corbindavenport/creative-cloud-linux)