Zac Gaetano 8aece9cbc4 fix(premiere-plugin): make build pipeline portable to Windows PowerShell 5.1

End-to-end verification on a fresh Windows machine surfaced three issues:

1. pwsh isn't installed by default — Windows ships powershell.exe (5.1).
   Switched all script invocations + docs from `pwsh` to `powershell`.
2. .NET's strict XML parser rejects manifest.xml because the <Resources>
   comment legally contains `--` (inside `--enable-nodejs`/`--mixed-context`
   CEF flag names). Switched build-installer.ps1 to regex extraction,
   matching what build-zxp.mjs already does.
3. winget installs Inno Setup 6 to %LOCALAPPDATA%\Programs by default, not
   Program Files (x86). Added the user-scope path to the ISCC.exe fallback
   list.

Verified: `powershell -File build-all.ps1` produces both artifacts —
dragonflight-premiere-panel-1.0.0.zxp (35 KB, signature valid)
dragonflight-premiere-panel-1.0.0-windows-setup.exe (2 MB).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-23 16:22:46 -04:00

5 KiB

Raw Blame History

Wild Dragon MAM - Premiere Pro Panel Quick Start

Installation (1 minute)

Grab the installer from https://forge.wilddragon.net/zgaetano/dragonflight/releases.

Windows

1. Download dragonflight-premiere-panel-<version>-windows-setup.exe
2. Double-click it. Next -> Finish.
3. Restart Premiere Pro.

The installer copies the bundle to %APPDATA%\Adobe\CEP\extensions\, sets PlayerDebugMode=1 for CSXS 8..13, and offers to remove any legacy com.wilddragon.mam.panel install.

macOS

1. Download dragonflight-premiere-panel-<version>.zxp
2. Open it with Anastasiy's ZXP Installer (https://install.anastasiy.com/)
3. Run once in Terminal:
   defaults write com.adobe.CSXS.11 PlayerDebugMode 1
4. Restart Premiere Pro.

Building from source

cd services/premiere-plugin/build
npm install
powershell -File build-all.ps1

See build/README.md.

Access the Panel

Window > Extensions > Wild Dragon MAM

First Time Setup

Enter server URL (default: http://localhost:7434)
Click "Connect"
Green indicator appears when connected
Assets load automatically

Basic Workflow

Connect → Browse → Search → Select → Import

Connect

Enter MAM server URL
Click Connect button
Wait for green status indicator

Browse

Scroll through asset thumbnails
Click any asset to see details

Search

Type in search box
Results update automatically
Filter by project using dropdown

Select

Click an asset thumbnail
Details panel shows metadata
Asset is highlighted with accent border

Import

Click "Import" to download and import selected asset
Click "Import All" to import all visible assets
Progress bar shows download status
Success message appears when complete

Features at a Glance

Feature	Location	Action
Server Connection	Top bar	Enter URL + Click Connect
Search Assets	Search box	Type search term
Filter by Project	Dropdown	Select from list
View Details	Details panel	Click any asset
Import Single	Import button	Select asset + Click Import
Import Multiple	Import All button	Click Import All
View Progress	Progress bar	Watch while importing

File Locations

services/premiere-plugin/
├── CSXS/manifest.xml          Extension config
├── index.html                 Main panel UI
├── css/styles.css             Dark theme styles
├── js/
│   ├── CSInterface.js         Adobe interface
│   └── main.js                Panel logic
├── jsx/
│   └── premiere.jsx           Premiere integration
├── build/                     Installer build pipeline (.zxp + .exe)
├── README.md                  Full docs
└── QUICK_START.md             This file

Troubleshooting

Panel doesn't show:

Is PlayerDebugMode set to 1? Restart Premiere Pro.
Is the folder in the right location? Check the path above.
Is Premiere Pro version 22.0 or later? Check Help > About.

Can't connect to server:

Is the server running? Check http://localhost:7434 in a browser.
Is the URL correct? Try http://localhost:7434 first.
Is firewall blocking? Check network settings.

Assets not loading:

Click Connect again to refresh.
Check the search box is empty.
Try a different project filter.

Import fails:

Are proxy files available on the server?
Is there disk space for downloads?
Check Premiere Pro's Event Monitor for errors.

Tips & Tricks

Server URL is saved to local storage (persists across sessions)
Thumbnail previews load lazily for performance
Search updates with 300ms debounce (wait while typing)
Double-click a card does nothing (use single click instead)
Progress bar shows download + import progress
Click red X to dismiss error messages

API Endpoints Expected

The MAM server should provide:

GET  /api/health              ← Server health check
GET  /api/projects            ← List of projects
GET  /api/assets              ← List assets (paginated)
POST /api/assets/{id}/download ← Signed S3 URL

See README.md for full API specification.

ExtendScript Functions Available

The panel can call these Premiere Pro functions:

// Import file into project
importFileToProject(filePath)

// Get current sequence
getActiveSequence()

// Insert into timeline
insertClipToSequence(filePath, trackIndex)

// Get project info
getProjectPath()
getProjectInfo()
getSequenceTracks()

See jsx/premiere.jsx for details.

Color Scheme (Dark Theme)

Primary Background:     #0f0f1e (very dark blue)
Secondary Background:   #1a1a2e (dark blue)
Accent Color:          #e94560 (bright red/pink)
Text Primary:          #ffffff (white)
Text Secondary:        #b0b0c0 (light gray)
Success:               #00d084 (green)
Error:                 #ff4444 (red)

Support

See README.md for:

Complete installation guide
Full feature documentation
API reference
ExtendScript function reference
Performance optimization notes
Security considerations

Version 1.0.0 | April 2026

5 KiB Raw Blame History